Skip to content

Status Codes

Response status

All API responses include status. Non-200 means failure. Map status enums for user-facing messages; do not expose raw msg to end users.

CodeChineseDescription
200Processed successfullyRequest processed successfully; does not mean the order payment succeeded
403IP not in allowlistPayout restricted; collection not restricted (configurable in merchant console)
1001System errorSystem exception, retry later
1002Processing failed, retry laterUncategorized error
1003Signature errorSignature verification failed
1004Parameter errorParameter validation failed
1005Parameter parse errorRequest body does not match schema
1006Risk control blockedBlacklist risk-control block
1007Invalid TaxNumbertaxNumber validation failed
1301Channel not enabledContact support
1302Channel temporarily closedContact support
1304Bank channel not supportedContact support
1402Merchant not foundContact support
1403Insufficient merchant balanceInsufficient available balance; contact support
1404Merchant closedContact support
1406Duplicate merchant order blockedSame order number submitted multiple times
1407Order not foundCollection/payout order not found in database
1601Bank card info errorAccount empty or incorrect
1603Bank connection timeoutBank network timeout or no response
1801Payout application failedFailed to create payout order
1803User account restricted or rejectedBank connection/rejection or bank risk rejection
1805Order cancelledOrder cancelled

Brazil

CodePortugueseDescription
200sucessoRequest processed successfully; does not mean the order payment succeeded
403Acesso ilegalPayout restricted; collection not restricted (configurable in merchant console)
1001Anomalias no sistemaSystem exception, retry later
1002O pedido comercial falhouGeneral error
1003Erro de verificação da assinaturaSignature verification failed
1004Parâmetros ilegaisParameter validation failed
1005Erro de análise dos parâmetrosRequest body does not match schema
1006Bloqueio do controlo dos riscosBlacklist risk-control block
1007Documento inválido(CPF/CNPJ)taxNumber validation failed
1301O acesso do comerciante não está disponíveContact support
1302Acesso temporariamente fechadoContact support
1304Acesso não abertoContact support
1402Fechamento do produtoContact support
1403Equilíbrio insuficienteInsufficient available balance; contact support
1404O acesso do comerciante não está disponívelContact support
1406Repetição de pedidos de comerciantesSame order number submitted multiple times
1407Ordem não encontradaCollection/payout order not found in database
1601Dados incorretos do cartão bancárioAccount empty or incorrect
1801Aplicação fracassadaFailed to create payout order
1803O acesso é fechadoBank connection/rejection or bank risk rejection
1805Cancelamento da encomendaOrder cancelled

Common Portuguese phrases (optional)

ChinesePortuguese
Payment completedPagamento concluído
Payment succeededPagamento bem-sucedido
Payment failedO pagamento falhou
Payment cancelledCancelamento de pagamento
Order cancelledCancelamento de pedido
Payment exceptionExceção de pagamento

Transafe Developer Documentation