Use Web UI

You can send payouts to PayPal accounts and Venmo users.

Prerequisites

Complete all mandatory steps to get started.
Ensure your PayPal business account is set up.
Ensure to fund your business account.

Send payouts

You can use the procedures in this section to send payouts using the Payouts Web UI.

1. Create input file

Create a .csv file and add payout records as line items. Use the following format and add each payout you want to send as a separate row. You can add a maximum of 5000 rows.

Sample payout line items

[email protected],100.5,USD,ID001,Here is your payment,PAYPAL
[email protected],100.5,USD,,Here is your payment,VENMO,FRIENDS_ONLY

[email protected],"100,50",EUR,ID001,Here is your payment,PAYPAL

Field, Description, Notes
Field	Description	Notes
Recipient identifier Required	Identifier for the payout recipient based on the wallet type.	PayPal: Recipient's PayPal-associated email address or PayPal PayerID (retrieved through PayPal Checkout or Assisted Account Creation). Venmo: Recipient's US mobile number or Venmo handle. Examples: `[email protected]`, `[email protected]`, `[email protected]`
Payment amount Required	Amount to send.	For currencies that use a comma, enclose the amount in double quotes. PayPal validates the format on upload. Example: `100.5` or `"100,50"`
Currency Required	Three-letter ISO 4217 currency code. Each file must contain only one currency type.	Use separate files for different currencies. To pay recipients in the local currency, group the recipients by their currency type and create one file for each payout currency. For more information, see Pay in local currency. Example: `USD` or `EUR` Max length: 3 characters
Customer ID	Unique recipient identifier.	No spaces allowed. Use double quotes if value contains commas. Example: `ID001` Max length: 30 characters
Note to recipient Required for Venmo, Optional for PayPal	Custom message sent to the recipient.	PayPal: Overrides the default message set in the PayPal UI, if provided. Venmo: A message must be included for each recipient. The message inherits the recipient’s privacy setting. Example: `Here is your payment` Max length: 400 characters
Recipient wallet Required	Target wallet for the payout.	Default value: `PAYPAL` Possible values: • `PAYPAL` • `VENMO`
Social feed privacy Venmo only	Visibility setting for the Venmo recipient’s social feed.	Default value: `PRIVATE` Possible values: • `PUBLIC` • `FRIENDS_ONLY` • `PRIVATE`
Holler URL Deprecated Venmo only	URL of a Holler sticker to include with the Venmo message.	Example: `https://example.com/sticker.png` Max length: 151 characters
Logo URL Venmo only	URL of the business logo shown in the Venmo feed.	Image uploaded at the access URL must be a square image of max size 1024 × 1024 px. Example: `https://example.com/logo.png` Max length: 2000 characters
Purpose	Reason for the transaction.	Default value: `GOODS` Possible values: • `AWARDS` • `PRIZES` • `DONATIONS` • `GOODS` • `SERVICES` • `REBATES` • `CASHBACK` • `DISCOUNTS` • `NON_GOODS_OR_SERVICES`

CSV file format specifications

Use the following specifications to ensure your payout file meets the required format and is accepted:

Use a period (.) as the decimal separator for currencies similar to U.S. dollars (USD), Canadian dollars (CAD), and British pounds (GBP). For example: 100.5.
Use a comma (,) for currencies such as euros (EUR) and Brazilian reais (BRL), and enclose the amount in double quotes. For example: "100,50".
Each file must contain only one currency. For multi-currency payouts, upload a separate file for each currency.
Preserve the defined column order and ensure all rows include the same number of columns. Leave optional fields blank if not used and do not remove them.
Add one row per recipient, adhering to the exact column structure.
Wrap values containing commas or special characters in double quotes. For example, "100,50" or "Custom Message with Comma, Here".

2. Upload input file

You can upload a sample input file in your sandbox account, test the payout, and then move to production.

Log in to your PayPal account.
Go to Business Tools > Make Payments > Payouts > Get Started.
On the Send a Mass Payment page:
- Go to Choose File to select your .csv payment file.
- Select Open to upload it.
(Optional) Enter additional details:
- Email subject: Appears in the recipient’s email.
- Custom message for recipient: Overrides the default message (applies to PayPal payouts only).
Review the consent statement and select the checkbox to acknowledge it.
Select Continue. PayPal validates your file and displays a Review Your Payments Details page.
Select Send Payout to submit the file. If you have set up a payout approval flow for your business account, PayPal sends the payout for approval and an approver must approve it.
After submission, select one of the following:
- Send another payout: Process a new .csv file.
- View activity details: Check payment status and transaction details.

If you reupload the same file within 30 days, PayPal shows a duplicate warning.

3. Track and manage payouts

You can:

Monitor the status of each payment after submitting your .csv file.
View payout details on the confirmation page or in the Activity tab of your PayPal business account dashboard.
Download reports and transaction logs to review fees, statuses, and currency conversion details.

For more information, see Track payout item status.

4. Go live

If you tested an input file in the sandbox and the payout is successful:

Modify your input file to reflect actual payouts.
Go to your live account and upload the input file.

Send payouts

You can use the procedures in this section to send payouts using the Payouts Web UI.

Create a .csv file and add payout records as line items. Use the following format and add each payout you want to send as a separate row. You can add a maximum of 5000 rows.

[email protected],100.5,USD,ID001,Here is your payment,PAYPAL
[email protected],100.5,USD,,Here is your payment,VENMO,FRIENDS_ONLY

[email protected],"100,50",EUR,ID001,Here is your payment,PAYPAL

Field, Description, Notes
Field	Description	Notes
Recipient identifier Required	Identifier for the payout recipient based on the wallet type.	PayPal: Recipient's PayPal-associated email address or PayPal PayerID (retrieved through PayPal Checkout or Assisted Account Creation). Venmo: Recipient's US mobile number or Venmo handle. Examples: `[email protected]`, `[email protected]`, `[email protected]`
Payment amount Required	Amount to send.	For currencies that use a comma, enclose the amount in double quotes. PayPal validates the format on upload. Example: `100.5` or `"100,50"`
Currency Required	Three-letter ISO 4217 currency code. Each file must contain only one currency type.	Use separate files for different currencies. To pay recipients in the local currency, group the recipients by their currency type and create one file for each payout currency. For more information, see Pay in local currency. Example: `USD` or `EUR` Max length: 3 characters
Customer ID	Unique recipient identifier.	No spaces allowed. Use double quotes if value contains commas. Example: `ID001` Max length: 30 characters
Note to recipient Required for Venmo, Optional for PayPal	Custom message sent to the recipient.	PayPal: Overrides the default message set in the PayPal UI, if provided. Venmo: A message must be included for each recipient. The message inherits the recipient’s privacy setting. Example: `Here is your payment` Max length: 400 characters
Recipient wallet Required	Target wallet for the payout.	Default value: `PAYPAL` Possible values: • `PAYPAL` • `VENMO`
Social feed privacy Venmo only	Visibility setting for the Venmo recipient’s social feed.	Default value: `PRIVATE` Possible values: • `PUBLIC` • `FRIENDS_ONLY` • `PRIVATE`
Holler URL Deprecated Venmo only	URL of a Holler sticker to include with the Venmo message.	Example: `https://example.com/sticker.png` Max length: 151 characters
Logo URL Venmo only	URL of the business logo shown in the Venmo feed.	Image uploaded at the access URL must be a square image of max size 1024 × 1024 px. Example: `https://example.com/logo.png` Max length: 2000 characters
Purpose	Reason for the transaction.	Default value: `GOODS` Possible values: • `AWARDS` • `PRIZES` • `DONATIONS` • `GOODS` • `SERVICES` • `REBATES` • `CASHBACK` • `DISCOUNTS` • `NON_GOODS_OR_SERVICES`

Use the following specifications to ensure your payout file meets the required format and is accepted:

Use a period (.) as the decimal separator for currencies similar to U.S. dollars (USD), Canadian dollars (CAD), and British pounds (GBP). For example: 100.5.

Use a comma (,) for currencies such as euros (EUR) and Brazilian reais (BRL), and enclose the amount in double quotes. For example: "100,50".

Each file must contain only one currency. For multi-currency payouts, upload a separate file for each currency.

Preserve the defined column order and ensure all rows include the same number of columns. Leave optional fields blank if not used and do not remove them.

Add one row per recipient, adhering to the exact column structure.

Wrap values containing commas or special characters in double quotes. For example, "100,50" or "Custom Message with Comma, Here".

You can upload a sample input file in your sandbox account, test the payout, and then move to production.

Go to Business Tools > Make Payments > Payouts > Get Started.

On the Send a Mass Payment page:

Go to Choose File to select your .csv payment file.
Select Open to upload it.

(Optional) Enter additional details:

Email subject: Appears in the recipient’s email.
Custom message for recipient: Overrides the default message (applies to PayPal payouts only).

Review the consent statement and select the checkbox to acknowledge it.

Select Continue. PayPal validates your file and displays a Review Your Payments Details page.

Select Send Payout to submit the file. If you have set up a payout approval flow for your business account, PayPal sends the payout for approval and an approver must approve it.

After submission, select one of the following:

Send another payout: Process a new .csv file.
View activity details: Check payment status and transaction details.

If you reupload the same file within 30 days, PayPal shows a duplicate warning.

You can:

Monitor the status of each payment after submitting your .csv file.

View payout details on the confirmation page or in the Activity tab of your PayPal business account dashboard.

Download reports and transaction logs to review fees, statuses, and currency conversion details.

If you tested an input file in the sandbox and the payout is successful:

Modify your input file to reflect actual payouts.

Go to your live account and upload the input file.

Use Web UI

Learn how to send up to 5,000 payments for a file using Payouts Web. Use .csv files to manage bulk payouts efficiently and integrate with PayPal's payment system.

Prerequisites

Send payouts

1. Create input file

Sample payout line items

CSV file format specifications

2. Upload input file

3. Track and manage payouts

4. Go live

On this page

On this page

On this page

Use Web UI

Learn how to send up to 5,000 payments for a file using Payouts Web. Use .csv files to manage bulk payouts efficiently and integrate with PayPal's payment system.

Prerequisites

Send payouts

1. Create input file

Sample payout line items

CSV file format specifications

2. Upload input file

3. Track and manage payouts

4. Go live

On this page

On this page

Use Web UI

Learn how to send up to 5,000 payments for a file using Payouts Web. Use .csv files to manage bulk payouts efficiently and integrate with PayPal's payment system.

On this page

On this page

On this page

If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more

Use Web UI

Learn how to send up to 5,000 payments for a file using Payouts Web. Use .csv files to manage bulk payouts efficiently and integrate with PayPal's payment system.

On this page

On this page