BlendFi
Taxas

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: *_offramp e *_onramp sã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

Nesta página