Use the API in your application

Call the Checkout API over HTTPS from your backend. Do not put x-api-key in browsers, mobile apps, or public repos.

For a full guide (payment link, customer flow, lifecycle, webhooks), read Checkouts.

Base URL

Environment	Base URL
Production	Use API endpoint our team will send to you
Sandbox	https://dev.kutanapay.com

All paths in the API reference are appended to the base URL, for example:

POST https://dev.kutanapay.com/api/v1/merchants/checkouts

Use the JSON response:

data.checkout_url – redirect the customer or send this link by email/SMS.

data.id – store as your KutanaPay checkout id.

data.payment_reference – useful for support.

Your app creates an order in your database.

Your server calls Create checkout.

You return checkout_url to your frontend (link or redirect only; never the API key).

Your webhook handler receives checkout.paid and marks the order paid (see Webhooks and Webhook event reference).

If the customer abandons payment, call Cancel checkout while status is still pending.

Same header on every call:

Need	Method and path
Cancel	`POST /api/v1/merchants/checkouts/{checkout_id}/cancel`
Status	`GET /api/v1/merchants/checkouts/{checkout_id}`
List	`GET /api/v1/merchants/checkouts`

Request and response shapes match the API reference examples (same envelope: status, message, data).

Set environment baseUrl to your API host (no trailing slash).

Set Auth → API Key → header x-api-key.

Run Create checkout and copy the example into your integration tests.