Logo Logo
Loading...
Skip to content
Phone: +966 11 555 0100 · Email: support@manaracore.com

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, or
  • iframeUrl — 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.

Was this article helpful?

Still need help?

Our support team answers every request, usually within one business day.