Checkout page
Create a checkout page
POST
/checkout-sessionsScope
checkout:writeAuth Bearer keyIdempotentCreates a payment request with its own payment instructions and countdown. Bank transfer sessions get a temporary Naira account bound to this exact amount; the permanent business account is never reused for a checkout.
Headers
Idempotency-KeystringrequiredRetrying with the same key and payload replays the original response.
Request body
json
{
"method": "crypto",
"amount": "50.00",
"currency": "USD",
"expires_in_minutes": 60,
"assets": [
"USDT",
"USDC"
],
"reference": "ORDER-4822"
}Responses
201Checkout session created
json
{
"id": "chk_41ac0d7b92",
"object": "checkout_session",
"status": "awaiting_payment",
"method": "crypto",
"amount": "50.00",
"currency": "USD",
"amount_paid": null,
"amount_outstanding": "50.00",
"payments": [],
"expires_at": "2026-02-04T21:29:46.000Z",
"checkout_url": "https://business.boundlesspay.com/checkout/chk_41ac0d7b92",
"reference": "ORDER-4822",
"description": null,
"customer": {
"name": null,
"email": null,
"phone": null
},
"instructions": {
"type": "crypto",
"address": "0x8Ae2C1b7F0d94E31aA5c60b17E9C4d3f0821b7A5",
"assets": [
"USDT",
"USDC"
],
"hosted_url": "https://business.boundlesspay.com/pay/ord_74b1c0e9a2",
"order_reference": "ord_74b1c0e9a2",
"amount": "50.00",
"currency": "USD",
"expires_at": "2026-02-04T21:29:46.000Z"
},
"deposit_id": null,
"paid_at": null,
"success_url": null,
"cancel_url": null,
"metadata": {},
"created_at": "2026-02-04T20:29:46.000Z"
}Errors
Errors use RFC 9457 problem details. Branch on code, and log request_id.
400Bad request401Unauthenticated403Forbidden409Idempotency conflict422Validation error429Rate limitedcURL
curl -X POST "https://business.boundlesspay.com/api/public/v1/checkout-sessions" \
-H "Authorization: Bearer $BOUNDLESS_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{ "method": "crypto", "amount": "50.00", "currency": "USD", "expires_in_minutes": 60, "assets": [ "USDT", "USDC" ], "reference": "ORDER-4822" }'