Best Practices and FAQs for Mass Payments

Note: The MassPay API is Deprecated as of September 1, 2017. For new integrations, see the Payouts Overview.

Mass Payments FAQs

Is there a fee to send Mass Payments?

PayPal charges the sender a percentage of each payment with the fee capped at a set amount in your primary currency. Mass payment recipients pay no fee regardless of the type of PayPal account they have.

To see the fees charged for a specific Mass Payments transaction, look in the Transaction Details page for the specified transaction. For more information on viewing transaction details, see Use the activity page to review Mass Payment transactions.

How much money can I send?

There is no limit on the total amount of the mass payment. In the U.S., each individual payment can be no more than $10,000.00 USD. For accounts in other countries, the maximum individual payment varies according to the payments standard sending limit.

Which countries can receive Mass Payments?

Mass Payments are supported in over 150 countries in over 20 currencies. Note that currency restrictions do not allow conversion of Argentine Pesos, Brazilian Real, or Malaysian Ringgit. PayPal currency conversion rates apply should the sender or the recipient choose to convert the payments. For more information, see the Mass Pay Integration Guide.

Can I send money in different currencies?

Yes, but you must make separate payment files for each currency.

If you choose to send one currency to a number of different countries, your recipients will have the option to convert the money into their selected currency.

Argentina, Brazil, and Malaysia have restrictions on how their currency can be used or exchanged. PayPal account holders in these countries should make sure that their payment file entries comply with these restrictions. For more information about currency restrictions, see Countries with Currency Restrictions.

How do I confirm the receipt of payments?

PayPal sends you a notification email after each Mass Payment request completes. You can also log in to your PayPal account to check the status and review the details of each transaction using either of the following two methods:

For complete information on Mass Payments reporting, see: Mass Payments Reporting.

How do I cancel an individual payment?

You can only cancel payments that have an unclaimed status. Unclaimed payments will automatically expire in 30 days, and PayPal will return the money to your PayPal account.

To cancel an unclaimed payment:

  1. Log in to your PayPal business account at and view your recent activity by clicking Activity at the top of the page, then scroll down to the Activity list.
  2. Directly above the list, enter the email address of your recipient and make sure that Email Address is selected in the Search for transaction dropdown menu.
  3. Adjust the date range and click Search. Your recipient's payment appears in the list.
  4. From the list, click on the title of the payment you want to cancel. The Details page for the specified item opens.
  5. Select Cancel and follow the instructions.

A recipient told me that payment was not received. What could be the problem?

Here are a few possible explanations:

  • Incorrect email address: Verify your recipient's email address. If the email address is incorrect, you can cancel an unclaimed payment and resend the payment.
  • Recipient has an unconfirmed email address: Your recipient cannot receive a payment with an unconfirmed email address. Ask your recipient to confirm the email address with PayPal. Once that's done, the payment should appear in the recipient's PayPal account within a few minutes.
  • Recipient did not receive the payment email: Sometimes PayPal emails get redirected to a recipient's spam folder. If this is the case, the recipient can simply log in to PayPal to view the payment. Also, double-check the email address in your Mass Payments file. There could be a misspelling or a formatting problem.

What are the possible states for a Mass Payments transaction?

The following are the possible states for a Mass Payments transaction:

  • Processing: You have requested a mass payment and the disbursements are working their way through the system.
  • Denied: Your funds were not sent and the Mass Payments transaction was not initiated. This may have been caused by lack of funds.
  • Processed: Your Mass Payments file has been processed and all payments have been sent.
  • Completed: All of your payments have been claimed, or after a period of 30 days, unclaimed payments have been returned to you.


Mass Payments currency codes