Kutanapay Merchant API
    • Getting Started
    • Authentication
    • Use the API in your application
    • Webhooks
      • Webhooks Events
    • Merchant Checkout
      • Create checkout
        POST
      • List checkouts
        GET
      • Get checkout
        GET
      • Cancel checkout
        POST
      • Create checkout button embed session
        POST
    • Webhook Events
      • Checkout created
      • Checkout paid
      • Customer says they paid
      • Checkout approved
      • Checkout rejected
      • Checkout failed
      • Checkout timed out
      • Checkout expired
      • Checkout refunded
      • A second collection arrived
      • Test event
    • Schemas
      • RequestBodies
        • CheckoutEvent
      • DetailError
      • WebhookEnvelope
      • CheckoutEventData

    Getting Started

    Accept payments with KutanaPay hosted checkout from your backend. Configure API keys and webhooks in the merchant platform; create checkouts and handle notifications from your server.

    What you do where#

    TaskWhere
    API keys, webhook URL, events, secret, delivery logsMerchant platform
    Branding, KYBMerchant platform
    Create checkout, cancel pending checkout, read checkout statusYour server (API reference)
    Verify webhook signatures and update your ordersYour server

    Quick flow#

    1.
    Complete onboarding and KYB in the merchant platform when required.
    2.
    Create an API key and store it securely on your server.
    3.
    POST /api/v1/merchants/checkouts with amount, currency, and customer email. Send the customer checkout_url from the response.
    4.
    Register your webhook URL in the platform and subscribe to checkout events (e.g. checkout.paid).
    5.
    Implement an HTTPS handler that verifies X-Webhook-Signature (see Webhooks and Webhook event reference).
    6.
    Optionally POST .../checkouts/{id}/cancel for pending checkouts, or GET .../checkouts/{id} to poll status (webhooks remain primary).

    API reference on this site#

    Checkouts only: create, list, get, cancel.
    Guides: Checkouts (full payment-link flow), Webhooks, Webhook event reference.

    Base URL#

    Production API host: Use the API endpoint our team will send you.
    Sandbox API host: https://dev.kutanapay.com.

    Next steps#

    Documentation map – sidebar order and response envelope
    Use the API in your application – curl and Try it
    Authentication – x-api-key
    Checkouts – create, payment link, lifecycle, webhooks
    Webhooks and Webhook event reference
    Modified at 2026-09-26 21:48:52
    Next
    Authentication
    Built with