IDEMPOTENCY_KEY_REQUIRED
400invalid_requestThis write requires an Idempotency-Key header.
Cause
The Idempotency-Key header was absent, empty, or longer than 255 characters.
How to fix it
Send one unique key per logical attempt and reuse the same key across retries.
Example response
400 IDEMPOTENCY_KEY_REQUIRED
JSON
{
"error_code": "IDEMPOTENCY_KEY_REQUIRED",
"error_type": "invalid_request",
"error_message": "This write requires an Idempotency-Key header.",
"hint": "Send one unique key per logical attempt and reuse the same key across retries.",
"docs_url": "https://docs.billerapi.com/errors/IDEMPOTENCY_KEY_REQUIRED",
"request_id": "d94f5e2a-8c3b-4f1e-9a7d-6b2c1e0f8a34"
}Related
- Error handling — the error envelope shape and how to parse it
- Error code reference — every stable error code
Canonical docs URL: https://docs.billerapi.com/errors/IDEMPOTENCY_KEY_REQUIRED
Was this page helpful?