Glossary | BlendFi Docs

Short definitions for every BlendFi-specific or Brazilian-fintech-specific term you'll encounter in these docs. Each entry links to the deeper Concepts page when one exists.

Glossary termDefinition

Glossary term	Definition
CNPJ	Brazilian business tax ID; 14 digits. Required for organizations transacting through BlendFi. KYB (business KYC) is not yet supported in v1. See KYC.
CPF	Brazilian individual tax ID; 11 digits. Required when creating a user. Can also serve as a Pix key. See KYC.
DICT	Diretório de Identificadores de Contas Transacionais, Brazil's central registry of Pix keys. BlendFi looks up Pix keys against DICT before accepting an offramp transaction.
DLQ	Dead-letter queue. Where webhook deliveries land after exhausting their 5 retry attempts. In v1, DLQ-d webhook delivery rows stay in `dispatched` status, partner-visible quirk documented in Webhooks.
Ethereum	The original EVM chain. Planned for USDT settlement; not yet partner-facing in v1.
EVP	Endereço Virtual de Pagamento, the random/anonymous Pix key type, formatted as a UUID v4. Generated by the user's bank app on demand. Useful when the user doesn't want to expose CPF/email/phone.
HMAC-SHA256	The cryptographic hash function used to sign every webhook delivery. The signed payload is `{timestamp}.{raw_body}`; the partner verifies with their endpoint's secret. See Webhooks.
Idempotency-Key	HTTP header required on every mutating request (`POST`, `PATCH`, `DELETE`). Same key + same body returns the original response (no duplicate side effects). Recommended: a UUID per logical operation. See Idempotency.
KYB	Know Your Business, identity verification for companies. Not yet supported in v1; calls return `kyb_not_yet_supported` (422). See KYC.
KYC	Know Your Customer, identity verification BlendFi runs before a user can transact. States: `not_started` → `pending` → `approved` / `rejected` / `expired`. See KYC.
Offramp	The crypto-to-fiat direction: USDT on-chain in, BRL via Pix out. End user (or partner) sends USDT; the recipient gets Pix. See Offramp.
On-chain	Settled on a public blockchain. BlendFi's USDT leg is on-chain.
Onramp	The fiat-to-crypto direction: BRL via Pix in, USDT on-chain out. End user pays Pix; you (the partner) get USDT settled to a destination wallet. See Onramp.
Pix	Brazil's instant 24/7 payment system. Free for individuals, identifies recipients by Pix key.
Pix key	A short user-friendly identifier registered in DICT, used to receive Pix. Five types: CPF, CNPJ, email, phone, EVP.
Polygon	EVM-compatible L2 chain (chain ID 137). One of the networks BlendFi settles USDT on. Fast finality (~2–4 s), low gas.
Quote	A pinned exchange rate for a transaction, time-limited (typically 15 minutes). Created via `POST /v1/quotes`; consumed once by `POST /v1/quotes/:id/accept`. Expires with `quote_expired` (409). See Build an onramp.
Replay window	The 300-second tolerance applied to webhook timestamps. Deliveries with `now - timestamp > 300s` are treated as replay attacks and rejected. Sync your servers' clocks to NTP. See Webhooks.
request_id	Per-request identifier returned in every response (success and error). Format: ULID. Paste this when contacting support, it pinpoints your request in BlendFi's logs. See Errors and retries.
Sandbox	Test environment that mirrors production behavior but doesn't move real money. Sandbox keys start with `sk_test_…`. Test_helpers endpoints let you drive the lifecycle synthetically. See Start building.
Solana	High-throughput non-EVM chain. Planned for USDT settlement; not yet partner-facing in v1.
USDT	Tether USD, a USD-pegged stablecoin. The crypto leg of every BlendFi transaction. Settled on Polygon, with Ethereum and Solana coming soon.