Skip to main content
You can add your own fee to a Flow payment: a percentage of the payment, on top of Dynamic’s routing costs, paid to wallets you name. Your server attaches a fee config when it creates the flow, and the config is fixed from that point. The recipient does not have to be you. If your app lets your own customers create flows, for example merchants on your platform, the fee config can pay their wallets instead of yours.

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.
These payments carry no added fee:
  • A direct wallet transfer, where the payer already holds a settlement token on a settlement chain.
  • An exchange payment.
A flow that sets 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.
An integration that adds fees needs to handle both: check accrued balances periodically and claim what is waiting.

Next

Conversions

When a payment needs a swap.

Fees API

Request shapes for fee configs, checking balances, and claiming.
Last modified on October 27, 2026