Payout Fraud Integration

Payout Fraud

  • Overview

    What is a Payout?

    A payout, or a disbursement, is a payment made from a platform to a supplier on that platform. Examples include:

    • Daily/weekly payment to a taxi driver on a taxi app of earnings less fees
    • Payment of royalties to a rights holder on a music platform
    • Ad revenue sharing payments to creators on a social media platform

    What is payout fraud?

    Payout fraud occurs when suppliers in marketplaces and online platforms manipulate the system to create fake revenue. They might commit money laundering, sidestep financial regulations, form fraudulent networks with other suppliers, bypass Know Your Customer (KYC) checks, and ultimately harm your business financially and legally.

    Read More
  • Requesting Recommendations

    In this section, you’ll find information on how to send payout data to Ravelin to obtain recommendations. Using these recommendations, you can decide whether to allow or block a payout to its recipient.

    How to request recommendations

    To request a recommendation before paying out to a recipient, send a request to our Payout endpoint using the Payout checkpoint.

    To use the Payout checkpoint, add score=payout as a query parameter to the URL.

    Read More
  • Sending Updates

    When to send updates

    Keeping us informed about each payout attempt’s outcome is not just beneficial for us; it helps tailor our fraud prevention models to fit your unique business needs more precisely. By doing so, you ensure that our system reflects your actual operations, leading to more accurate recommendations and, ultimately, a more secure and efficient payout process.

    • After receiving a recommendation
      Once you’ve acted on our recommendation (resulting in the payout being processed, blocked, or cancelled) updating us with the taken action is crucial. This feedback is instrumental in refining and improving the rules and models tailored to your business operations.
      If the payout is being processed, update the status accordingly:

      Read More
    • Testing Your Integration

      After completing integration you should test that you correctly handle our payout recommendation responses.

      Forcing specific recommendations

      To test your integration we allow you to send specific requests to force specific recommendations to be returned.

      You should then ensure that you handle each of the possible recommended actions correctly.

      These test recommendations are only supported in your sandbox account. See our Authentication guide for how to use your sandbox account.

      To force us to respond with specific recommendations send a request to the Payout endpoint and set the supplier.email field to an email address with one of the email domains shown below.

      Read More

    Feedback