Pular para o conteúdo
Menu da documentação

Erros

idempotency_key_required

HTTP 400 · Idempotency-Key obrigatória

HTTP 400
title Idempotency-Key obrigatória
detail Envie o header Idempotency-Key em toda criação.

Quando acontece: um POST sob /v1 (criar ou cancelar pagamento) chegou sem o header Idempotency-Key, ou com ele vazio.

O que fazer: gere uma chave por operação (um UUID serve), guarde-a antes de enviar e mande-a no header. Ver idempotência.

Exemplo da resposta

application/problem+json
{
    "type": "https://sandbox.pagaki.com.br/errors/idempotency_key_required",
    "title": "Idempotency-Key obrigatória",
    "status": 400,
    "code": "idempotency_key_required",
    "detail": "Envie o header Idempotency-Key em toda criação.",
    "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.