Skip to main content
Create a checkout to generate a hosted payment page for your customer.

Authentication

Send your store key in the header: X-API-Key: sk_.... See the API overview for where to find it.

Request body

  • orderId (string, required): Your internal order identifier.
  • priceAmount (string, required): Decimal amount, quoted in priceCurrency.
  • priceCurrency (string, required): ISO 4217 currency (e.g., USD).
  • successRedirectUrl (string, optional): Where to send the buyer after a successful payment.

Example request

curl -X POST https://api.zenobank.io/api/v1/checkouts \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_your_store_key" \
  -d '{
    "orderId": "order-12345",
    "priceAmount": "0.01",
    "priceCurrency": "USD",
    "successRedirectUrl": "https://example.com/success"
  }'

Example response

{
  "id": "ch_l0k1o87yt6",
  "orderId": "order-12345",
  "priceCurrency": "USD",
  "priceAmount": "0.01",
  "status": "OPEN",
  "expiresAt": "2025-10-04T10:30:00Z",
  "checkoutUrl": "https://pay.zenobank.io/ch_l0k1o87yt6",
  "createdAt": "2025-10-04T10:00:00Z",
  "successRedirectUrl": "https://example.com/success"
}