CPTPayment
Documentation

Guides

Multi-currency & multi-fiat

Accept 35+ cryptocurrencies and show prices in more than one fiat currency. We handle live FX, rounding, and routing to the right wallet. You set the rules once.

What it does

  • Live FX for 35+ cryptocurrencies and several fiat currencies.
  • One product price shown in many display currencies (EUR, USD, GBP, and more).
  • Routes each currency to the settlement wallet you choose.

Common cases

  • Global SaaS with customers paying from different regions.
  • Merchants who price in EUR but settle in BTC or USDT.
  • Stores that want local pricing with a crypto checkout.

1. Set up currencies and wallets

Decide which cryptocurrencies you accept and where each one goes. You can turn coins on or off per product or integration.

  • For each coin, choose the networks to support (for example BTC, Lightning, TRC20).
  • Link each currency and network to a payout wallet.
  • Mark some currencies as recommended to show them first.
  • Use separate wallets per currency, network, or integration if you want.

2. Set fiat display and FX rules

Choose your base pricing currency and any extra fiats to show for reference. We use your FX rules to work out the crypto amounts, and apply the same rules across invoices and checkout.

  • Base fiat currency: your main pricing currency, like EUR.
  • Extra fiats: optional display-only conversions, like USD and GBP.
  • FX source: an internal oracle or an external provider, with an update interval.
  • Rounding: round up, round down, or banker's rounding.
  • Slippage guard: the largest move you allow before warning or blocking.

3. What your customers see

  • A clear fiat price, plus any reference fiats you add.
  • Their pick of any coin and network you turned on.
  • The exact crypto amount, a QR, and an address, using live FX and your rounding rules.
  • Status changing on-chain: Waiting, Confirmations, then Completed or Underpaid.

Fit it into your stack

  • Store both the base fiat amount and the crypto amount on each order or invoice.
  • Use webhooks when an invoice moves from Pending to Paid or Underpaid.
  • Report revenue in your base fiat, and use the FX data to see which coins customers prefer.
  • Combine this with Wallets and Invoices for a full multi-currency setup.