Guides

Take your fee

Attach a fee instruction; watch the lines land and reconcile.

Your fee rides the transfer as a line, in the same unit. Set where it collects, attach it, and watch the lines reconcile.

01 · Give the fee a home
The environment needs an Accounts-selected app-fee collection target before a fee instruction is accepted. Without it, the instruction is refused 400 — “requires an Accounts-selected AppFee collection target.”
02 · Attach the fee to the transfer
The app fee is your instruction; the movement then carries it as a reserved line.
```
"fees": { "lines": [
  { "kind": "app_fee", "amountMinorUnits": "2500", "status": "reserved" }
] }
```
03 · Read the lines
A settled transfer's fees.lines[] reconcile against the amount: 10,000 available, 4,000 reserved, 2,500 app fee → 3,500 remains. Your app_fee settles into the fee till.

Bearer

A receiver-paid app fee requires an internal destination — the fee comes out of what lands, not on top. Set the bearer on the instruction, not after.