Webhooks & Notifications
Webhook events are messages that describe certain business events that occur within Wise's system. For example, an event may describe a change in the status of a transfer you have made.
Events that are related to your Wise resources can be sent to your server as HTTP
POST requests. You can start receiving events by creating webhook subscriptions using the Wise Platform API or website interface.
Subscriptions specify what type of event should be sent, and what server location the event should be sent to.
Webhooks Subscription Types
Application webhook subscriptions are a mechanism that will allow you to receive notifications to your servers whenever various events happen in relation to different resources created by an application.
Profile webhook subscription is a mechanism that will allow you to receive notifications to your servers whenever various events happen in relation to different resources created under a specific profile.
Before proceeding, make sure the endpoint where you intend to receive webhooks satisfies the following requirements:
- Has a valid domain name (IPs are disallowed)
- Listens to HTTPS requests on port
- Has a valid HTTPS certificate signed by a trusted Certificate Authority - CA (self-signed or expired certificates are not accepted)
- Does not include any query arguments in the URL
https://webhooks.example.com/balance-change is a valid URL;
http://webhooks.example.com:8080/hook.php?type=balance is not.
You can have multiple subscriptions per event type though be mindful you will receive duplicate callbacks, one for each subscription.
There are two ways you can manage profile webhooks:
- via API (read more below)
- via user interface (go to your settings page)
Creating Webhook Subscriptions
Application and profile level webhooks are subscribed to using your APi token. Please see the full API reference on Webhooks for more information on how to create, manage, and view webhook subscriptions.