# transaction-fee

Source: https://docs.settlemint.com/docs/developers/api-integration/token-features/transaction-fee
API reference for configuring the transaction-fee token feature so the platform deducts per-operation fees on chain for mint, burn, and transfer.



The `transaction-fee` token feature deducts a configured percentage fee from each mint, burn, or transfer operation, crediting the deducted amount to a configured recipient. It is mutually exclusive with [`transaction-fee-accounting`](/docs/developers/api-integration/token-features/transaction-fee-accounting).

For the operator how-to, see [Transaction fee how-to](/docs/operators/token-features/transaction-fee). For the architecture model, see [Transaction fee architecture](/docs/architects/components/token-features/transaction-fee).

## Configuration during token creation [#configuration-during-token-creation]

```json
{
  "transaction-fee": {
    "mintFeeBps": 100,
    "burnFeeBps": 100,
    "transferFeeBps": 50,
    "recipient": "0x..."
  }
}
```

| Parameter        | Type             | Required | Description                                                    |
| ---------------- | ---------------- | -------- | -------------------------------------------------------------- |
| `mintFeeBps`     | Integer          | Yes      | Mint fee in basis points. Zero suppresses mint-fee collection. |
| `burnFeeBps`     | Integer          | Yes      | Burn fee in basis points.                                      |
| `transferFeeBps` | Integer          | Yes      | Holder-initiated transfer fee in basis points.                 |
| `recipient`      | Ethereum address | Yes      | Wallet that receives collected fees in the asset's own units.  |

## Behaviour [#behaviour]

The platform deducts the fee from the operation amount before crediting the holder. A 100-unit mint with `mintFeeBps: 100` credits 99 units to the holder and 1 unit to `recipient`.

## Reading collected fees [#reading-collected-fees]

```
GET /api/v2/token/{address}/features/transaction-fee
```

Returns the configured rates, recipient, and aggregate collected balance per operation type.

## Updating parameters [#updating-parameters]

Restricted-mutable. Update through the governance-update path:

```
PUT /api/v2/token/{address}/features/transaction-fee
{
  "transferFeeBps": 25
}
```

## Related [#related]

* [transaction-fee-accounting](/docs/developers/api-integration/token-features/transaction-fee-accounting) — mutually exclusive variant.
* [Feature constraints](/docs/architects/components/token-features/feature-constraints#mutually-exclusive-rules)