# PayPal

{% hint style="info" %}
**Note:** The PayPal integration is only available to users on the LoyaltySurf Business plan or higher. The following countries and currencies are supported [here](https://developer.paypal.com/docs/payouts/standard/reference/country-feature/).
{% endhint %}

### **Description** <a href="#description-1" id="description-1"></a>

When a LoyaltySurf participant unlocks a reward, send them a one-time PayPal payout. The payout will be sent to the LoyaltySurf participant's email address.

### Fee Disclosures <a href="#how-to-set-up-1" id="how-to-set-up-1"></a>

* The following fees are applied on payouts made through PayPal's API:
  * United States: USD 0.25 per U.S. transaction
  * International: 2% of the recipient payment amount, up to a certain amount
* Individual payments cannot exceed USD 20,000.
* No fees are charged to the recipient.

### **How to Set Up** <a href="#how-to-set-up" id="how-to-set-up"></a>

To utilize the PayPal payout feature, you'll need the following (full PayPal payout instructions can be found [here](https://developer.paypal.com/docs/payouts/standard/)) before setting up:&#x20;

1. A PayPal business account (you can [sign up for a PayPal business account here](https://www.paypal.com/bizsignup/))
2. Get [access to PayPal Payouts](https://www.paypal.com/payoutsweb/landing?_ga=1.173127584.2099703533.1638980894)
3. A confirmed [identity](https://www.paypal.com/policy/flow/verifyCip?_ga=1.118076554.2099703533.1638980894), [email](https://www.paypal.com/settings/email/confirm), and [bank account linked to your PayPal business account](https://www.paypal.com/businessexp/money/addbank)
4. Sufficient funds in your PayPal business account (make sure to cover enough for payout totals and fees)
5. When you connect to PayPal within LoyaltySurf, make sure to login with your primary PayPal account holder's credentials. Using a team member's PayPal credentials can result in permission issues when sending out payouts

{% hint style="info" %}
You must first select a default currency for your LoyaltySurf campaign in order to use PayPal.&#x20;
{% endhint %}

**Step 1**: In *Campaign Editor > 4. Options > Integrations*, click the *Connect to PayPal* button

<figure><img src="https://3285719719-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTwFF4MDnpq2eL5eyOdtK%2Fuploads%2F1ASXBg6vpzymVmwiEEgb%2FScreen%20Shot%202023-01-13%20at%203.35.55%20PM.png?alt=media&#x26;token=fa7f7f8e-8606-41a8-925d-885bea8d570f" alt=""><figcaption></figcaption></figure>

**Step 2:** Once connected, press the 'Connect A Reward' button and select your reward.

<figure><img src="https://3285719719-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTwFF4MDnpq2eL5eyOdtK%2Fuploads%2FgHAzoaexQ2lMl05kAHlO%2FScreen%20Shot%202023-01-17%20at%204.58.52%20PM.png?alt=media&#x26;token=61696e37-190f-4b31-83a7-7e143978c5ba" alt=""><figcaption></figcaption></figure>

**(Optional) Step 3:** Add a customized email subject and message to the PayPal payout by toggling the *Show advanced payout settings* section.

{% hint style="info" %}
**Advanced feature tip: Issue different reward amounts by using dynamic rewards**

Dynamic rewards let you offer different reward values based on specific attributes of the participant (such as the pricing plan they signed up for).

For example, you can issue $50 payouts for normal users and $100 payouts for VIP users.

[Learn more →](https://support.loyaltysurf.io/article/437-how-to-set-up-dynamic-rewards)
{% endhint %}

<figure><img src="https://3285719719-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTwFF4MDnpq2eL5eyOdtK%2Fuploads%2FN5yVzZAamhaoACyhjhFU%2FScreen%20Shot%202023-01-17%20at%205.13.58%20PM.png?alt=media&#x26;token=d496c772-aaee-49bb-81ef-682e3214640e" alt=""><figcaption></figcaption></figure>

Step 4: Then hit Save. Now, anytime this reward is unlocked by a winning participant, a PayPal payout will be sent to the PayPal customer associated with the LoyaltySurf participant email address. If enabled, on their first payout, the participant will receive a confirmation email so they can choose the PayPal email address they want to use.

### Troubleshooting Tips

If there is an issue with PayPal payouts being out to winners, LoyaltySurf will send out a notification email to the campaign owner. The issue will also be stated in the participant's detail page when you view their reward or when you view the participant's activity logs.

Here are some common reasons why there may be failures:

* There may be an issue with your PayPal account. For payouts to work, you must have a verified business PayPal account with access to PayPal payouts and sufficient funds. [View the requirements](https://docs.loyaltysurf.io/integrations/paypal#how-to-set-up).
  * Make sure that the account you connected to PayPal within LoyaltySurf is your primary PayPal account holder. Using a team member's PayPal credentials can result in permission issues when sending out payouts.
* If dynamic reward rules are enabled for the PayPal reward, there may have been no matching rule found.
* If you're not seeing a PayPal confirmation email being sent out (which is sent when a participant first unlocks their first PayPal payout), you must first approve the reward. This only applies if you have manual reward approval enabled for your campaign.

If there was a failure, you will need to manually issue the payout from your [PayPal dashboard](https://paypal.com/myaccount/transfer/homepage/pay).

#### **How to confirm if a payout was sent:**

1. Go to your [PayPal Transactions History](https://www.paypal.com/unifiedtransactions/?filter=0\&query=) page to view all transactions

{% hint style="info" %}
You can disregard the "Mass Payment" items. They are not duplicate payments, but rather records of GrowSurf's usage of the PayPal API to send out payouts via Mass Pay.
{% endhint %}

<figure><img src="https://3285719719-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTwFF4MDnpq2eL5eyOdtK%2Fuploads%2F4xJfDUnw83rTTRciDMZ8%2Fimage.png?alt=media&#x26;token=d5b95971-7d6e-43b2-9f12-2af592ea0c9d" alt=""><figcaption><p>PayPal Transactions History</p></figcaption></figure>

2. Click "Filter", select "Payments sent" for "Transaction type", then click "Apply Filters". You can now browse the list to confirm if payouts were sent out to LoyaltySurf participants.

<figure><img src="https://3285719719-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTwFF4MDnpq2eL5eyOdtK%2Fuploads%2FeXzQ8w8ZAOf8HsRtWsU6%2Fimage.png?alt=media&#x26;token=5cd0f43e-2b1a-49ca-8b03-93be76c6bc2e" alt=""><figcaption><p>Filter transactions</p></figcaption></figure>

#### Other notes:

* If the LoyaltySurf participant does not have a PayPal account (or if it is unconfirmed), they will receive an email from PayPal notifying them to sign up for one or to confirm their account.
* If you have manual reward approval enabled for your campaign: PayPal payouts will only be issued to the winner(s) only after you approve the reward.
* If the loyalty action was triggered recently (or if the reward was approved recently), please allow for a few minutes of server processing before viewing the participant's reward from your LoyaltySurf admin dashboard. During this time, the data displayed for the participant's reward may not be accurate.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.loyaltysurf.io/integrations/paypal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.