Skip to main content
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 orders with mode = "SALE". A SALE order without explicit currency and recipient values requires at least one settlement currency configured in the dashboard. If a SALE order includes currency and recipient, that order settles to the specified asset and address instead of the dashboard default. For mode = "DEPOSIT", the crypto asset settles directly to the recipient address specified in the order 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.