Settlement currencies: choose your payout asset and chain

Define which asset and chain you receive payment settlement in, regardless of what your customers pay with at checkout.

The Settlement tab controls how and where CoinVoyage pays out completed payments. You can define which asset and chain you receive funds in, regardless of what your customers pay with.

How settlement currencies work

When a customer pays in any supported cryptocurrency, such as BTC, ETH, or SOL, CoinVoyage can automatically convert and settle the funds to the asset and chain you specify. You can configure multiple settlement currencies across different chains, and CoinVoyage optimizes routing by selecting the path with the best available quote.

All settlements are non-custodial and executed on-chain.

Settlement currency configuration applies only to PayOrders with mode = "SALE". A SALE PayOrder without intent.asset requires at least one settlement currency configured in the dashboard. If a SALE PayOrder includes intent.asset, that order settles to the specified asset and chain instead of the dashboard default. For mode = "DEPOSIT", the crypto asset settles directly to the wallet address specified in the PayOrder request.

Configuring a settlement currency

1. Open the Settlement tab

   Go to dashboard.coinvoyage.io/settlement and click Add Settlement Currency.

2. Select a chain

   Choose the blockchain network you want to receive settlement on.

3. Select an asset

   Choose the token or coin you want your payments converted and settled into on that chain.

4. Save

   Confirm the selection. The new settlement currency is now active and will be used for eligible incoming payments.

You can add multiple settlement currencies to give CoinVoyage more routing options and improve settlement efficiency.