Overview

Webhooks let Walley notify your system the moment something happens, instead of you polling for changes. Register an HTTPS endpoint, choose the events you care about, and Walley calls your endpoint when they occur.

Events

Events are grouped into four categories. Each page lists the event types in that category, with payload examples and when they are triggered.

🎫 Customer Tokens

Follow a stored payment token through its lifecycle: active, pending, suspended, cancelled, denied or revoked.

🔐 Authorizations

Track tokenized payment authorizations from created to authorized, and get the reason when an attempt is retried or fails.

📦 Orders

Know when an order is created, authorized, captured, refunded, canceled or expired, no matter which Walley product created it.

💰 Settlements

Get notified the moment a new settlement is ready, so you can fetch the report through the Reports API right away.

Start here

1. Receiving webhooks covers what your endpoint must support, what the requests look like, how retries work, and how to verify each request with HMAC.
2. Webhook management in Merchant Hub is where you create your webhooks, choose events and stores, and test the configuration before going live.
3. Pick your events from the categories above and subscribe to them when you create the webhook.