# transaction-fee-accounting

Source: https://docs.settlemint.com/docs/developers/api-integration/token-features/transaction-fee-accounting
API reference for configuring the transaction-fee-accounting token feature so the platform records per-operation fee accruals on chain without on-chain deduction.



The `transaction-fee-accounting` token feature records the accrued fee for each mint, burn, or transfer operation without deducting on chain. The platform exposes the accrual ledger for off-chain settlement. It is mutually exclusive with [`transaction-fee`](/docs/developers/api-integration/token-features/transaction-fee).

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

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

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

| Parameter        | Type             | Required | Description                                                                       |
| ---------------- | ---------------- | -------- | --------------------------------------------------------------------------------- |
| `mintFeeBps`     | Integer          | Yes      | Recorded mint-fee accrual rate.                                                   |
| `burnFeeBps`     | Integer          | Yes      | Recorded burn-fee accrual rate.                                                   |
| `transferFeeBps` | Integer          | Yes      | Recorded transfer-fee accrual rate.                                               |
| `recipient`      | Ethereum address | Yes      | Recipient identity recorded on accrual entries. Not transferred to automatically. |

## Behaviour [#behaviour]

The platform records the accrual but does not transfer. Holders receive the full gross amount. Settlement to `recipient` happens off chain through the operating-team's banking flow, using the accrual ledger as the reconciliation source.

## Reading the accrual ledger [#reading-the-accrual-ledger]

```
GET /api/v2/token/{address}/features/transaction-fee-accounting
GET /api/v2/token/{address}/features/transaction-fee-accounting/entries?since={block}
```

Returns the running accrual totals and the per-operation entries since a given block.

## Marking settled [#marking-settled]

```
POST /api/v2/token/{address}/features/transaction-fee-accounting/settle
{
  "entriesUpTo": "0x...",
  "settledAmount": "..."
}
```

Marks accrual entries as settled. The platform records the off-chain settlement reference for the audit ledger.

## Related [#related]

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