| Conceito | O que é | Pontos principais |
|---|---|---|
| FX Quotes | Oferta de preço para trocar um valor de USD para BRL. | Não é vinculada a um remetente. Valor fixo em USD ou em BRL. Um preço para PREFUNDED e CREDIT. Validade curta, uso único. usage = REMITTANCE (padrão) para um withdrawal, ou INVENTORY para criar um Inventory Lot. Não verifica o remetente, não reserva limite nem contrata câmbio. |
| Withdrawals | A operação que envia dinheiro de um remetente para um beneficiário no Brasil. | Informa remetente, beneficiário, finalidade, relação e modalidade de funding. PREFUNDED e CREDIT usam uma cotação (quoteId). INVENTORY usa um lote (funding.inventoryId), o valor em BRL e senderQuote, sem quoteId. Criar um withdrawal cria uma remessa. |
| Remittances | A operação completa que envia dinheiro de um remetente para um beneficiário. | Criada por um withdrawal; tipo WITHDRAWAL. Um status de ciclo de vida e sub-status de câmbio, funding, pagamento e liquidação. |
| Senders | Os clientes da MSB nos EUA que iniciam e pagam as remessas. | Pessoa física (18+) ou jurídica. O nível de compliance LEVEL_0 a LEVEL_3 define se e quanto podem enviar em 24h, 30d e 180d. |
| Beneficiaries | As pessoas ou empresas no Brasil que recebem os BRL. | Cadastrado com endereço e tipo de relação. Uma ou mais chaves Pix, cada uma com triagem antes do uso. |
| Funding | Como a remessa é paga antes do envio do Pix. | PREFUNDED usa o USD que a MSB já tem nos EUA, pago antes do Pix. CREDIT antecipa o BRL pela linha de crédito da LB Pay e gera uma obrigação de pagamento. INVENTORY usa volume de câmbio contratado antecipadamente em um Inventory Lot. |
| Inventory Lots | Volume de câmbio contratado antecipadamente pela MSB, com taxa, volume e validade fixos. | Criado com POST /v1/inventories a partir de uma cotação INVENTORY; cada chamada cria um lote novo e independente. Gera uma promessa de pagamento em USDC. Saldos total, disponível, reservado e utilizado, em BRL e USD (total = available + reserved + used). Status ACTIVE, DEPLETED, EXPIRED. Usado por withdrawals com funding.mode = INVENTORY. |
| Wallets | Saldos vinculados às remessas da MSB. | USD Wallet é o saldo pré-fundado em USD da MSB nos EUA. BRL Wallet é saldo real no Brasil. Saldos contábil, disponível, reservado e pendente. |
| Settlements | Lote diário com o que a MSB paga pelo crédito utilizado. | Um lote por data de vencimento: um valor e um pagamento por dia. Status aberto, fechado, vence hoje, em atraso, concluído. A contraparte é a LB Pay. |
| Compliance | Controles aplicados a remetentes, beneficiários e remessas. | Executado automaticamente: níveis de KYC, aprovação do beneficiário, triagem de sanções e PLD. Pode colocar a remessa em ON_HOLD. Não há API de compliance: a MSB vê o resultado no status do remetente, do beneficiário e da remessa. |
Primeiros passos
Conceitos principais
Os blocos que compõem o produto. Cada um aparece no portal e na API com o mesmo nome.

