User Guide
Table Of Contents
- Mass Payments User Guide
- Contents
- Preface
- Mass Payments Overview
- Using Mass Payments in Your PayPal Account
- Using the Mass Payments API
- Mass Payments Reporting
- About Mass Payments Reporting
- Using the Reports Dashboard to Review Mass Payment Transactions
- Using Account History to Review Mass Payment Transactions
- Viewing Transaction Logs
- Downloading History Logs
- Receiving Instant Payment Notifications for Mass Payments
- Using the Settlement Report and the Transaction Detail Report
- Best Practices and FAQs for Mass Payments
- Mass Payments FAQs
- Is there a fee to send Mass Payments?
- How much money can I send?
- What countries can receive Mass Payments?
- Can I send money in different currencies?
- How do I confirm the receipt of payments?
- How do I cancel an individual payment?
- A recipient told me that payment was not received. What could be the problem?
- What does it mean if a mass payment is “Processing, Denied, Processed or Completed” in my transaction history?
- Mass Payments FAQs
- Currencies and Currency Codes
Mass Payments User Guide January 2013 3
Contents
Chapter Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
About This Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Documentation Feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Chapter 1 Mass Payments Overview . . . . . . . . . . . . . . . . . . 7
What is Mass Payments? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Mass Payments Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
How Do Recipients Get Their Money?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Who Can Use Mass Payments? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Offering PayPal as a Payout Option On Your Site . . . . . . . . . . . . . . . . . . . . . . . 8
Chapter 2 Using Mass Payments in Your PayPal Account . . . . . . .11
The Mass Payments Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Creating the Payment File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Payment File Contents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Preparing the Payment File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Accessing Mass Payments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Uploading a Payment File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Uploading the Mass Payments File (Reports Subtab Present) . . . . . . . . . . . . . 15
Uploading the Mass Payments File (No Reports Subtab) . . . . . . . . . . . . . . . . 16
Reviewing Transaction Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Reviewing Transaction Details (Reports Subtab Present). . . . . . . . . . . . . . . . 17
Reviewing Transaction Details (No Reports Subtab) . . . . . . . . . . . . . . . . . . 18
Payment Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Chapter 3 Using the Mass Payments API. . . . . . . . . . . . . . . .21
Calling the MassPay API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
MassPay API Using SOAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
SOAP MassPay Request Message . . . . . . . . . . . . . . . . . . . . . . . . . . . 22