Webhooks FAQs

Which transactions trigger notifications to be sent?

Webhooks are sent for all of the transaction types listed under All Webhooks Name Reference. However, if a payout is scheduled and there are insufficient funds to generate a payout, no payout notification is sent.

How can I resend a webhook for a specific order?

To resend an webhook notification, go to the relevant order record in the Merchant Portal (under Transactions > Find a Transaction in the left menu). In the Resend menu, select Webhook and then click Send.

What happens if the webhook fails?

If BlueSnap does not receive a confirmation that you received the webhook, we make up to 11 attempts to resend it. After the 11th attempt, we send an "Webhook Failure" email to the "contact" email on record.

If I have an order for multiple contracts, is a single webhook sent or one for each contract?

A single webhook is sent per order.

What do I need to do to prepare my system to receive the notifications?

You must set up a URL where the webhooks can be sent and then enable webhooks in your BlueSnap account.
Refer to Setting up Webhooks.

How can I simulate webhook requests so I can debug for any potential issues?

You can simulate an webhook by placing a test order and having the webhook emailed to you. It's also possible to generically test webhooks using the webhook simulator found in the Merchant Portal under "general settings".
Refer to Simulating a webhook for testing/troubleshooting.

Do I need webhooks if I am integrating with BlueSnap via the API?

In you are using the BlueSnap API, you get information about transaction events via the usual API responses. However, there is no API call involved for offline events such as disputes, chargebacks, and subscription cancellations; you need webhooks to get information about those events.