Skip to main content
Use this page to route merchant questions to the most relevant Kyren Pay documentation before composing an answer.

Integration setup

Question variantsPrimary sourceSecondary source
”How do I start?”, “Which integration path should I use?”, “Dashboard or API?”Start hereQuickstart
”How do I create my first payment?”, “How do I test checkout end to end?”Collect your first paymentTesting your integration
”What base URL should I use?”, “Which environment is this?”AuthenticationTesting your integration

Dashboard tasks

Question variantsPrimary sourceSecondary source
”Where do I create products?”, “How do I archive a product?”Products dashboardCreate a product API
”Where are checkout links?”, “How do I find a checkout session?”Checkouts dashboardCheckout API
”Where do I find an order?”, “What does this order status mean?”Orders dashboardOrder status does not match expectation
”Where are API keys and Webhooks configured?”Developer settingsAuthentication

Webhooks

Question variantsPrimary sourceSecondary source
”Which events exist?”, “What does order.paid mean?”Webhook eventsWebhook overview
”Why did signature verification fail?”Webhook signature verification failsWebhook signatures
”Why did I not receive a webhook?”Webhook not receivedWebhook retries
”My customer paid but credits were not added”Customer paid but was not creditedWebhook events

Epay migration

Question variantsPrimary sourceSecondary source
”Can I keep my Epay SDK?”, “Which Epay endpoint should I use?”Epay-compatible migrationEpay migration checklist
”How do I calculate the MD5 sign?”, “Should I add &key=?”Epay MD5 signaturesubmit.php API reference
”How does submit.php work?“submit.php redirect checkoutsubmit.php API reference
”How does mapi.php work?“mapi.php direct payment creationmapi.php API reference
”Can I use api.php refund?”, “How do I query an Epay order?“api.php order query and refund compatibilityapi.php API reference

Troubleshooting

Question variantsPrimary sourceSecondary source
”API returns 401”, “invalid key”, “IP not allowed”API request returns 401Developer settings
”Checkout creation fails”, “invalid product”, “currency error”Checkout session creation failsCreate a checkout session
”Amount validation fails”, “timestamp error”, “wrong currency”Amount, currency, or timestamp validation failsSupported currencies
”Settlement unavailable”, “why can’t I settle?”Settlement eligibility is not metGo-live checklist