Modo cliente final paga
O cliente final paga a taxa via spread aplicado na taxa cotada (customer_funded). Decomposto em base BlendFi e spread da organização.
No modo customer_funded, o cliente final paga a taxa via uma taxa cotada com spread aplicado. A taxa é composta por dois componentes: a margem operacional da BlendFi (blendfi_base_spread_bps) e o spread comercial da organização (org_spread_bps).
Como funciona
- A taxa cotada para o cliente final aplica um spread total de
blendfi_base_spread_bps + org_spread_bps. - Na execução, a BlendFi captura a margem total via taxa.
- O componente
blendfi_base_spread_bpsé a margem operacional direta da BlendFi e não gera entrada de ledger. - O componente
org_spread_bpsé uma taxa devida pela BlendFi à organização. Por conversão concluída, é registrada como entrada de ledger. - Os percentuais são configurados por direção:
*_offrampe*_onrampsão independentes.
Exemplo numérico
Cenário: mid = 1 USDT = R$ 5,00. Bob (cliente final da organização Acme) faz offramp de 100 USDT. Acme está em customer_funded com blendfi_base_spread_bps_offramp = 100 (1%) e org_spread_bps_offramp = 150 (1,5%).
- Spread total na taxa: 250 bps. Taxa cotada para Bob: 5,00 × 0,975 = 4,875.
- Bob deposita 100 USDT, recebe R$ 487,50.
- A BlendFi vende 100 USDT na exchange regulada a mid, captura R$ 500,00. Margem capturada: R$ 12,50.
- Decomposição: base BlendFi = R$ 5,00 (1 USDT em equivalente mid, retido como margem operacional, sem entrada de ledger); spread da organização = R$ 7,50 (1,5 USDT em equivalente mid, devido à organização).
- Entrada de ledger criada na conclusão:
{ from=blendfi, to=org, amount=1.50, currency=USDT, fee_kind=mode_b_org_spread }. - A BlendFi paga 1,5 USDT à Acme off-platform; a entrada é marcada como liquidada.
Como sua organização vê
A conversão concluída expõe fee_mode='customer_funded', blendfi_fee_bps e org_spread_bps (os percentuais snapshotados) no payload. O target_amount em BRL já reflete o spread aplicado: é o valor que efetivamente vai ao cliente final via Pix.
A base BlendFi não vira receita para o parceiro
O componente blendfi_base_spread_bps é a margem operacional direta da BlendFi. Ele não entra no ledger e não é repassado à organização. Apenas o componente org_spread_bps acumula como taxa devida.
Quando esse modo é apropriado
Tipicamente quando a organização quer monetizar a operação cobrando uma taxa do cliente final via taxa, sem cobrar separadamente em outro fluxo. O cliente final vê uma taxa pior que o mid-price; a organização recebe a parte do spread em entrega periódica off-platform.
Configuração padrão
blendfi_base_spread_bps_offramp e blendfi_base_spread_bps_onramp têm padrão de 100 bps (1%) por direção. org_spread_bps_* têm padrão zero. A negociação comercial pode ajustar qualquer um.
Próximos passos
org_funded: a alternativa em que a organização assume a taxa.- Acerto comercial e ledger interno: como o repasse é liquidado.
