Genius Referrals


If you are in this section, we are assuming that you've already configured and tested your referral program or deployed your referral program to your production environment, and you want to set your program on autopilot with our PayPal Auto Payout feature.

Who should read this tutorial?

This tutorial is for clients who want to payout their advocates and referrals using PayPal Payouts.


At the end of this tutorial, you should have your referral program ready to send payouts via PayPal. You will have multiple options for setting up your payout system that will allow your program to run in AutoPilot so that you can put your mind at ease.

How to integrate your account with PayPal

PayPal payment gateway will allow you to automatically send payouts to your advocates and referrals.

The first thing you must have to get integrated is a PayPal business account. You must make sure that payments have been enabled in your account. Not all PayPal accounts have this feature enabled automatically, especially if you are outside the United States.

How to obtain the information that is required for the integration?

Log in to the PayPal Developer Portal

Verify that you have the Payouts API enabled. Unfortunately, this can take from a few hours to several days for PayPal to give you permission. We do not have control over this. However, requesting it is very easy. At the bottom of the column called "Permission name", you will see the row labeled "Payouts". You want to click on the Enable link.
My account
PayPal will send you an email informing you that they are reviewing your request. Once you have been accepted, you will see a green checkmark indicating that the API is active.

Then you should go to the "My Apps & Credentials" section and credentials on the menu. Find the "REST API apps" section and click on the "Create app" option.
Rest API apps
Fill in the information of the form by inserting the name of the application, you can write "Genius Referrals Payouts". Once the name is inserted, click on the "Create app" button.
Create new app
Select the "Live" button at the top right and then the "Show" option below the secret header.
Live API credentials
You must copy the Client ID and Secret fields. You need this data for integration with Genius Referrals.
PayPal account details
If you have already completed the steps up to here, and your PayPal account has enabled the Payouts API, then, we are ready to go to the Integration section in Genius Referrals. When accessing the section select Billing Payment where you can find the option to integrate with PayPal.

Setting up the connector

To set up the Paypal connector, log in to your Genius Referrals account, and go to the Integrations-Billing & Payments-Paypal. The page should look like the following image:
PayPal connector
Click on the PayPal logo and the option to create a connection from your Genius Referrals account with PayPal will be shown, to continue you must click on "Connect with PayPal".
PayPal payout configuration for your affiliate program
To complete the integration you must go through the following 3 steps, it is a quick process that will only take a few minutes.


Here you have to insert the information of your PayPal account (Client ID and Client Secret). After inserting the credentials and accepting the terms and conditions, click on the "Save and continue" button.
Insert PayPal credentials

Payout options

This step is very important because here you can configure how you want payouts to be managed and establish the payout limits.
You will have the option to Edit the integration so that you can change these parameters if you want another time.
We offer you a default configuration, when you finish defining the values, click on the "Save and continue" button.

If you want to return to the previous step you have the "Back" button to return to the Connection section.
Set payout option
Finally, if the entire process has been completed correctly, it will go to the confirmation section, where it is explained that the integration must be approved and you will be contacted via email to inform you when the status changes.

It will also have two buttons one to go to the dashboard and the other to go to the integration with PayPal.
Confirmation message
When you return to the integration with PayPal you will see the details of the integration, it shows the status it is in, next to two options Edit and Pause

  • Edit is so you can modify your integration in case you require it.
  • The Pause option will be enabled when its integration is active, this functionality is to give you the possibility to stop payments through PayPal without having to cancel the integration. When you want to resume payments you should only click on the Play button.
Details of the integration with PayPal

Testing the Referral Program Integration

How do I know if the whole thing is working as expected? To make sure that everything is working okay we are going to run the following scenario:

Scenario: Recommending new potential clients to your gallery

In this scenario, we are assuming the following:
  1. You have a gallery where you sell his artwork online.
  2. You have implemented a referral program with Genius Referrals to allow your customers and visitors to refer your products to friends, family, colleagues, etc.
  3. On your referral campaign, you are giving $10 to your customers for every qualified referral. A qualified referral is a referral that completes a purchase.
  4. John Smith is one of your best customers that loves your products and is happy to share your services with his friends, family, colleagues, etc. This is his personal data:
    1. First Name: John
    2. Last Name: Smith
    3. Email:
  5. John refers to his friend Matt so he can buy new works in your store. This is his personal data:
    1. First Name: Matt
    2. Last Name: Hanks
    3. Email:
  6. John receives a $10 bonus once Matt has completed a purchase
Testing that John can share services anywhere he wants For John to be able to refer products he needs to access the referral program page and use the referrals tools to share the services. John will be able to use all the tools on the "Referral tools" tab. In this scenario, John sends Matt his personal URL (referral tool 2) so that Matt can check out the products and become a customer.

Your referral program
Testing that the referral (Matt) has been successfully created Once John has shared the services with Matt, Matt will click on John's share link and will land on your store. Matt will browse your product, add some to the cart and finally pay for the products. Once Matt has completed a purchase, a new referral will be generated on Genius Referrals. To check if the new referral has been created, go to your advocate's section on Genius Referrals. You should be able to see Matt on the list.
List of members
Testing that a bonus is given to John once Matt has completed a purchase Now we need to check if the advocate (John) receives a bonus once the referral (Matt) completes his purchase. To test this, Matt has to complete a purchase, once a purchase is completed John should receive a $10 bonus on Genius Referrals.

To check if the bonus was given to the advocate on Genius Referrals, go to your bonuses section. You should be able to see John's new bonus on this page.
List of bonuses
Testing Auto Payout configuration To ensure that the system processes payouts automatically. You must configure the Payout Options parameters in step 2.

  • Payout Management: Auto (When a bonus is given, it is redeemed automatically. A new payout request is created and redeemed.)
  • Payout frequency: On request (When a payout request is created, the system process it immediately.)
With this setup, the system will try to redeem bonuses automatically. To this end, a new payout request is created and redeemed.
Configuration to make the automatic payout
To review redemption requests, access the Bonus Payouts section
List of the payout requests
On the details page, you can see the status of the transaction and if the payout was completed, in the description you can check the Transaction ID.
Redemption request details
You can also check on your PayPal account and see all the payouts that have been made to your advocates.
Activities of your account
Transaction details
Transaction details
When the payout request is completed the advocate will receive the payout on his PayPal account.
Payout details of the advocate
That is all. In this scenario, each time a (Matt) completes a purchase in your gallery, the advocate (John) will receive a new bonus that can be exchanged manually or automatically according to the configuration you've set up.


What happens if the system didn't process the payout?
You should receive an email with the reasons why the payout was not successfully processed.

How do I check payouts?

Access to the payouts sections, find and open de details of the request. On Paypal check your activity or search for the transaction ID.

The payout request is stuck on Hold, what should I do?

This means that the system couldn't process the request as one of the validations failed. Check your email and look for the reason why the redemption failed and follow the steps on the email to fix this issue. Usually, you just need to move the request to the processing status.