Skip to main content
GET
The card payment window for a pair
Provider sandbox on this deployment. Our backend targets the card provider’s sandbox: no card is charged and no real transfer settles. Known limits: a purchase never reaches completed (it stops at processing), the settlement asset is the sandbox’s, not production’s (read cryptoCurrency from GET /v1/config), and the EUR window is unpublished (GET /v1/card/limits says window: unpublished). Every response says which environment answered in its environment field.

Authorizations

Authorization
string
header
required

Your API key, issued by us and shown once at creation.

Query Parameters

fiatCurrency
string
required

ISO 4217 code to charge in. Must be one of the deployment's supported fiat currencies (see GET /v1/card/currencies); others are refused.

Pattern: ^[A-Za-z]{3}$
Example:

"EUR"

cryptoCurrency
string
required

Must equal the deployment's configured settlement asset (case-insensitive). Anything else is refused with a message naming what is configured and which environment this is. Read GET /v1/config or GET /v1/card/currencies to learn it - on the sandbox it is the provider's sandbox asset (ETH), not USDC.

Example:

"USDC"

Response

The window, or window: unpublished with null figures when the provider publishes none for this pair here. Never a bare 0/0.

The provider's card payment window for the pair, read live, with a marker saying whether one is published at all.

environment
enum<string>
required

Which environment answered. sandbox: at least one money upstream is the provider's sandbox - no real money moves there, and the card corridor is the sandbox's asset (read GET /v1/config), not the documented production one. production: every configured upstream is real. Derived from the configured upstream hosts at boot, never a flag.

Available options:
sandbox,
production
Example:

"sandbox"

fiatCurrency
string
required
Example:

"EUR"

cryptoCurrency
string
required
Example:

"USDC"

min
string | null
required

Smallest purchase, decimal string in major units of fiatCurrency. "0" under a published window means no minimum. Null when window is unpublished.

Example:

"25"

max
string | null
required

Largest purchase, decimal string in major units of fiatCurrency. Null when window is unpublished.

Example:

"15000"

window
enum<string>
required

Whether the card provider publishes a usable payment window for this pair here. published: min and max are the provider's live figures and a purchase must fall inside them. unpublished: the provider lists the currency but publishes no usable window on this deployment (its catalogue carries no entry, or zeros - the provider's sandbox publishes 0/0 for EUR); min and max are then null, never a zero to size a payment against. An unpublished window does not mean the card vertical is unconfigured (that answers 503 not_configured) and does not mean every amount is accepted: the provider still refuses amounts it will not price, and the quote refusal says so.

Available options:
published,
unpublished
Example:

"published"