Payments - cross-border settlement


The cross-border settlement API allows you to configure and execute cross-border payments.

Generally, the process for making cross-border payments includes:

  1. Creating a cross-border settlement configuration. Configurations are templates that define the fiat currencies to exchange and the accounts to use when routing funds. Cross-border settlements take the following route: on-ramp > vault account > off-ramp > fiat destination. You must define an on-ramp and a vault account. Defining an off-ramp and a fiat destination is optional.
  2. Creating a specific payment flow. Select the configuration to use and the specific amount of the asset to exchange.
  3. Executing the cross-border settlement. Initiate the transfer based on the details in the configuration and payment flow.

After initiating the settlement, your funds are automatically processed over several steps:

  1. The on-ramp platform defined in the configuration converts your funds from fiat currency into stablecoin.
  2. Your funds in stablecoin are transferred to the vault account defined in the configuration.
  3. Your funds are then transferred from your vault account to the off-ramp platform defined in the configuration.
  4. The off-ramp platform converts your funds from stablecoin into fiat currency defined in the configuration.
  5. Your funds can then be transferred to your fiat bank account or crypto wallet.


Slippage refers to the difference between the expected price of a trade and the price at which a trade is executed.

When creating a payment flow for a specific cross-border settlement, you receive an estimate for the conversion rate. This estimate is time-sensitive and can expire before the execution of the trade. Therefore, the actual conversion rate at the time of execution may differ from the original estimate.

You can set the slippage amount you are willing to tolerate. Slippage is defined by basis points (bps). If you do not set a slippage amount, the default slippage of 10,000 bps (10%) is used.