Clientes e contas de destino
Quem envia e para onde o dinheiro vai.
Clientes
Um cliente (cus_…) é a pessoa que transaciona pelo parceiro. Ele é cadastrado só com dados cadastrais: documentos ficam com o parceiro, no modelo de KYC delegado.
Campo
Tipo
| Status | Pode transacionar |
|---|---|
PENDING_KYC_ATTESTATION | Não |
ACTIVE | Sim |
SUSPENDED | Não |
O cliente fica ACTIVE quando recebe uma atestação KYC válida, que vale 12 meses.
Contas de destino
Uma conta de destino (rcv_…) define para onde o dinheiro vai e por qual rail. O formato de details depende do rail.
rail | Moeda | details |
|---|---|---|
ACH | USD | bankName, routingNumber, accountNumber, accountType |
WIRE | USD | Campos do ACH e bankAddress |
SWIFT | USD | bic, accountNumber, bankName, bankCountry |
SEPA | EUR | iban, bic |
PIX | BRL | keyType e key |
WALLET | USDT, USDC | network e address |
{
"rail": "ACH",
"currency": "USD",
"holder": { "type": "INDIVIDUAL", "name": "Carlos Oliveira", "relationship": "FAMILY", "country": "USA" },
"details": { "bankName": "Chase Bank", "routingNumber": "021000021", "accountNumber": "000123456789", "accountType": "CHECKING" }
}holder.relationship informa a relação entre o cliente e o titular da conta, usada no monitoramento e na classificação do câmbio. A conta fica VALIDATED quando o rail confirma que ela pode receber, e a resposta traz um displayLabel mascarado (ACH •••• 6789) para exibir ao cliente.