PayPal Mass Payments lets you pay multiple affiliates at once using a simple CSV file export from Affonso. This guide walks you through the entire process — from generating payouts to completing bulk payments in PayPal.
Before You Start
Prerequisites
-
Pending payouts in Affonso — Payouts are either generated automatically based on your program settings, or you can manually generate payouts for custom date ranges.
-
PayPal Business account — Mass Payments (Payouts) requires a PayPal Business account with Payouts enabled. Personal accounts cannot send mass payments.
-
Sufficient PayPal balance — You must have enough funds in your PayPal balance to cover all payments. Mass payments can only be sent from your balance, not from a linked bank account or card.
Step 1: Export PayPal Payouts from Affonso
- Go to your Payments dashboard
- Select the Pending tab to view all open payouts
- Click Export and choose PayPal
- A CSV file will download containing all affiliates who have PayPal as their preferred payment method
The exported file includes:
- Email addresses of recipients
- Payment amounts
- Currency codes
Step 2: Set Up PayPal Payouts
If you haven't enabled Payouts on your PayPal Business account yet:
- Log in to your PayPal Business account
- Go to Business Tools → Make Payments
- Under "Make payments", click Payouts
- Complete the onboarding process to enable mass payments
Step 3: Process the Mass Payment
- In your PayPal account, click Pay & Get Paid
- Under "Make payments", select Payouts
- Upload the CSV file exported from Affonso
- Review all recipients and payment amounts
- Confirm and send the payments
Important Notes
- Currency matching: Your PayPal balance and the mass payment file must be in the same currency. If paying in multiple currencies, create separate files for each.
- Maximum recipients: Each mass payment can include up to 5,000 individual payments.
- Fees: PayPal charges 2% of the total transaction amount (capped at a maximum fee) for Payouts Web uploads, or a flat $0.25 per transaction via API.
Step 4: Mark Payouts as Paid in Affonso
After successfully sending payments through PayPal:
- Return to your Payments dashboard in Affonso
- Select the payouts you just processed
- Mark them as Paid
This updates your records and shows affiliates that their payment has been sent.
Troubleshooting
"Denied" Status in PayPal
If your mass payment shows as "Denied", check that:
- You have sufficient funds in your PayPal balance
- All email addresses in the file are valid
- The currency matches your balance currency
Recipients Without PayPal Accounts
If a recipient doesn't have a PayPal account, PayPal will notify them via email to claim the payment. Unclaimed payments are automatically returned to you after 30 days.
Prefer Hands-Off Payouts?
Don't want to manage PayPal exports and payments manually? With Managed Payouts on the Growth or Elite Plan, Affonso handles everything — you pay one invoice, and we distribute funds to all your affiliates worldwide.
Need help with PayPal mass payments? Contact our support team for assistance with exports or troubleshooting.


