> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Partner Fees

> Earn revenue by adding fees to transactions processed through Lumx

A partner fee is an extra charge you add on top of a transaction to earn revenue. You define the fee structure, Lumx collects it from your customers and shares it with you. Each configuration has:

* A name to identify it.
* 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

Two fee types, configured independently for on-ramp and off-ramp:

| **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 |

You can combine both. For example, charge 50 bps plus a \$0.50 flat fee 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 applies the default fee.

Useful when you want consistent pricing across transactions without specifying the fee each time.

## Configuring partner fees

Create and manage partner fees in the [Dashboard](https://dashboard.lumx.io/?to=%2Fsettings%2Fpartner-fees) or through the API.

<Note>You need to be a project admin or owner to create partner fees.</Note>

## 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 it to use your default fee.           |

## Fee destination

Collected fees are sent to the wallet address you specify. Supported networks:

* EVM-compatible wallets (Ethereum, Polygon, Base, 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.

<Tip>Test fee collection in sandbox before going live.</Tip>

## Related resources

<CardGroup cols={2}>
  <Card title="Transactions" href="/concepts/transactions">
    Where partner fees are applied and collected.
  </Card>

  <Card title="Exchange Rates" href="/concepts/exchange-rates">
    Locked rates can include the fee in the quote.
  </Card>
</CardGroup>