PayPal

Pay affiliates via PayPal Mass Payments — fast, low fees, and automated.


Why PayPal?

  • Batch payments — Pay hundreds of affiliates in one transaction

  • Lower fees — 2% capped at $1 per payment

  • Instant — Affiliates receive funds immediately

  • Global — Works in 200+ countries


Setup

Step 1: Create PayPal App

  1. Log in with your PayPal Business account

  2. Click Apps & Credentials

  3. Click Create App

  4. Name it "PromoteBoost" (or anything)

  5. Select Merchant as the app type

  6. Click Create App

Step 2: Get Credentials

On the app page:

  1. Copy your Client ID

  2. Click Show next to Secret and copy your Secret

  3. Make sure you're in Live mode (not Sandbox)

Step 3: Enable Payouts API

  1. Scroll down to Features

  2. Find Payouts

  3. Click Enable

  4. You may need to complete additional verification

Step 4: Connect in PromoteBoost

  1. Go to Settings → General

  2. Find PayPal section

  3. Enter your Client ID and Secret

  4. Click Save


Sending Payouts

Manual Payout

  1. Go to Payouts

  2. You'll see all approved commissions

  3. Select affiliates to pay (or select all)

  4. Click Generate Payout

  5. Review the summary

  6. Click Confirm & Send

What Happens

  1. PromoteBoost creates a PayPal batch payout

  2. PayPal processes each payment

  3. Status updates automatically via webhook

  4. Affiliates receive funds instantly


Batch Payouts

PayPal processes all payments in a single batch:

Benefit
Description

Efficiency

Up to 15,000 payments per batch

Cost

One batch fee vs individual fees

Speed

All processed simultaneously

Tracking

Single batch ID for all payments


Fees

PayPal charges fees for payouts:

Type
Fee

Domestic (same country)

2% (max $1 per payment)

International

2% + currency conversion

Who pays? You (the merchant). Affiliates receive the full amount.

Example:

  • Commission: $100

  • PayPal fee: $1

  • You pay: $101

  • Affiliate receives: $100


Currency

Your Currency

Payouts are sent in your account's default currency (set in Stripe).

Affiliate's Currency

If an affiliate is in a different country:

  • PayPal handles conversion automatically

  • Standard PayPal exchange rates apply

  • Affiliate receives local currency

Supported Currencies

USD, EUR, GBP, CAD, AUD, JPY, CHF, SEK, NOK, DKK, and 15+ more.


Payment Status

Track each payout in Payouts → History:

Status
Meaning

Processing

Sent to PayPal, awaiting confirmation

Completed

Affiliate received payment

Failed

Payment failed (see troubleshooting)

Unclaimed

Affiliate hasn't accepted (30 days)

Returned

Returned to you after 30 days


Affiliate Requirements

For affiliates to receive PayPal payouts:

  1. PayPal account — Must have a PayPal account

  2. Verified email — Email must be confirmed

  3. Matching email — Email in portal must match PayPal

How Affiliates Set Up

  1. Log in to affiliate portal

  2. Go to Settings

  3. Select PayPal as payment method

  4. Enter PayPal email address

  5. Save


Troubleshooting

Payment Failed

Error
Cause
Solution

Receiver unregistered

No PayPal account

Affiliate must create account

Receiver unconfirmed

Email not verified

Affiliate must verify email

Invalid email

Typo in email

Affiliate must fix email

Insufficient funds

Your PayPal balance is low

Add funds to PayPal

Unclaimed Payments

If an affiliate doesn't claim within 30 days:

  • Payment is automatically returned to you

  • Commission is reset to Approved

  • You can retry or contact the affiliate

Webhook Issues

If statuses aren't updating:

  1. Go to Settings → Integration

  2. Check webhook status

  3. Click Re-verify if needed


Testing

Use Sandbox First

  1. Get Sandbox credentials

  2. Enter Sandbox credentials in PromoteBoost

  3. Test payouts with fake money

  4. Switch to Live credentials when ready

Test a Real Payout

  1. Create a small commission ($1)

  2. Approve it manually

  3. Send payout to yourself

  4. Verify you received it


Security

  • Credentials are encrypted at rest

  • API calls use HTTPS

  • Webhook signatures are verified

  • No affiliate sees your PayPal credentials


Limits

PayPal Limits

Limit
Value

Payments per batch

15,000

Amount per payment

$50,000

Amount per batch

Unlimited

Your Account Limits

Limits depend on your PayPal Business account verification level. Contact PayPal to increase limits if needed.


Next Steps

Once PayPal is connected:

  1. Have affiliates add their PayPal email

  2. Test with a small payout

  3. Set up Auto-Payouts if desired

Last updated