Skip to main content
POST
Create a payment session

Authorizations

X-API-Key
string
header
required

Business API key for server-to-server integrations. Key prefix determines the environment — no separate flag needed: test_sk_* = sandbox/testnet, live_sk_* = production/mainnet.

Body

application/json
amount
number
required
Example:

100

currency
string
required
Example:

"USD"

callback_url
string

URL to redirect/notify on payment completion

customer_email
string<email>
customer_name
string
description
string
metadata
object
payment_method
enum<string>
default:crypto
Available options:
crypto
reference
string

Your internal order reference

Response

Payment session created

amount
number
currency
string
expires_at
string<date-time>
payment_url
string
session_id
string<uuid>
status
string
Example:

"pending"