Create a batch payment file

This section describes the steps involved in creating a batch payment file that's required to send batch payments using Ripple Payments Direct.

With batch payments, you can get a quote for multiple payments (and different payout currencies) and process them all at once, instead of requesting a quote for every single payment; hence, batch payments significantly reduce the time and effort required to send large volume payments. Batch payments also provide faster time to value for customers without an API integration.

1. In Ripple Payments UI click the Payments tab.
2. Click Create Payment > Batch .
3. Follow the instructions in the How it works section.
   1. Download the batch payment template file .
   2. Enter the payment details .
   3. Upload your file.
4. To check your file for data validation errors and (subsequently) send the batch payment , click Get Quote .
5. Only if you see error messages in the Ripple Payments UI:
   1. In your local file copy, correct all errors according to the error message(s) and save the file copy.
      See the image below for example errors.
   2. In the Ripple Payments UI, click the (trash can) icon to delete the erroneous file.
   3. Upload the corrected version of the file.
   4. Once again, click Get Quote to send the batch payment.

   

Template file

1. After you click Download Template , create the template by selecting from the following fields:

   Field name	Description
   Use case	The use case for the payment transaction.
   Receiver country	The country of the payment receiver.
   Payout currency	The currency in which the beneficiary will be paid out.
   Payout category	The payout category. Only Bank is available.

2. Click Download Template .

Payment details

1. Rename the downloaded file to a less generic name that helps you remember details of the batch payment.
   For data validation purposes, you must save and upload the file in either xls or xlsx file format.
2. Open the renamed file.
3. Create one entry per row for each beneficiary you want to include in this batch payment (up to 100 per file).
   For details on the fields you must fill out to create a payment beneficiary entry, hover over the field names. For PHP payments, also refer to Bank IDs .

   Tips:

   • Make sure to enter information for all beneficiaries (up to 100 per file) that can be paid out in the currencies specific to that template. This way, you can avoid maintaining and storing multiple files for the same payout currency but different beneficiaries.
   • If you use an editing tool other than Excel, make sure to remove any trailing blank columns as such may cause a file processing error.
   • When you enter phone numbers, you may have to use ' to prevent your editing tool from formatting the phone number as a formula.

Payment limitations

The payout currencies currently supported by Ripple Payments Direct have the following payment limitations: