Skip to main content

Get payment catalog

GET 
/catalog

Returns the catalog of active supported countries and the currencies (assets) payable in each, with the display decimals of every currency. The catalog is scoped to the calling merchant: it lists only the currencies payable through payment methods the merchant is provisioned for, and omits countries in which the merchant has nothing payable.

  • decimals is the payment/display precision of the currency (ISO 4217 for fiat — e.g. JPY 0, USD 2; project convention 4 for crypto symbols). It is not the on-chain token decimals, which vary per chain (e.g. USDT: Ethereum 6, BSC 18) — resolve those from the chain/token metadata when converting to smallest units.
  • Crypto currencies are excluded for countries under an active CRYPTO restriction (see Recent changes), so the catalog matches what the hosted checkout actually offers there.
  • Responses are cache-backed and carry an ETag derived from updated_at plus Cache-Control: private, max-age=300. Revalidate with If-None-Match to get a cheap 304 instead of re-downloading.

Request​

Responses​

Catalog fetched successfully

Response Headers
    ETag

    Freshness tag derived from updated_at; changes only when the underlying country/currency data changes.

    Cache-Control

    private, max-age=300 — merchant-key-gated, so shared caches must not store it.