Create payment session

POST

https://api.maxelpay.com/api/v1/payments/sessions

Creates a new payment session for an order and returns a hosted checkout URL where the customer can complete the crypto payment.

The merchant must provide order details, amount, currency, and redirect URLs. Once the payment is completed or fails, the customer is redirected to the respective URL, and a webhook notification is sent to the provided callback URL.

Request

Header Params

Body Params application/json

Example

{
    "orderId": "order_123",
    "amount": 99.99,
    "currency": "USD",
    "description": "Order #123 - Premium Package",
    "successUrl": "https://yoursite.com/success",
    "cancelUrl": "https://yoursite.com/cancel",
    "callbackUrl": "https://yoursite.com/webhook"
  }

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.maxelpay.com/api/v1/payments/sessions' \
--header 'X-API-KEY: pk_test_7rgBWk6b2f43mvRRSEGXPQ2Q17XywqTP' \
--header 'Content-Type: application/json' \
--data-raw '{
    "orderId": "order_123",
    "amount": 99.99,
    "currency": "USD",
    "description": "Order #123 - Premium Package",
    "successUrl": "https://yoursite.com/success",
    "cancelUrl": "https://yoursite.com/cancel",
    "callbackUrl": "https://yoursite.com/webhook"
  }'

Responses

🟢200

application/json

Body

Example

{}

Modified at 2026-02-26 13:38:55

Api Key

Get session status