Skip to main content
Creates a checkout session, assigns your deposit address, returns a hosted checkout URL. Expires in 30 minutes.
Backend only. Never call from frontend.

Endpoint

See Authentication.

Body

amount
number
required
USDC amount (>0, two decimals). Customer pays as USDC or USDT-equivalent.
description
string
Shown to the customer on the checkout page.
external_id
string
Your reference (e.g., order ID). Echoed back in webhooks.
customer_email
string
Stored on the session for receipts.

Examples

Response (201)

session_id
string
required
Unique identifier. Always starts with cs_.
checkout_url
string
required
Hosted checkout page. Redirect the customer here.
deposit_address
string
required
Accepts USDC on 19 chains and USDT on 14 chains. See supported networks.
amount_usdc
number
required
USDC-equivalent amount.
expires_at
string
required
ISO 8601, 30 minutes after creation. Then statusexpired.
status
string
required
Always "pending" on creation. Track via the status endpoint or webhooks.