payouts

Send Payouts from the User Interface

This guide describes how to send payouts using a .csv (comma separated value) payments file and the Payouts user interface. A payment file includes recipient and payment information for up to 5,000 payouts in a single file.

Prerequisites

To use Large Batch Payouts, you must have:

  1. A PayPal Business account with a confirmed email address and bank account. If you don't have a PayPal Business account, sign up now.

  2. Payouts enabled.

    1. US merchants—To enable Payouts, you can complete either of the following actions:
      1. Contact your Account Manager or PayPal customer support.
      2. Enable Payouts from My Account:
        1. Log in to the Developer Dashboard and go to My Account.
        2. Under Permissions name, locate Payouts and click the Enable link.
        3. Click Enable, complete the form and click Submit. When you've been approved, you'll receive an email from a PayPal representative.
    2. Non-US merchants—To enable Payouts, contact your Account Manager or PayPal customer support.

1. Enable the Payouts user interface

To send payout requests from the Payouts web interface, contact your account manager or call 1-888-221-1161 for assistance. When your account is approved for Payouts, complete the steps described on this page.

2. Create a payment file

  1. Open a basic text editor, spreadsheet, or database application.

  2. In the first row, enter the following payout information for the first recipient, from left to right.

    Column Payout information
    1 Recipient identifier — Required.
    Use one of the following:
    • Email address
    • Domestic mobile telephone number
    • PayPal PayerID — If you use PayPal Checkout or an Account Authentication Service, such as Log in with PayPal (LIPP), these APIs return the PayPal PayerID in the transaction's response message.
    2 Payment amount — Required.
    Use the correct currency format. For example, senders in Italy enter 5,45 and senders in the U.S. enter 5.45. For currencies that use a comma, enclose the amount in double quotes. For example, "100,45". If the format is incorrect, PayPal gives you the correct format when you upload the file.
    3 Currency — Required.
    Three-letter currency code. Currency codes are not case sensitive. For example, usd and USD are both acceptable for U.S. dollars.
    Notes: Enter one currency type per payment file. To send payouts in multiple currencies, create a separate payment file for each currency.

    A few countries have currency restrictions. If your Payouts request does not comply with a country's currency restrictions, that portion of your request will fail with an error message.
    4 Customer ID — Optional.
    Unique identifier with 30 character maximum. Cannot contain spaces. If the customer ID contains a comma, enclose the text in double quotes.
    5 Custom note — Optional.
    Unique sender defined message. The custom message is sent only to the individual recipient. 400 character maximum. If the custom notes contains a comma, enclose the text in double quotes.

    This example shows the payment information for U.S. a recipient:

    mbrown@email.com,100.5,USD,ID001,Here is your payment.
    

    This example shows payment information for a recipient in Germany. Because the EUR currency uses a comma separator, the payment amount is enclosed in double quotes:

    mbrown@myco.com,"100,50",EUR,ID001,Here is your payment.
    
  3. Add a new row for each recipient.

    Note: The maximum is 5,000 recipients per payment file.

  4. When the payment information for all recipients is complete, save the file in .csv (comma separated value) format.

3. Upload a payment file

As a final check, verify these requirements are met before you upload the file:

  • The format of the payment file is .csv.
  • The payment file contains only one currency type.
  • Your PayPal account balance contains enough funds to cover the total cost of the payouts request.
  • Your PayPal balance is the same currency as your payouts request.

To upload the file:

  1. Log in to your PayPal account at https://www.paypal.com.
  2. Click Money at the top of the Summary page and then Send Money on the left.
  3. Click Make a Mass Payment.
  4. From the Choose Payouts Recipients page, click Browse, select your payment file, and then click Open.

Note: If you upload a file you've already uploaded within the last 30 days, PayPal notifies you of a possible duplicate payout. You can choose to continue with your upload or you can cancel and upload a different file. If the file you uploaded has the same name as a previously uploaded file, and the new file has any differences, even as slight as an added comma, decimal, or simply reordered payout items, the system does not recognize it as a duplicate and you will not receive the duplicate payout notice.

  1. (Optional) Enter text in the Email subject and Custom message for recipient.
  2. Click Continue. PayPal scans your payment file for errors. If the file is valid, the Review Your Payments Details page displays.
  3. Click Send Payout to process your payments file. The page displays Your payment has been sent. You can then choose to Send another Payout or View Activity Details.

4. Review transaction details

After you submit the payment file, click View Activity Details on the final Payouts page to view transaction details. You can also view details from the Recent activity section of the Summary page or the Activity page of your PayPal account.

If the transaction status is Submitted, wait for the status to change to Processed or Completed to see the number of unclaimed payments.

PayPal places a temporary hold on the total monetary value of the payouts request, plus associated fees, until the transaction status is Processed. After releasing the temporary hold, if one or more transactions are declined, your PayPal account balance may exceed the available account balance shown during the period of the hold.

For more information, see View Reports and Individual record status

Additional information

Feedback