Currency Conversions
How Decal exchanges funds between currencies — your primary currency, accepting payments in other currencies, and where to see each conversion.
Every organization has a primary currency configured on their account, such as USD or GBP. By default, all orders and payments received ultimately settle to the digital cash equivalent of this currency.
Each currency has a digital cash equivalent, a stablecoin worth exactly one unit of that currency.
| Currency | Digital cash |
|---|---|
| USD - US dollar | USDC |
| GBP - Pound sterling | tGBP |
Conversions
A conversion exchanges funds from one currency into another, normally at the market rate. Decal executes conversions automatically, so funds that arrive in a different currency end up in your primary currency without you doing anything.
Conversions execute automatically when a payment lands in your orchestration wallet:
Customer ───── pays in any currency ───── Orchestration Wallet ───── converts ───── Primary currencyPayments routed directly to one of your settlement wallets are never converted. They arrive exactly as the customer sent them, including if Smart Payment transaction includes multiple stablecoins (e.g. USDC and PYUSD).
Default behavior
By default, customers pay only in the order's currency. A GBP order is paid in GBP, and a USD order in USD.
If a customer pays with a different digital cash token of the same currency, such as another US dollar stablecoin, it is converted into your primary currency automatically. This is always on and needs no configuration.
Accepting payments in other currencies
Organizations can optionally accept payments in other currencies to let customers pay in any supported currency. A customer holding only USD equivalents can then pay an order priced in GBP, and the other way round.
Configure this via Dashboard > Finances > Settings > Conversions.
When a customer pays in another currency:
- Before paying — checkout shows the amount in their currency and the approximate conversion rate
- At payment — the exact amount is quoted at the live market rate
- On the receipt — your order total, the amount they sent, and the rate
- On your payment — the order total, the amount sent, and the quoted rate, kept for your records
When to use this: Selling to customers who hold a different currency from your own, such as a US business selling at a UK event.
Orders in another currency
Orders are priced in your primary currency unless you set another. An order created through the API or a payment link can be priced in any supported currency (see Order currency). Its payment still converts into your primary currency.
Card and stored value payments are available for US dollar orders only.
Order priced in your primary currency
A US dollar organization selling an order priced in USD:
| Customer pays in | Other currencies off | Other currencies on |
|---|---|---|
| USD | Accepted, no conversion needed | Accepted, no conversion needed |
| GBP | Not offered | Accepted, converted to USD |
Order priced in another currency
A US dollar organization selling an order priced in GBP:
| Customer pays in | Other currencies off | Other currencies on |
|---|---|---|
| GBP | Accepted, converted to USD | Accepted, converted to USD |
| USD | Not offered | Accepted, no conversion needed |
Rates and differences
A conversion executes at the market rate when it runs. When a customer pays in another currency, that is moments after their quote, so the amount you receive can differ slightly from the order total — usually by a small fraction of a percent. Any difference is recorded on the payment.
Very small amounts, below the conversion minimum, are left in the currency they arrived in.
Where to see conversions
| Where | What you see |
|---|---|
| Dashboard > Finances > Conversions | Every conversion: amount sent, amount received, rate, and status |
| A payment's details | The conversions that payment caused |
| Transactions | Each conversion as its own entry, linked to the payment it came from |
Coming soon
Holding multiple currencies
Today, your balance is held in your primary currency, and everything you receive converts into it. We're adding support for holding several currencies directly, such as both USD and GBP, so you can keep funds in the currency you were paid in and choose when to convert.