---
updatedAt: 2026-02-26T12:55:38.000Z
agentTools:
  projectIndex: https://developer.peachpayments.com/llms.txt
---

# Bulk payment links CSV parameters

When creating and sending bulk payment links, the CSV file that you upload must adhere to the following restrictions, you cannot add your own parameters:

| Column                | Condition    | Type                       | Format                                                                     | Description                                                                                                                                                                       |
| :-------------------- | :----------- | :------------------------- | :------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `INVOICE_ID`          | **Required** | String (8-16)              | AN16<br />\[a-zA-Z0-9]{8,16}                                               | The merchant-provided reference number.                                                                                                                                           |
| `AMOUNT`              | **Required** | Number (0.01 - 1000000.00) | N10.N2<br />\[0-9]{1,10}(.\[0-9]{2})?                                      | The payment request amount.                                                                                                                                                       |
| `CUSTOMER_SURNAME`    | **Required** | String (2-50)              | AN<br />\[\s\S]{2,50}                                                      | The customer's last name or surname. Required if you send any other customer parameters, also required for some risk checks and payment providers. Truncated after 48 characters. |
| `CUSTOMER_GIVEN_NAME` | **Required** | String (2-50)              | AN<br />\[\s\S]{2,50}                                                      | The customer's first or given name. Required if you send any other customer parameters, also required for some risk checks and payment providers. Truncated after 48 characters.  |
| `CURRENCY`            | **Required** | String (3)                 | A3<br />\[A-Z]{3}                                                          | The payment request's amount [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code.                                                                                    |
| `CUSTOMER_EMAIL`      | Conditional  | String (6-128)             | AN128<br />\[\s\S]{6,128}                                                  | The customer's email address. Required for communicating with customers about payment. Required if `SEND_EMAIL` is true.                                                          |
| `CUSTOMER_MOBILE`     | Conditional  | String (5-25)              | AN25<br />\[+0-9]\[0-9 .()/-]{5,25}                                        | The customer's mobile number. Required for communicating with customers about payment. Format should be `+27123456789`. Required if `SEND_SMS` is true.                           |
| `CUSTOMER_WHATSAPP`   | Conditional  | String (5-25)              | AN25<br />\[+0-9]\[0-9 .()/-]{5,25}                                        | The customer's WhatsApp number. Required for communicating with customers about payment. Format should be `+27123456789`. Required if `SEND_WHATSAPP` is true.                    |
| `SEND_EMAIL`          | Conditional  | Boolean                    | False: `false`, `no`, `n`, `0`, `blank`<br />True: `true`, `yes`, `y`, `1` | Specifies whether to send an email to the customer after creating the payment link.                                                                                               |
| `SEND_SMS`            | Conditional  | Boolean                    | False: `false`, `no`, `n`, `0`, `blank`<br />True: `true`, `yes`, `y`, `1` | Specifies whether to send an SMS to the customer after creating the payment link.                                                                                                 |
| `SEND_WHATSAPP`       | Conditional  | Boolean                    | False: `false`, `no`, `n`, `0`, `blank`<br />True: `true`, `yes`, `y`, `1` | Specifies whether to send a WhatsApp message to the customer after creating the payment link.                                                                                     |

| Column               | Condition | Type                          | Format                    | Description                                                                                 |
| :------------------- | :-------- | :---------------------------- | :------------------------ | :------------------------------------------------------------------------------------------ |
| `NOTES`              | Optional  | String (0-140)                | AN<br />\[\s\S]{0,140}    | The payment note less than 141 characters.                                                  |
| `EXPIRY_TIME`        | Optional  | Number (5 - 43200)            | Number                    | The time in minutes until the link expires. The default and maximum expiry time is 30 days. |
| `BILLING_STREET1`    | Optional  | String (1-100)                | AN100<br />\[\s\S]{1,100} | The door number, floor, building number, building name, and street name of the address.     |
| `BILLING_CITY`       | Optional  | String (1-48)                 | AN48<br />\[\s\S]{1,48}   | The town, district, or city of the billing address. Mandatory for 3-D Secure 2.             |
| `BILLING_STATE`      | Optional  | String (1-50)                 | AN50<br />\[\s\S]{1,50}   | The county, state, or region of the address.                                                |
| `BILLING_POSTALCODE` | Optional  | String (1-16)                 | AN16<br />\[\s\S]{1,16}   | The postal code or ZIP code of the address.                                                 |
| `BILLING_COUNTRY`    | Optional  | String (2) ISO 3166-1 alpha 2 | A2<br />\[A-Z]{2}         | The country of the address.                                                                 |
| `EMAIL_CC`           | Optional  | String (0-128)                | AN128<br />\[\s\S]{6,128} | List of comma-separated email addresses.                                                    |
| `EMAIL_BCC`          | Optional  | String (0-128)                | AN128<br />\[\s\S]{6,128} | List of comma-separated email addresses.                                                    |