Menu da documentação

gateway_rejected

HTTP 502 · Recusado pelo gateway


HTTP	`502`
`title`	Recusado pelo gateway
`detail`	A mensagem do gateway, como o conector a montou (ex.: `Asaas recusou a requisição (HTTP 400): …`)

Quando acontece: o gateway recusou a cobrança por regra de negócio dele (recusa definitiva). Não há fallback: tentar outro gateway não mudaria a decisão. Hoje os conectores do Asaas e da Efí classificam as recusas de PIX como gateway_invalid_data; este código existe para recusas de negócio (como cartão negado, F4). O problema traz payment, com status: failed, e sai o webhook payment.failed.

O que fazer: não repita igual. Leia o detail; se der para corrigir, crie um pagamento novo com outra Idempotency-Key. A resposta fica guardada na chave usada.

Exemplo da resposta

application/problem+json

{
    "type": "https://sandbox.pagaki.com.br/errors/gateway_rejected",
    "title": "Recusado pelo gateway",
    "status": 502,
    "code": "gateway_rejected",
    "detail": "A mensagem do gateway, como o conector a montou (ex.: `Asaas recusou a requisição (HTTP 400): …`)",
    "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.