Premium Fraud Management Tools
Webhooks
Availability
Fraud Protection webhooks are only available for merchants using Fraud Protection Advanced. For an
overview on available Fraud Tools, see our
Support article. If you are using standard Fraud Protection instead of Fraud Protection Advanced, you can skip
this step and proceed to our
Testing & Go Live Page
to complete your integration.
- Fraud Protection to be notified when a transaction marked for review has been approved or rejected
- Dispute Opened to compare opened disputes with your transactions sales and create a report on your chargeback ratio
- Disbursement to create a funding report
General workflow
- Set up at least one destination URL to receive webhooks from the gateway
- Parse the contents of the webhook notifications
-
Create logic to store the details of the
WebhookNotificationobjects for a specific kind of trigger
Fraud Protection
When a transaction has been formally reviewed in the Fraud Protection Advanced dashboard, we'll send
a TRANSACTION_REVIEWED webhook containing information that you can use to update your
records:
- Python
def webhook():
webhook_notification = gateway.webhook_notification.parse(
str(request.form['bt_signature']),
request.form['bt_payload']
)
# Example values for webhook notification properties
print(webhook_notification.kind) # "transaction_reviewed"
print(webhook_notification.transaction_review.transaction_id) # "123abc"
print(webhook_notification.timestamp) # "Sun Jan 1 00:00:00 UTC 2012"
return Response(status=200)- Python
transaction = gateway.transaction.find("the_transaction_id")