Webhooks
Receive events from transactions updates
Our Webhook system provides updates on the status of transactions, ensuring seamless integration with your application. This system sends HTTPS
POST requests to a specified URL
.
Creating webhooks
To create a webhook, head to the dashboard, select the project and create your webhook.
Events
The webhook will be triggered for every asynchronous status change.
Called when the transaction first enters the awaiting_funds
status from
processing
. The second call will be triggered when the transaction moves
from awaiting_funds
to success
or failed
.
Webhook payload
Here is an example of the payload delivered to your webhook URL when using both on-ramp and off-ramp:
Security
The API signs the event by adding a X-Hub-Signature
header to the request. This signature can be used to verify the authenticity of the request by following the steps below:
First Step
Go to the webhook settings page and copy the secret.
Second Step
Compute an HMAC-SHA256
hash of the payload using the secret as the key
and the stringified payload as the message. The decoding algorithm is
hex
.
Third Step
Compare the generated signature with the one received in the
X-Hub-Signature
header.