Promo Abuse Integration

Integration Process

This page explains the promo abuse integration process.

Our dedicated guides will help you to integrate with Ravelin seamlessly. The Ravelin team will help you through the integration from start to finish. We will work with you to understand how your platform and Ravelin can best work together to stop promo abuse, reduce loss and support growth.

  1. Enable promo abuse recommendations
    Speak to your account manager to enable promo abuse recommendations and the Voucher Assessment checkpoint on your account.

  2. Send customer and device data
    Use the Ravelin JavaScript library or mobile SDKs to collect device data. Use the same customerId and deviceId values across all your requests to Ravelin.

  3. Register referral vouchers
    If you run a referral programme, register each referral code with Ravelin when a customer creates it.

  4. Check the voucher is valid
    Confirm the code meets your campaign terms before requesting a recommendation.

  5. Request a recommendation
    When the customer enters a code, send a request to our Voucher endpoint using the Voucher Assessment checkpoint. Add score=voucherAssessment as a query parameter to the URL.

  6. Apply or reject the voucher
    Apply the discount on ALLOW. Reject the code on PREVENT.

  7. Send voucher redemptions
    Each time a voucher is redeemed, send the redemption to Ravelin. If the voucher is redeemed on an order, send it to the Payment Method Voucher endpoint or include it in your Checkout request. If it is redeemed outside checkout, for example when credit is added to the customer’s account, send it to the Payment Method Voucher endpoint.

  8. Test and go live
    Test your handling of each recommendation in your sandbox account before going live.

Next steps

Register referral vouchers

Request a promo abuse recommendation

Feedback