Organization-funded mode
The organization assumes the fee (org_funded). End customer sees mid-price. Off-platform settlement with BlendFi.
In org_funded, the organization fully assumes the operation's fee. The end customer is quoted at mid-price, with no spread visible in the rate. The fee owed by the organization to BlendFi is recorded in the internal ledger and settled off-platform.
How it works
- The
exchange_ratereturned in the quote is mid-price (no spread applied). - The conversion executes exactly at mid; BlendFi's USDT ↔ BRL operation breaks even on margin at execution.
- Per completed conversion, BlendFi recognizes a fee owed by the organization:
org_fee_bps × source_amount, denominated in the source currency (USDT for offramp). - The percentage is configured per direction:
org_fee_bps_offrampandorg_fee_bps_onrampare independent.
Worked example
Setup: mid = 1 USDT = R$ 5.00. Bob (end customer of organization Acme) offramps 100 USDT. Acme is on org_funded with org_fee_bps_offramp = 200 (2%).
- Rate quoted to Bob: 5.00 (mid).
- Bob deposits 100 USDT, receives R$ 500.00.
- BlendFi sells 100 USDT at a regulated exchange at mid, captures R$ 500.00. Direct margin: zero.
- Ledger entry on completion:
{ from=org, to=blendfi, amount=2.00, currency=USDT, fee_kind=mode_a_org_fee }. - Acme later pays 2 USDT (or the agreed BRL equivalent) to BlendFi off-platform; the entry is marked settled.
How your organization sees it
The completed conversion exposes fee_mode='org_funded' and org_fee_bps (the snapshotted percentage) in the payload. The received_amount is the USDT deposited by the end customer; target_amount in BRL is the value delivered via Pix. The 2 USDT owed does not appear as a deduction in those values: it is recorded separately in the internal ledger and billed off-platform.
The fee is in source currency
In org_funded offramp, the fee owed is in USDT. The organization and BlendFi may settle in the ledger currency or the BRL equivalent, as commercially agreed.
When this mode is appropriate
Typically when the organization absorbs the fee as an operational cost, offering the end customer the mid-price as a competitive differentiator. Common cases: payments to suppliers where the organization does not want to expose the operation's margin; cashback or refund programs where the end customer expects the full amount.
Next steps
customer_funded: the alternative in which the end customer pays via the rate.- Commercial settlement and internal ledger: how the ledger entry is settled.
Overview
The two fee modes, org_funded and customer_funded. How each mode shapes the rate the end customer sees and how your organization settles.
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.
