Create a Checkout Session for this order
Create a Ringup Checkout Session for this order, before taking payment. Returns the session id and payment_required, resolved per purchase from the merchant’s settings and the amount.
Headers
The caller's phone number in E.164, templated from the platform's caller-ID variable. Never model-generated.
"+14155550142"
The dialed number in E.164 (resolved to a merchant server-side) or an explicit merchant id.
"tonys-pizza"
The platform's call id. Used for charge idempotency: retries within a call can never double-charge.
Body
The purchase amount in cents.
Response
The policy decision for this purchase.
The Checkout Session id (cs_...).
required: payment must complete before the call ends. optional: offer once, never block. none: do not offer payment at all; proceed as the business's normal flow.
required, optional, none One sentence written for the model, telling the payment step how to behave.