How to Configure Settlement Currency

Settlement currencies

Settlement Currency (also referred to as Receive Currency) determines the currency in which you will receive funds after a shopper successfully pays for an order. For example, if a shopper pays in BTC, you can configure your settings to automatically convert the received amount to EUR.

There are two ways to set your preferred settlement currency:

1. Via API
   When creating an order through the API, include the receive_currency parameter in the request.
   👉 See API reference: Create Order – receive_currency.
   If you are using an eCommerce plugin (e.g., PrestaShop, WooCommerce), use the method described in option 2 below instead.
2. Via Dashboard
   1. Log in to your CoinGate account.
   2. Navigate to Integrations →  API Management.
   3. Select the relevant API App.
   4. Open the Currency Settings tab.
   5. Set your preferred settlement currency there.
   6. 👉 Guide on how to configure via Dashboard: How to Manage Currency Settings in Your CoinGate Business Dashboard.

Note: If you configure both methods (Dashboard and API), the receive_currency value passed via API will take precedence and override the Dashboard settings.

Fallback currencies

By default, the fallback currency is USDC - unless otherwise specified, all processed orders are automatically settled in USDC. You can configure account-level fallback currencies to control this: an ordered list of settlement currencies used when your primary receive currency cannot be used (for example, it has been disabled or temporarily disabled).

1. Log in to your CoinGate account.
2. Go to Business settings → Currency settings.
3. Set a Primary fallback currency, and optionally up to three additional Secondary fallback currencies, in priority order.

CoinGate settles in the first currency from this list that is enabled and available.