Marketplacer has recently upgraded the Integration with Braintree to support Braintree’s native Fraud Protection Advanced tool.
This feature applies Braintree’s machine learning logic to evaluate card transactions and help protect your business from payment fraud.
Through the capture and analysis of a multitude of data points from customer devices and transactions, Fraud Protection Advanced is built to provide more accurate fraud scores that help merchants identify and reject transactions highly suspected for fraud, while also avoiding over-blocking likely good transactions in the process.
Once enabled, all orders flagged as potentially fraudulent in Braintree will come through to Marketplacer with the status "pending review". Those orders will not be visible to sellers until they have been approved in Braintree and the order status has been updated in Marketplacer accordingly via the webhook (see below for further details).
Operators will receive an email alert as soon as a new order with status “pending review” is created. This email is sent to the “Accounts Email Address” as specified in the operator portal in Configuration > Site Details.
Setup Instructions
- Enable Braintree advanced fraud protection in Marketplacer. Go to Configuration > Payment Methods.
Select E-Commerce > Braintree. - Enable Braintree advanced fraud protection in operator portal.
- Login to your Braintree account. Follow these instructions to setup a webhook in Braintree.
At the create webhooks screen, enter https://YOUR-DOMAIN/webhooks/braintree replacing your website address for the YOUR-DOMAIN text (for example https://www.marketplacer.com/webhooks/braintree) as the URL. Check Transaction Reviewed and select Create Webhook.
Testing Instructions
- Once the above have been setup, make a purchase on your site using a Braintree credit card. Use the credit card number provided by Braintree to simulate a transaction that is pending review, which you can find here.
- Verify that the order status is Pending Review in Marketplacer.
- Go to the transaction in the Braintree dashboard.
- Under the Premium Fraud Management Tools Information section, click the Fraud Provider Transaction ID. That will take you to a PayPal dashboard where you can approve the transaction.
- In the top right, click Decision. Then select Approve or Reject.
- Braintree will send a webhook request to the Marketplacer server. If the decision is approved, the order status should switch to Complete on our end and the transaction Submitted for Settlement on Braintree’s end. If rejected, the order status should switch to Payment Failed on our end and the transaction Voided on Braintree’s end.
A note that this relies on a background worker to process the webhooks. As such there may be some issues validating this in a testing environment and we might need to manually trigger this from the console for testing purposes.
Customers will not receive tailored communication when an order is under review. There is also no email communication when an order is rejected. This is up to the operator to decide how to follow up with the customer.