Status Codes
Response status
All API responses include
status. Non-200means failure. Map status enums for user-facing messages; do not expose rawmsgto end users.
| Code | Chinese | Description |
|---|---|---|
| 200 | Processed successfully | Request processed successfully; does not mean the order payment succeeded |
| 403 | IP not in allowlist | Payout restricted; collection not restricted (configurable in merchant console) |
| 1001 | System error | System exception, retry later |
| 1002 | Processing failed, retry later | Uncategorized error |
| 1003 | Signature error | Signature verification failed |
| 1004 | Parameter error | Parameter validation failed |
| 1005 | Parameter parse error | Request body does not match schema |
| 1006 | Risk control blocked | Blacklist risk-control block |
| 1007 | Invalid TaxNumber | taxNumber validation failed |
| 1301 | Channel not enabled | Contact support |
| 1302 | Channel temporarily closed | Contact support |
| 1304 | Bank channel not supported | Contact support |
| 1402 | Merchant not found | Contact support |
| 1403 | Insufficient merchant balance | Insufficient available balance; contact support |
| 1404 | Merchant closed | Contact support |
| 1406 | Duplicate merchant order blocked | Same order number submitted multiple times |
| 1407 | Order not found | Collection/payout order not found in database |
| 1601 | Bank card info error | Account empty or incorrect |
| 1603 | Bank connection timeout | Bank network timeout or no response |
| 1801 | Payout application failed | Failed to create payout order |
| 1803 | User account restricted or rejected | Bank connection/rejection or bank risk rejection |
| 1805 | Order cancelled | Order cancelled |
Brazil
| Code | Portuguese | Description |
|---|---|---|
| 200 | sucesso | Request processed successfully; does not mean the order payment succeeded |
| 403 | Acesso ilegal | Payout restricted; collection not restricted (configurable in merchant console) |
| 1001 | Anomalias no sistema | System exception, retry later |
| 1002 | O pedido comercial falhou | General error |
| 1003 | Erro de verificação da assinatura | Signature verification failed |
| 1004 | Parâmetros ilegais | Parameter validation failed |
| 1005 | Erro de análise dos parâmetros | Request body does not match schema |
| 1006 | Bloqueio do controlo dos riscos | Blacklist risk-control block |
| 1007 | Documento inválido(CPF/CNPJ) | taxNumber validation failed |
| 1301 | O acesso do comerciante não está disponíve | Contact support |
| 1302 | Acesso temporariamente fechado | Contact support |
| 1304 | Acesso não aberto | Contact support |
| 1402 | Fechamento do produto | Contact support |
| 1403 | Equilíbrio insuficiente | Insufficient available balance; contact support |
| 1404 | O acesso do comerciante não está disponível | Contact support |
| 1406 | Repetição de pedidos de comerciantes | Same order number submitted multiple times |
| 1407 | Ordem não encontrada | Collection/payout order not found in database |
| 1601 | Dados incorretos do cartão bancário | Account empty or incorrect |
| 1801 | Aplicação fracassada | Failed to create payout order |
| 1803 | O acesso é fechado | Bank connection/rejection or bank risk rejection |
| 1805 | Cancelamento da encomenda | Order cancelled |
Common Portuguese phrases (optional)
| Chinese | Portuguese |
|---|---|
| Payment completed | Pagamento concluído |
| Payment succeeded | Pagamento bem-sucedido |
| Payment failed | O pagamento falhou |
| Payment cancelled | Cancelamento de pagamento |
| Order cancelled | Cancelamento de pedido |
| Payment exception | Exceção de pagamento |