A partner fee allows you to earn revenue from every transaction. You define the fee structure, and Lumx automatically collects it from your customers and shares it with you.
What is a partner fee?
Partner fees are additional charges you add on top of transactions. Each partner fee includes:
- A name to identify the fee configuration
- Fee rates for on-ramp and off-ramp transactions
- A wallet address where collected fees are sent
You can create multiple partner fees for different use cases and customers.
Fee types
You can configure two types of fees, independently for on-ramp and off-ramp transactions:
| Type | Description | Example |
|---|
| Rate | Percentage of the transaction amount, in basis points (bps) | 75 bps = 0.75% |
| Flat | Fixed amount per transaction, in dollars | $1.00 per transaction |
Default fee
You can mark one partner fee as default (isDefault: true). When a transaction or exchange rate request doesn’t include a partnerFeeId, Lumx automatically applies the default fee.
This is useful when you want consistent pricing across all transactions without specifying the fee each time.
Configuring partner fees
You can create and manage partner fees in the Dashboard or through the API.
You must be a project admin or owner to create partner fees.
When fees are applied
How you apply a partner fee depends on which exchange rate type you use:
| Rate type | When to include partnerFeeId |
|---|
| Locked rate | When requesting the exchange rate—the fee becomes part of the locked quote |
| Floating rate | When creating the transaction—or omit to use your default fee |
Fee destination
Collected fees are sent to the wallet address you specify. Supported networks:
- EVM-compatible wallets (Ethereum, Arbitrum, Polygon, etc.)
- TVM-compatible wallets (Tron)
You can use a Lumx-generated wallet by creating a customer from your entity, or use your own treasury wallet.
Test fee collection in sandbox mode before going live.
