PENDING
Operação criada e aguardando evolução.
A API usa HTTP status code para validar a chamada e um status de negócio para indicar o andamento da operação.
| HTTP | Quando aparece | Como tratar |
|---|---|---|
| 200 | Consulta executada com sucesso. | Processe a resposta normalmente. |
| 201 | Cobranca ou saque aceito pela XXXPay. | Salve o transactionId e aguarde webhook. |
| 400 | Payload invalido, valor minimo, campo ausente ou callback invalido. | Corrija os dados no backend do seller. |
| 401 | Token, ci ou cs ausente/invalido. | Reautentique ou revise a credencial. |
| 403 | Conta inativa ou token expirado/invalido. | Renove token ou revise status da conta. |
| 404 | Carteira ou transacao nao encontrada. | Verifique se o identificador pertence ao seller certo. |
| 409 | Identificador externo reaproveitado em contexto indevido. | Garanta unicidade por operacao. |
| 422 | Recurso temporariamente indisponivel. | Exiba mensagem neutra ao operador e tente outro fluxo. |
| 429 | Rate limit excedido. | Implemente retry com backoff. |
| 500/502 | Falha interna ou indisponibilidade temporaria. | Registre o evento, responda com fallback e tente novamente. |
Operação criada e aguardando evolução.
Operação em processamento assíncrono.
Operação confirmada e pronta para conciliação.