Menu da documentação

gateway_invalid_data

HTTP 422 · Dados recusados pelo gateway


HTTP	`422`
`title`	Dados recusados 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 os dados da cobrança (por exemplo, documento ou e-mail que ele não aceita). Não há fallback: outro gateway recusaria o mesmo dado. O problema traz payment, com status: failed, e sai o webhook payment.failed.

O que fazer: corrija os dados do pagador e crie um pagamento novo, com outra Idempotency-Key. O pagamento failed fica como registro.

Exemplo da resposta

application/problem+json

{
    "type": "https://sandbox.pagaki.com.br/errors/gateway_invalid_data",
    "title": "Dados recusados pelo gateway",
    "status": 422,
    "code": "gateway_invalid_data",
    "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.