Skip to navigation

Register Webhook

View as Markdown

Registers a webhook URL to receive real-time transaction status notifications.

Once registered, Wallib will send POST requests to the specified URL whenever a transaction changes state. This allows your system to react to events such as payment completion, failure, or expiration without polling.

Authentication: Bearer token ({{JWT_LOGIN}}) + x-api-key header.

Key body fields

  • url: The publicly accessible HTTPS endpoint that will receive webhook event payloads.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

x-api-keystringOptional

Request

This endpoint expects an object.
urlstringRequiredformat: "uri"

Response headers

x-amzn-RequestIdstringOptional
Access-Control-Allow-OriginstringOptional
x-amz-apigw-idstringOptional
X-Amzn-Trace-IdstringOptional

Response

OK
messagestring
webhookUrlstringformat: "uri"
webhookSecretstring