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:

ColumnDescriptionTypeFormatCondition
INVOICE_IDThe merchant-provided reference number.String (8-16)AN16
[a-zA-Z0-9]{8,16}
Required
AMOUNTThe payment request amount.Number (0.01 - 1000000.00)N10.N2
[0-9]{1,10}(.[0-9]{2})?
Required
CURRENCYThe payment request's amount ISO 4217 currency code.String (3)A3
[A-Z]{3}
Required
NOTESThe payment note less than 141 characters.String (0-140)AN
[\s\S]{0,140}
Optional
EXPIRY_TIMEThe time in minutes until the link expires. The default and maximum expiry time is 30 days.Number (5 - 43200)NumberOptional
CUSTOMER_GIVEN_NAMEThe 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.String (2-50)AN
[\s\S]{2,50}
Required
CUSTOMER_SURNAMEThe 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.String (2-50)AN
[\s\S]{2,50}
Required
CUSTOMER_EMAILThe customer's email address. Required for communicating with customers about payment. Required if SEND_EMAIL is true.String (6-128)AN128
[\s\S]{6,128}
Conditional
CUSTOMER_MOBILEThe customer's mobile number. Required for communicating with customers about payment. Format should be +27123456789. Required if SEND_SMS is true.String (5-25)AN25
[+0-9][0-9 \.()/-]{5,25}
Conditional
CUSTOMER_WHATSAPPThe customer's WhatsApp number. Required for communicating with customers about payment. Format should be +27123456789. Required if SEND_WHATSAPP is true.String (5-25)AN25
[+0-9][0-9 \.()/-]{5,25}
Conditional
ColumnDescriptionTypeFormatCondition
BILLING_STREET1The door number, floor, building number, building name, and street name of the address.String (1-100)AN100
[\s\S]{1,100}
Optional
BILLING_CITYThe town, district, or city of the billing address. Mandatory for 3-D Secure 2.String (1-48)AN48
[\s\S]{1,48}
Optional
BILLING_STATEThe county, state, or region of the address.String (1-50)AN50
[\s\S]{1,50}
Optional
BILLING_POSTALCODEThe postal code or ZIP code of the address.String (1-16)AN16
[\s\S]{1,16}
Optional
BILLING_COUNTRYThe country of the address.String (2) ISO 3166-1 alpha 2A2
[A-Z]{2}
Optional
SEND_EMAILSpecifies whether to send an email to the customer after creating the payment link.BooleanFalse: false, no, n, 0, blank
True: true, yes, y, 1
Conditional
SEND_SMSSpecifies whether to send an SMS to the customer after creating the payment link.BooleanFalse: false, no, n, 0, blank
True: true, yes, y, 1
Conditional
SEND_WHATSAPPSpecifies whether to send a WhatsApp message to the customer after creating the payment link.BooleanFalse: false, no, n, 0, blank
True: true, yes, y, 1
Conditional
EMAIL_CCList of comma-separated email addresses.String (0-128)AN128
[\s\S]{6,128}
Optional
EMAIL_BCCList of comma-separated email addresses.String (0-128)AN128
[\s\S]{6,128}
Optional