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 Reporting
Receiving Instant Payment Notifications for Mass Payments
4
32 January 2013 Mass Payments User Guide
Processed IPN
PayPal sends the Processed IPN when the payments are taken out of the payer account.
For each payment, PayPal generates and returns a unique transaction ID in the
masspay_txn_id variable. For each payment, PayPal also returns the unique_id value.
The unique ID parameter in the MassPay API call is from your tracking system. This
parameter is optional.
PayPal also generates a status for each payment. The status can be Completed, Failed,
Reversed, or Unclaimed. For descriptions of the status values, see “
IPN Variable Reference” in
the
Instant Payment Notification Guide.
The following is a sample Processed IPN. Notice that txn_type is masspay,
payment_status is Processed, and status_2 is Unclaimed in this case because the
recipient has not yet set up a PayPal account.
payer_id=HZU8ZEBYHLEZQ&
payment_date=09%3A01%3A16+Dec+21%2C+2006+PST&
payment_gross_1=25.99&
payment_gross_2=9.99&
payment_status=Processed&
receiver_email_1=fred@unknowncompany.com&
receiver_email_2=john@fictionalcompany.com&
charset=windows-1252&mc_currency_1=USD&
masspay_txn_id_1=5W531651W5136225N&
mc_currency_2=USD&
masspay_txn_id_2=8P09425963946233T&
first_name=Robert&unique_id_1=12345&
notify_version=2.1&unique_id_2=45678&
payer_status=verified&
verify_sign=AB5URHwIzIbcANTQUdSveiWRw8-WACTmrKK-dops2Tb6KKAQnpUJyF.l&
payer_email=robert@hisowncompany.com&
payer_business_name=His+Own+Company&
last_name=Moore&
status_1=Completed&
status_2=Unclaimed&
txn_type=masspay&
mc_gross_1=25.99&
mc_gross_2=9.99&
payment_fee_1=0.52&
residence_country=US&
payment_fee_2=0.20&
test_ipn=1&
mc_fee_1=0.52&
mc_fee_2=0.20
NOTE: Line returns were added to improve readability.