Commercial settlement and internal ledger
How BlendFi and the organization settle the net of fees. Off-platform settlement, no partner balance API today.
BlendFi keeps an internal ledger that records, on every completed conversion, any reciprocal obligation between BlendFi and the organization generated by fees. Settlement of those obligations is off-platform, conducted in the regular commercial process, and not via API calls.
How the ledger works
On every conversion.completed (in any fee mode that generates an obligation), an entry is created atomically:
org_funded: entry withfrom=org, to=blendfi, amount =org_fee_bps × source_amount, in source currency.customer_funded(withorg_spread_bps > 0): entry withfrom=blendfi, to=org, amount =org_spread_bps × source_amount, in source currency.
In customer_funded with org_spread_bps = 0, no ledger entry is created: BlendFi captures the base spread as direct margin and there is no payout owed.
Currency
Entries are denominated in the source currency of the conversion: USDT for offramp, BRL for onramp. The rationale: a fee is naturally a percentage over operation volume, and offramp volume is the USDT input. Settlement may happen in another currency as commercially agreed (for example, BlendFi paying the partner in BRL for the USDT-equivalent of the ledger).
Settlement
The accumulated net is paid out at the cadence agreed in the commercial relationship (weekly, monthly, etc.). BlendFi's finance team conducts the payment or charge and marks the entries as settled.
No partner balance API today
The organization does not currently have an endpoint to query its own ledger balance. That visibility is internal to BlendFi's finance team. When a public endpoint for it is added, this page will point at it.
How to audit charges
For now, the way to audit the fee on a specific conversion is to read the conversion's payload (fee_mode, org_fee_bps or blendfi_fee_bps + org_spread_bps, depending on the mode) and cross-check against source_amount to reconstruct the ledger entry amount. The API reference exposes the exact fields once published.
Next steps
- Fees model: the comparison between the two modes.
org_fundedandcustomer_funded: detailed mechanics of each mode.
Customer-funded mode
The end customer pays the fee via spread applied in the quoted rate (customer_funded). Decomposed into BlendFi base and partner spread.
Transaction limits
How BlendFi caps transaction volume in two layers, a platform per-transaction cap and a per-user daily/monthly tier, and how to request a raise.
