Skip to main content
POST
/
payment-intents
cURL
curl --request POST \
  --url https://api.boothzen.com/v1/payment-intents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "booking_id": "<string>",
  "amount_minor": 50000000,
  "currency": "<string>"
}
'
"<string>"

Authorizations

​
Authorization
string
header
required

Bearer token: bz_live_<32chars> (live mode) or bz_test_<32chars> (test mode). Obtain via BoothZen admin → Settings → API Keys.

Body

application/json

POST /api/v1/payment-intents — request validation.

Scope enforcement (payments:write) handled upstream by EnforceApiScope. Tenant isolation: booking_id is decoded + looked up under BelongsToTenant, so a cross-tenant booking reference resolves to 404 in the controller.

amount_minor is OPTIONAL — when omitted, the controller derives the amount from the booking total. Pass it explicitly only for partial-pay / deposit flows where the charged amount diverges from booking.total_price.

​
booking_id
string
required
​
amount_minor
integer | null
Required range: 1 <= x <= 99999999
​
currency
string | null
Required string length: 3

Response

The response is of type string.