Get a checkout session
One checkout session. status becomes paid only after TeePay verified and ledger-posted the payment, and payment.reference is then set. Requires checkout:read.
BearerAuthAuthorizationBearer <token>Secret API key: tp_test_. or tp_live_.. Server-side only.
id*stringuuidCheckout session
application/json- response
id*stringuuidobject*unknownstatus*unknownpaid only after TeePay verified and ledger-posted the payment; never from a browser redirect.
"open""processing""paid""expired""unavailable"title*stringdescription*stringcurrency*string^[A-Z]{3}$amount_minor*string^[1-9][0-9]{0,12}$checkout_url*|TeePay hosted checkout to send or redirect the customer to.
uripayment_profile_id*string|nullreference*string|nullmetadata*payment*|nullenvironment*unknown"live""sandbox"created_at*stringexpires_at*string|nullcurl -X GET 'https://api.teepay.me/v1/checkout-sessions/7c0e5d2a-1b3f-4c8e-9a6d-2f4b8e1c0d9a'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "object": "checkout_session", "status": "open", "title": "string", "description": "string", "currency": "string", "amount_minor": "string", "checkout_url": "http://example.com", "payment_profile_id": "string", "reference": "string", "metadata": { "property1": "string", "property2": "string" }, "payment": { "reference": "string" }, "environment": "live", "created_at": "string", "expires_at": "string"}Create a checkout session POST
Creates a TeePay hosted checkout page for your account. Redirect the customer to checkout_url. A payment profile is optional: when given, or when your account has a default profile, its branding, return URL and webhook URL are used. Repeating the same Idempotency-Key and body returns the same session with the header Idempotent-Replayed: true. Requires checkout:create. 30 creations per account per minute.
List checkout sessions GET
Checkout sessions created through the API, newest first. Requires checkout:read.