Create a payment session
Updated 2 November 2026
Call POST /api/payments/sessions from your server with your merchant token as a bearer token (Authorization: Bearer <token>). Get the token from Merchant token.
Required fields are amount (greater than zero) and currency. Also send your order reference in merchantReferenceId, the customer's email, and your returnUrl, cancelUrl and webhookUrl.
The response includes:
paymentSessionId— store it with your order.hostedPaymentUrl— redirect the customer here, oriframeUrl— embed this in your own checkout page.availablePaymentMethods— the providers that can take this payment, with their fees.
Try it end to end in the Payment playground.