WEBHOOK_REGISTRATION_FAILED
500api_errorThe webhook could not be persisted.
Cause
The registration write failed server-side, leaving the endpoint possibly half-applied.
How to fix it
Retry with the SAME Idempotency-Key so a partial registration is recovered instead of duplicated.
Example response
500 WEBHOOK_REGISTRATION_FAILED
JSON
{
"error_code": "WEBHOOK_REGISTRATION_FAILED",
"error_type": "api_error",
"error_message": "The webhook could not be persisted.",
"hint": "Retry with the SAME Idempotency-Key so a partial registration is recovered instead of duplicated.",
"docs_url": "https://docs.billerapi.com/errors/WEBHOOK_REGISTRATION_FAILED",
"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/WEBHOOK_REGISTRATION_FAILED
Was this page helpful?