Menu da documentação

validation_failed

HTTP 422 · Dados inválidos


HTTP	`422`
`title`	Dados inválidos
`detail`	Um ou mais campos são inválidos.

Quando acontece: o corpo do POST /v1/payments ou os parâmetros de GET /v1/payments não passam na validação: campo obrigatório ausente, method diferente de pix, amount não inteiro ou menor que 1, expires_at no passado, CPF/CNPJ inválido, metadata com mais de 20 chaves, chave maior que 40 ou valor que não é texto, gateway que não é um inst_…, limit fora de 1 a 100.

O problema traz errors, com o nome do campo (com ponto nos aninhados) e as mensagens:

{ "errors": { "payer.document": ["O payer.document precisa ser um CPF ou CNPJ válido."], "amount": ["The amount field must be an integer."] } }

O que fazer: corrija os campos apontados e reenvie. Este erro não fica guardado na Idempotency-Key: pode reenviar com a mesma chave. As mensagens são para gente ler e hoje saem em inglês nas regras do framework; decida pelo nome do campo, nunca pelo texto.

Exemplo da resposta

application/problem+json

{
    "type": "https://sandbox.pagaki.com.br/errors/validation_failed",
    "title": "Dados inválidos",
    "status": 422,
    "code": "validation_failed",
    "detail": "Um ou mais campos são inválidos.",
    "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.