Documentation Index
Fetch the complete documentation index at: https://docs.zenobank.io/llms.txt
Use this file to discover all available pages before exploring further.
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
JavaScript
Python
PHP
Go
Ruby
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"
}
