Create a checkout session
POST/v3/checkout-session
Creates a checkout session for the <swirepay-checkout> frontend SDK element
(scope: payment for a direct payment, scope: order for an inventory-order checkout).
This call requires your secret API key and must be made server-side — the secret key
must never reach the browser. The returned entity.encryption value is passed to the SDK
element as the secureToken prop.
This endpoint is also used, with scope: transfer, by <swirepay-contact-onboarding> and
<swirepay-transfer-center> — see the Transfer Center API's own Checkout Session
operation for that variant.
See the Checkout SDK guide for the full frontend integration flow.
Request
Responses
- 200
- 400
- 401
- 412
Checkout session created successfully
Request validation failed
Unauthorized - invalid or missing API key
Scope-specific requirement not met