When a fee applies
The fee is collected by the provider that routes the payment, so it applies to payments that go through one:- Deposit-address payments, whether or not the payment needs a conversion.
- Wallet payments that need a swap, because the payer’s token or chain differs from your settlement.
- A direct wallet transfer, where the payer already holds a settlement token on a settlement chain.
- An exchange payment.
disableSwaps still collects the fee on deposit-address payments, but not on wallet payments, because every wallet payment in that flow is a direct transfer.
Recipients
A fee config can name one EVM recipient, one Solana recipient, or both, each with its own percentage of the source amount. A provider can pay a recipient only on the chain families it supports for that payment, and it skips a recipient it cannot pay. Naming both an EVM and a Solana recipient gives each payment the best chance of carrying the fee. Some payments carry no fee even with both recipients named, depending on the chains involved. For example, a deposit-address payment that starts and settles on Solana can carry no fee.How the fee reaches the recipient
Depending on the provider that routes the payment, a fee arrives in one of two ways:- Paid on chain with the payment. The fee is sent to the recipient as part of the payment. There is nothing to collect.
- Accrued as a claimable balance. The fee accumulates off chain and is claimed later. Claims are available for EVM recipients.
Next
Conversions
When a payment needs a swap.
Fees API
Request shapes for fee configs, checking balances, and claiming.