Skip to content

IDEMPOTENCY_REQUIRED

HTTP 400 — Idempotency-Key required

This request takes money and needs an Idempotency-Key header: 8 to 128 characters of letters, digits, hyphen or underscore. It was missing or the wrong shape.

What to do

Generate one per attempt (a UUID is ideal), store it with the order, and send the same one on every retry of the same request.

Can I retry?

Not unchanged. Something in the request has to change first — retrying as-is gets the same answer.

The body you received

json
{
  "error": {
    "code": "IDEMPOTENCY_REQUIRED",
    "doc": "https://docs.pamopay.co/errors/IDEMPOTENCY_REQUIRED",
    "request_id": "req_5f3a9c2b1d4e6f7a8b9c0d1e"
  }
}

Quote request_id when you write to us; it finds the call without anybody grepping by timestamp.

All error codes

Every code, scope and route on this site is rendered from the API's own source.