Cash Payouts Reward Statuses | SaaSquatch Documentation

Learn about the PayPal cash payout fulfillment lifecycle and how we assign payout statuses to individual rewards.

SaaSquatch’s integration with PayPal lets you reward referral program participants who live in eligible countries with cash in any currency supported by PayPal. For more information about cash payouts, check out our feature overview or our setup instructions.

🔗 Fulfillment lifecycle

When a participant earns a reward that’s eligible for a cash payout, their reward is added to a currency-specific batch. Each batch can contain up to 500 payout items. For each payout date, we can send a maximum of 15,000 payout items to PayPal, across all batches.

On the scheduled payout date, each batch is sent to PayPal for processing. PayPal will then attempt to pay out each item. Based on the information SaaSquatch receives from PayPal’s webhooks, we will update the status of each reward in the Admin Portal to show whether it was successfully redeemed.

Cash payout reward fulfillment cycle

Example: Your cash payouts are scheduled for the 15th of each month. This month, your participants have earned rewards in three currencies: GBP, CAD and USD.

On the 15th, we will send a separate payout batch to PayPal for each of the reward currencies. PayPal will process the batches and send us webhooks with a reward status for each item. We use this reward status information to update what you see in three places:

On the participant’s profile in the Admin Portal
In the Reward Details report
In the Payout History section of the PayPal integration dashboard

🔗 Reward statuses

PayPal has several different statuses that can apply for a payout item: success, pending, unclaimed, on hold, refunded, returned, denied, blocked, or failed. SaaSquatch gets information about the PayPal status of each individual payout item from PayPal’s webhooks. Most statuses don’t require client action, but a few do, as shown below.

PayPal Status	Meaning	Required action
Success	Reward was successfully paid out by PayPal and marked as redeemed in SaaSquatch.	N/A
Pending	PayPal is currently processing this item	N/A
Unclaimed	The participant provided an email address that doesn’t map to an existing PayPal account, or PayPal paid this item out to an account that does not exist.	The participant will need to register with PayPal using the email address they originally supplied and then accept the transfer. PayPal will send them an email notifying them of the available balance.
On hold	This payment is on hold by PayPal. The hold may have been initiated by either PayPal or the client.	Wait, or investigate why the payment is on hold and fix.
Refunded	The payout item was refunded.	Check with PayPal for details. Payout refunds are typically initiated by clients.
Returned	This payout was returned because it was unclaimed for more than 30 days.	Contact the participant to confirm their PayPal information and investigate why they did not claim the reward.
Denied	PayPal denied the payout because the action is not supported for this user (for example, sending money to a person in a country that PayPal doesn’t service).	Check with PayPal to understand the reason the payout was denied.
Blocked	This payout was blocked by PayPal	Check with PayPal to understand the reason for the block.
Failed	The reward failed to be paid out.	No client action required. We will retry the reward once per day for three days. If the payout still isn’t successful, then we’ll try again during your next scheduled payout.