Quibly PayErros
Status HTTP, códigos e reconciliação.
O status HTTP e o campo JSON statusCode coincidem. O formato básico é {"statusCode":400,"message":"Valor inválido."}. Alguns erros também incluem error; FEATURE_DISABLED inclui feature: "apiV3". As mensagens estão em português; prefira o status HTTP e os códigos de erro estáveis, quando disponíveis.
| HTTP | Exemplos |
|---|---|
| 400 | Credenciais ausentes (API_KEY_MISSING), valor inválido, chave_pix/transaction_id ausente, urlnoty inválida, valor abaixo do mínimo, saldo insuficiente incluindo tarifas, limite diário, WITHDRAW_LIMIT_PER_TX, WITHDRAW_LIMIT_DAILY, Idempotency-Key inválida |
| 401 | Credenciais incorretas, chave revogada, ambiente incompatível ou conta bloqueada |
| 403 | API_KEY_SCOPE, API_KEY_IP, CASHOUT_IP_NOT_ALLOWED, FEATURE_DISABLED, entrada/saída de dinheiro desabilitada, MFA ausente, documento do destino incompatível, requisitos de KYC |
| 404 | Transação inexistente ou de outra conta/ambiente; simulação já confirmada ou expirada |
| 405 | Método HTTP incorreto |
| 409 | Conflito de idempotência ou chamada ainda em processamento |
| 500 | Erro interno genérico, provedor de cobrança indisponível ou falha no processamento do saque |
Uma chamada sem resposta ou um erro 500 não provam que a operação deixou de ocorrer. Reutilize a chave de idempotência do saque ao repetir a chamada e reconcilie os IDs de transação salvos. Não entregue um pedido com base em webhook não verificado ou no redirecionamento do cliente.