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
34 February 2012 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.