Glossário
Referência alfabética para cada termo de domínio usado nos docs da BlendFi.
Definições curtas para cada termo específico da BlendFi ou da fintech brasileira que você vai encontrar nestes docs. Cada entrada aponta para a página de Conceitos quando há uma mais profunda.
| Termo do glossário | Definição |
|---|---|
| Chave Pix | Identificador curto e amigável registrado no DICT, usado para receber Pix. Cinco tipos: CPF, CNPJ, email, telefone, EVP. |
| CNPJ | Cadastro Nacional da Pessoa Jurídica; 14 dígitos. Obrigatório para organizações que transacionam pela BlendFi. KYB (KYC empresarial) ainda não é suportado na v1. Veja KYC. |
| Cotação | Uma taxa de câmbio fixada para uma transação, com tempo limitado (tipicamente 15 minutos). Criada via |
| CPF | Cadastro de Pessoas Físicas; 11 dígitos. Obrigatório ao criar um usuário. Também pode servir como chave Pix. Veja KYC. |
| DICT | Diretório de Identificadores de Contas Transacionais, registro central brasileiro de chaves Pix. A BlendFi consulta chaves Pix no DICT antes de aceitar uma transação offramp. |
| DLQ | Dead-letter queue (fila de mensagens mortas). Onde as entregas de webhook caem depois de esgotar as 5 retentativas. Na v1, as linhas de entrega de webhook em DLQ permanecem com status |
| Ethereum | A cadeia EVM original. Planejada para liquidação de USDT; ainda não disponível para parceiros na v1. |
| EVP | Endereço Virtual de Pagamento, o tipo aleatório/anônimo de chave Pix, no formato UUID v4. Gerado pelo app do banco do usuário sob demanda. Útil quando o usuário não quer expor CPF, email ou telefone. |
| HMAC-SHA256 | A função de hash criptográfico usada para assinar toda entrega de webhook. O payload assinado é |
| Idempotency-Key | Header HTTP obrigatório em todo request mutante ( |
| Janela de replay | A tolerância de 300 segundos aplicada aos timestamps de webhook. Entregas com |
| KYB | Know Your Business, verificação de identidade para empresas. Ainda não é suportado na v1; chamadas retornam |
| KYC | Know Your Customer, verificação de identidade que a BlendFi conduz antes de o usuário transacionar. Estados: |
| Offramp | A direção cripto-para-fiat: USDT on-chain entra, BRL via Pix sai. O usuário final (ou o parceiro) envia USDT; o destinatário recebe Pix. Veja Offramp. |
| On-chain | Liquidado em uma blockchain pública. A perna USDT da BlendFi é on-chain. |
| Onramp | A direção fiat-para-cripto: BRL via Pix entra, USDT on-chain sai. O usuário final paga Pix; você (o parceiro) recebe USDT liquidado em uma carteira de destino. Veja Onramp. |
| Pix | Sistema de pagamentos instantâneos 24/7 do Brasil. Gratuito para pessoas físicas, identifica destinatários por chave Pix. |
| Polygon | Cadeia L2 compatível com EVM (chain ID 137). Uma das redes em que a BlendFi liquida USDT. Finalidade rápida (cerca de 2 a 4 segundos) e gas baixo. |
| request_id | Identificador por request retornado em toda resposta (sucesso e erro). Formato: ULID. Cole quando entrar em contato com o suporte, aponta para o seu request nos logs da BlendFi. Veja Erros e retentativas. |
| Sandbox | Ambiente de teste que espelha o comportamento de produção, mas não move dinheiro real. Chaves de sandbox começam com |
| Solana | Cadeia não-EVM de alta vazão. Planejada para liquidação de USDT; ainda não disponível para parceiros na v1. |
| USDT | Tether USD, uma stablecoin atrelada ao dólar. A perna cripto de toda transação da BlendFi. Liquidada na Polygon, com Ethereum e Solana em breve. |