401 Unauthorized
Webhook signature not accepted
- Code
webhook_signature_invalid- Status
401Unauthorized- Type
https://errors.clavian.io/webhook-signature-invalid
What it means
The webhook’s signature does not match its raw body under the provider’s signing secret, or its timestamp is more than five minutes old. Nothing was recorded.
What to do
A provider should sign the exact bytes it sends and deliver promptly; a stale delivery is retried by the provider with a fresh signature. Do not resend the same bytes and headers.
Example
The API answers with status 401 and this body, as application/problem+json. A detail may be added, saying what went wrong this time; it is for people, and changes.
{
"type": "https://errors.clavian.io/webhook-signature-invalid",
"title": "Webhook signature not accepted",
"status": 401,
"code": "webhook_signature_invalid",
"requestId": "req_01k5znw4hmfay8vvr14d2pf2db"
}
Endpoints that return it
From the OpenAPI document, every endpoint that names it among its answers:
POST /v1/webhooks/payments/{provider}Receive a payment provider’s webhook