Create a checkout

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"
  }'

const response = await fetch('https://api.zenobank.io/api/v1/checkouts', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'sk_your_store_key',
  },
  body: JSON.stringify({
    orderId: 'order-12345',
    priceAmount: '0.01',
    priceCurrency: 'USD',
    successRedirectUrl: 'https://example.com/success',
  }),
});

const checkout = await response.json();

import requests

response = requests.post(
    'https://api.zenobank.io/api/v1/checkouts',
    headers={
        'Content-Type': 'application/json',
        'X-API-Key': 'sk_your_store_key',
    },
    json={
        'orderId': 'order-12345',
        'priceAmount': '0.01',
        'priceCurrency': 'USD',
        'successRedirectUrl': 'https://example.com/success',
    },
)

checkout = response.json()

$ch = curl_init('https://api.zenobank.io/api/v1/checkouts');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'X-API-Key: sk_your_store_key',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'orderId' => 'order-12345',
        'priceAmount' => '0.01',
        'priceCurrency' => 'USD',
        'successRedirectUrl' => 'https://example.com/success',
    ]),
]);

$response = curl_exec($ch);
$checkout = json_decode($response, true);

payload := map[string]string{
    "orderId":            "order-12345",
    "priceAmount":        "0.01",
    "priceCurrency":      "USD",
    "successRedirectUrl": "https://example.com/success",
}

body, _ := json.Marshal(payload)

req, _ := http.NewRequest("POST", "https://api.zenobank.io/api/v1/checkouts", bytes.NewBuffer(body))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", "sk_your_store_key")

resp, _ := http.DefaultClient.Do(req)

require 'net/http'
require 'json'

uri = URI('https://api.zenobank.io/api/v1/checkouts')

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['X-API-Key'] = 'sk_your_store_key'
request.body = {
  orderId: 'order-12345',
  priceAmount: '0.01',
  priceCurrency: 'USD',
  successRedirectUrl: 'https://example.com/success'
}.to_json

response = http.request(request)
checkout = JSON.parse(response.body)

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"
}

Getting started

Integrations

SDKs

API Reference

Others

Authentication

Request body

Example request

Example response

​Authentication

​Request body

​Example request

​Example response

Authentication

Request body

Example request

Example response