Skip to main content

​
Formato

Todos os erros retornam JSON com este formato: 
{
  "error": "VALIDATION_ERROR",
  "message": "Campo 'amountBrl' é obrigatório",
  "details": { "field": "amountBrl" },
  "requestId": "req_01hxy..."
}
O header x-request-id também está presente em cada resposta. Inclua-o ao abrir um ticket.

​
Códigos comuns

HTTPerrorSignificado
400VALIDATION_ERRORInput inválido (ver details).
400QUOTE_EXPIREDCotação passou do prazo de 30 s.
401UNAUTHORIZEDCredenciais ausentes ou inválidas.
403FORBIDDENMerchant suspenso ou sem permissão para o recurso.
404NOT_FOUNDRecurso inexistente ou pertencente a outro merchant.
409CONFLICTRecurso duplicado (ex.: receiver com mesmo documento).
422LIMIT_EXCEEDEDOperação excede o limite do receiver (diário ou noturno).
422KYC_NOT_APPROVEDReceiver sem KYC aprovado.
429RATE_LIMITEDMuitas requisições — respeite o header Retry-After.
500INTERNAL_ERRORErro interno. Veja requestId e abra ticket.

​
Retries

Erros 5xx e 429 podem ser retentados com backoff exponencial. Erros 4xx (exceto 429) NÃO devem ser retentados — o input está incorreto.