Menu da documentação

invalid_state

HTTP 409 · Estado não permite cancelar


HTTP	`409`
`title`	Estado não permite cancelar
`detail`	Só cobranças pendentes podem ser canceladas.

Quando acontece: POST /v1/payments/{id}/cancel num pagamento que não está em pending (já pago, expirado, cancelado, falho ou ainda em processing). O mesmo código sai em retry e cancel de um bill_payment fora do status permitido, com o title "Estado não permite a operação".

O que fazer: consulte o pagamento (GET /v1/payments/{id}) e decida pelo status atual. Um pagamento em processing só pode ser cancelado depois de virar pending. A resposta fica guardada na chave: para tentar de novo, use outra Idempotency-Key.

Exemplo da resposta

application/problem+json

{
    "type": "https://sandbox.pagaki.com.br/errors/invalid_state",
    "title": "Estado não permite cancelar",
    "status": 409,
    "code": "invalid_state",
    "detail": "Só cobranças pendentes podem ser canceladas.",
    "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.