Menu da documentação

gateway_failure

HTTP 502 · Nenhum gateway concluiu a cobrança (na criação) ou Falha no gateway (no cancelamento)


HTTP	`502`
`title`	Nenhum gateway concluiu a cobrança (na criação) ou Falha no gateway (no cancelamento)
`detail`	Na criação, a mensagem do último gateway ou "Nenhum gateway disponível conseguiu criar a cobrança."; no cancelamento, "O gateway não confirmou o cancelamento. Tente de novo."

Quando acontece:

Na criação: todos os gateways candidatos falharam (indisponíveis, limite atingido, credencial inválida, resposta desconhecida) e o Pagaki já fez o fallback. O problema traz payment, com status: failed, e sai payment.failed.
No cancelamento: o gateway não confirmou o cancelamento. O pagamento continua pending e o problema não traz payment.
Na simulação da conta (pay_bill): o gateway não respondeu; nada foi criado e o problema não traz payment.

O que fazer: na criação, crie um pagamento novo com outra Idempotency-Key depois de alguns segundos. No cancelamento, repita o cancelamento com outra Idempotency-Key (o 502 fica guardado na chave usada). Em ambos, o attempts[] do pagamento mostra o que cada gateway respondeu.

Exemplo da resposta

application/problem+json

{
    "type": "https://sandbox.pagaki.com.br/errors/gateway_failure",
    "title": "Nenhum gateway concluiu a cobrança (na criação) ou Falha no gateway (no cancelamento)",
    "status": 502,
    "code": "gateway_failure",
    "detail": "Na criação, a mensagem do último gateway ou \"Nenhum gateway disponível conseguiu criar a cobrança.\"; no cancelamento, \"O gateway não confirmou o cancelamento. Tente de novo.\"",
    "request_id": "01JBZ3Q2W5E8R1T4Y7K0M3N6P9"
}

Decida pelo code, que é estável; o detail pode mudar de texto. Guarde o request_id para falar com o suporte. Todos os erros.