Checkout

Checkout creates a short-lived order (about 7 minutes) with a settlement address. The payer sends assets on-chain; you confirm with the transaction hash.

Auth

Use your checkout key as x-api-key (not the consumer key).

Flow

POST /v1/checkout/ — create order (network, asset, currency_code, amount, order_id).
Show the returned settlement address and amount to the payer.
POST /v1/checkout/pay — submit order_id + transaction_hash after on-chain payment.
POST /v1/checkout/status — poll until COMPLETE, EXPIRED, FAILED, or CANCELLED.

Query parameters are used on these POST endpoints (not only JSON body).

Statuses

PENDING → COMPLETE | EXPIRED | CANCELLED | FAILED

Networks

List supported settlement networks with POST /v1/checkout/networks.

Webhooks

On completion or failure Pretium may POST:

{
  "status": "COMPLETE",
  "order_id": "order_123",
  "message": "Settlement complete"
}

Get started

Guides

Auth

Flow

Statuses

Networks

Webhooks

​Auth

​Flow

​Statuses

​Networks

​Webhooks

Auth

Flow

Statuses

Networks

Webhooks