Request a payin quote

Retrieves a quote for a pay event for a given participant code and asset.
The response includes a deposit address and rate at which a subsequent on-chain deposit will be honored.

The quote has an expiry timestamp (price_expire_ts) — for volatile assets, the platform must execute the deposit before this time,
or a new quote can be requested for the same payment to refresh the price.
For stablecoins, price_expire_ts will be null.

The request_id you send (via the X-Request-Id header) is the idempotency key for this endpoint: re-submitting the same request_id returns the existing active quote — same transaction_id, deposit address, and rate — instead of creating a new one.

Use the returned transaction_id as the path parameter when calling POST /pay/{id}/rfq to refresh a quote.

After the on-chain deposit settles or fails, a crypto_pay_status_changed webhook reports the outcome (success + status_reason_code).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

The participant code for the shopper making the payment

string
required

The cryptocurrency asset to be deposited (e.g., BTC, ETH, USDC)

string
required

The total fiat amount the shopper is paying

string
enum
required

The fiat currency for the payment. Currently only USD is supported

Allowed:
string
length ≤ 20

Optional account label for the transaction. Defaults to "pay"

string
length ≤ 50

An optional client-provided reference ID for tracking purposes

string
length between 1 and 50

Optional participant code of the merchant tied to this transaction. When omitted, the platform itself is treated as the merchant.

Headers
string
required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

string
required

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json