Criação do withdrawal

Endpoint: POST /v1/remittances/withdrawals.

Dados exigidos

Item	Descrição
Cotação	Cotação `AVAILABLE` e não expirada. Define os valores e a taxa.
Remetente	Remetente cadastrado, ativo, com nível `LEVEL_1` ou superior e com limite disponível.
External ID	Sua referência única para a remessa. Não pode se repetir.
Beneficiário	Beneficiário cadastrado, `ACTIVE`, com chave Pix `APPROVED`.
Instrução de pagamento	A chave Pix a ser paga. Opcional quando o beneficiário tem exatamente uma chave `APPROVED`.
Finalidade (purpose)	`FAMILY_MAINTENANCE`, `GIFT`, `PERSONAL_SAVINGS`, `EDUCATION`, `MEDICAL`, `SERVICES_PAYMENT`, `GOODS_PAYMENT`, `SALARY`, `OTHER`.
Descrição da finalidade	Obrigatória quando a finalidade é `OTHER`. Até 140 caracteres.
Relação (relationship)	Relação do remetente com o beneficiário: `SELF`, `FAMILY`, `FRIEND`, `EMPLOYER`, `EMPLOYEE`, `BUSINESS_PARTNER`, `OTHER`.
Modalidade de funding	`PREFUNDED` ou `CREDIT`.

Validações antes do câmbio

Estas verificações acontecem na hora, antes de comprometer funding ou câmbio. Se alguma falhar, o withdrawal é rejeitado e nenhum câmbio é contratado.

A requisição não é duplicada e o external ID ainda não foi usado.
A cotação existe, não expirou e não foi usada.
A modalidade de funding está habilitada para a sua conta.
O remetente existe, está ativo, tem nível que permite enviar (LEVEL_1 ou superior) e limite disponível nas janelas de 24 horas, 30 dias e 180 dias.
O beneficiário está ACTIVE e a chave Pix está APPROVED.
Verificação da chave Pix: a chave existe. Isso evita câmbio para uma chave inexistente. A titularidade é confirmada depois, logo antes do Pix.
O valor está dentro do mínimo e do máximo por remessa e do limite diário da sua conta.
O beneficiário tem limite disponível nas janelas de 24 horas, 30 dias e 180 dias.
O limite de crédito (CREDIT) ou o saldo em USD nos EUA (PREFUNDED) é reservado para esta remessa.

A triagem de sanções e as regras de PLD podem colocar a remessa em ON_HOLD para análise manual, em vez de rejeitá-la, na criação ou durante o screening. O câmbio só é contratado depois do screening concluído.

Motivos de rejeição mais comuns

Código	O que significa e o que fazer
`QUOTE_EXPIRED`	A cotação expirou. Solicite uma nova cotação e crie o withdrawal de novo.
`QUOTE_ALREADY_USED`	A cotação já foi usada por outro withdrawal. Consulte a remessa criada por ele (a cotação mostra o remittance ID) ou solicite uma nova cotação.
`DUPLICATE_EXTERNAL_ID`	O external ID já foi usado. Use um novo ou consulte a remessa existente.
`SENDER_NOT_ELIGIBLE`	O remetente não existe, não está ativo ou está em `LEVEL_0`. Complete os dados do remetente. Para evitar, confira o remetente antes de cotar.
`SENDER_LIMIT_EXCEEDED`	O remetente atingiu o limite de uma janela. Aguarde a janela ou suba o nível de compliance.
`BENEFICIARY_NOT_ELIGIBLE`	O beneficiário não está `ACTIVE`.
`RELATIONSHIP_MISMATCH`	A relação informada não combina com o tipo do beneficiário (`SELF_OWNED` exige `SELF`).
`BENEFICIARY_LIMIT_EXCEEDED`	O beneficiário atingiu o limite de uma janela. Aguarde a janela.
`PAYMENT_INSTRUCTION_INVALID`	A instrução não pode ser usada. Escolha outra instrução ativa do beneficiário.
`PIX_KEY_NOT_FOUND`	A chave Pix não existe. Confirme a chave com o beneficiário.
`CREDIT_LIMIT_EXCEEDED`	O limite de crédito não é suficiente. Use `PREFUNDED` ou aguarde uma liquidação.
`INSUFFICIENT_PREFUNDED_BALANCE`	O saldo em USD nos EUA não é suficiente. Transfira USD conforme as instruções de aporte ou use `CREDIT`.
`FUNDING_MODE_NOT_ENABLED`	Esta modalidade de funding não está habilitada para a sua conta.
`AMOUNT_BELOW_MINIMUM` / `AMOUNT_ABOVE_LIMIT`	O valor está fora dos limites por remessa da sua conta. Ajuste o valor.
`ACCOUNT_DAILY_LIMIT_EXCEEDED`	Sua conta atingiu o limite diário. Aguarde o dia seguinte.
`SERVICE_UNAVAILABLE`	Temporário, inclusive manutenção. Tente novamente mais tarde.

O que você faz

Envie cotação, remetente, beneficiário, chave Pix, finalidade, relação e modalidade de funding.
Use um external ID novo em cada remessa.
Se a requisição for rejeitada, leia o código e siga a ação da tabela.

Primeiros passos

Remessas

Cadastros e saldos

Operação

Dados exigidos

Validações antes do câmbio

Motivos de rejeição mais comuns

​Dados exigidos

​Validações antes do câmbio

​Motivos de rejeição mais comuns

Dados exigidos

Validações antes do câmbio

Motivos de rejeição mais comuns