Acerto comercial e ledger interno
Como BlendFi e a organização acertam o net das taxas. Liquidação off-platform, sem API de saldo do parceiro hoje.
A BlendFi mantém um ledger interno que registra, em cada conversão concluída, qualquer obrigação recíproca entre BlendFi e a organização gerada por taxas. A liquidação dessas obrigações é off-platform, conduzida no processo comercial regular, e não via chamadas de API.
Como o ledger funciona
A cada conversion.completed (em qualquer modo de taxa que gere obrigação), uma entrada é criada atomicamente:
org_funded: entrada comfrom=org, to=blendfi, valor =org_fee_bps × source_amount, em moeda de origem.customer_funded(comorg_spread_bps > 0): entrada comfrom=blendfi, to=org, valor =org_spread_bps × source_amount, em moeda de origem.
Em customer_funded com org_spread_bps = 0, nenhuma entrada de ledger é criada: a BlendFi captura o spread base como margem direta e não há repasse devido.
Moeda
As entradas são denominadas na moeda de origem da conversão: USDT no offramp, BRL no onramp. A racional é que taxa é naturalmente percentual sobre o volume, e o volume do offramp é o input em USDT. A liquidação pode ser feita em outra moeda combinada comercialmente (por exemplo, BlendFi pagando ao parceiro em BRL pelo equivalente em USDT do ledger).
Liquidação
A entrega do net acumulado é cadenciada conforme combinado na relação comercial (semanal, mensal, etc.). O time de finanças da BlendFi conduz o pagamento ou a cobrança e marca as entradas como liquidadas.
Sem API de saldo do parceiro hoje
A organização não tem hoje um endpoint para consultar o saldo do próprio ledger. Essa visibilidade é interna ao time financeiro da BlendFi. Quando um endpoint público para isso for adicionado, esta página vai apontar para ele.
Como conferir o que foi cobrado
Por enquanto, a forma de auditar a taxa de uma conversão específica é ler o payload da própria conversão (fee_mode, org_fee_bps ou blendfi_fee_bps + org_spread_bps, conforme o modo) e cruzar com o source_amount para reconstruir o valor da entrada de ledger. A referência da API expõe os campos exatos quando publicada.
Próximos passos
- Modelo de taxas: a comparação entre os dois modos.
org_fundedecustomer_funded: mecânica detalhada de cada modo.
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.
Limites de transação
Como a BlendFi limita o volume de transações em duas camadas, um teto por operação na plataforma e um teto diário e mensal por usuário em tiers, e como solicitar alteração.