| Parameter | Description | Format | Required |
|---|---|---|---|
| paymentType | The type of payment transaction. One can send payment requests with one of the following types: PA (Preauthorization): An authorisation of the amount on customers card. Require a followup transaction (Reversal or Capture) DB (Debit): Debits the account of the end customer and credits the merchant account. | String A2 | Required |
| currency | The currency code of the payment request's amount (ISO 4217). | String A3 [A-Z]{3} | Required |
| language | Language to be displayed. If not sent, English will be used. Currently supported: EN, SR, ME | String A2 [A-Z]{2} | Optional |
| invoiceNumber | Merchant generated invoide number | String | Required |
| invoiceDate | Date of an Invoice specified in ISO8601 date format DD-MM-YYYY | AN10 {19|20)([0-9]{2})-(0[1-9]|1[0-2])-(0[1-9]|1[0-9]|2[0-9]|3[0-1]} | Required |
| invoiceDescription1 | The description of the first item on the invoice. | String AN2048 [\s\S]{1,2048} | Required |
| invoiceDescription2 | The description of the second item on the invoice. | String AN2048 [\s\S]{1,2048} | Optional |
| invoiceDescription3 | The description of the third item on the invoice. | String AN2048 [\s\S]{1,2048} | Optional |
| invoicePrice1 | The price (per unit) of the first item on the invoice (incl. tax and discount). | Number N13 [0-9]{1,10}.[0-9]{2} | Required |
| invoicePrice2 | The price (per unit) of the second item on the invoice (incl. tax and discount). | Number N13 [0-9]{1,10}.[0-9]{2} | Conditional |
| invoicePrice3 | The price (per unit) of the third item on the invoice (incl. tax and discount). | Number N13 [0-9]{1,10}.[0-9]{2} | Conditional |
| invoiceQuantity1 | The number of items for first item on invoice. | Number N5 [0-9]{1,12}(\.[0-9]{0,3}) | Required |
| invoiceQuantity2 | The number of items for second item on invoice. | Number N5 [0-9]{1,12}(\.[0-9]{0,3}) | Conditional |
| invoiceQuantity3 | The number of items for third item on invoice. | Number N5 [0-9]{1,12}(\.[0-9]{0,3}) | Conditional |
Customer Information
| Parameter | Description | Format | Required |
|---|---|---|---|
| customerFullname | The customer's full name as shown on the invoice. | String A3 [A-Z]{3} | Required |
| customerEmail | The customer's email address. Required for communicating with customer's regarding payment. | Email AN128 [\s\S]{6,128} | Required |
| customerBillingAddress | The door number, floor, building number, building name, and/or street name of the billing address. | String AN100 [\s\S]{1,100} | Optional |
| customerBillingCity | The town, district or city of the billing address. | String AN80 [\s\S]{1,80} | Optional |
| customerBillingCountry | The country of the billing address (ISO 3166-1). | String A2 [A-Z]{2} | Optional |
| customerBillingPostcode | The postal code or zip code of the billing address. | String AN30 [A-Za-z0-9]{1,30} | Optional |
| customerBillingPhone | The customer's phone number. Required for communicating with customer's regarding payment. | String AN25 [\s\S]{1,25} | Optional |
| customerCompany | The customer's company name as shown on the invoice. | String AN128 [\s\S]{6,128} | Optional |