IDEMPOTENCY_KEY_NOT_REPLAYABLE
409invalid_requestThe one-time response for this Idempotency-Key cannot be replayed.
Cause
The original request returned a one-time secret. BillerAPI stored a secret-free completion receipt, not the plaintext response.
How to fix it
Use a fresh Idempotency-Key to generate or rotate again. The previously delivered secret cannot be recovered.
Example response
409 IDEMPOTENCY_KEY_NOT_REPLAYABLE
JSON
{
"error_code": "IDEMPOTENCY_KEY_NOT_REPLAYABLE",
"error_type": "invalid_request",
"error_message": "The one-time response for this Idempotency-Key cannot be replayed.",
"hint": "Use a fresh Idempotency-Key to generate or rotate again. The previously delivered secret cannot be recovered.",
"docs_url": "https://docs.billerapi.com/errors/IDEMPOTENCY_KEY_NOT_REPLAYABLE",
"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_NOT_REPLAYABLE
Was this page helpful?