Register Webhook | Wallib

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.

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.

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

messagestring

webhookUrlstringformat: "uri"

webhookSecretstring

$	curl -X POST https://third/v1/provider/webhook \
>	-H "x-api-key: {{X_API_KEY}}" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"url": "https://develop.provider.com/webhook"
>	}'

Headers

Request

Response headers

Response