#User & Product Information
#Payer
| Name | Type | Length | Required | Description |
|---|---|---|---|---|
| bankCode | string | - | No | Payer bank code |
| bankName | string | - | No | Payer bank name |
| accountNo | string | - | No | Bank card account or mobile wallet account number, consisting entirely of numbers, in the format e.g. 009203123456789 |
| accountName | string | - | No | Payer account name |
#CustomerInfo
| Name | Type | Length | Required | Description |
|---|---|---|---|---|
| userId | string | 15 | No | User ID |
| userName | string | 15 | No | User Name. Please fill in this field in Pakistan. |
| phone | string | 15 | No | User's mobile phone number, displayed on the cashier page by default. Supports multiple formats e.g. 07011698742 / 7011698742 / 023407011698742 / 02347011698742. See Area Code Format. |
| firstName | string | 50 | No | Customer First Name |
| lastName | string | 50 | No | Customer Last Name |
| string | 50 | No | Email. Please fill in this field in Pakistan. | |
| address | string | 50 | No | Address |
| certificateNo | string | 13 | No | Only for JazzCash in Pakistan. The value will be displayed on the checkout page. |
#cardPayerInfo (ZA)
cardPayerInfois a JSON string (note the outer escaping). Two modes are supported.
#Mode 1: Full Card Number (first-time payment + card binding)
{\"cardNo\":\"4000000000000002\",\"cvv\":\"123\",\"expiryYear\":\"26\",\"expiryMonth\":\"12\",\"holderName\":\"zhangg\",\"rememberCard\":true,\"forceThreeDs\":AUTO}| Field | Type | Required | Description |
|---|---|---|---|
| cardNo | string | Yes | Card number |
| cvv | string | Yes | CVV / CVC2 |
| expiryMonth | string | Yes | Expiry month |
| expiryYear | string | Yes | Expiry year (last two digits) |
| holderName | string | No | Cardholder name |
| rememberCard | boolean | No | When true, the response returns a cardToken |
| forceThreeDs | string | No | Enforce verification: AUTO (automatic, default) / FORCE (force 3DS). |
#Mode 2: Bound Token (returning customer / MIT deduction)
{\"cardToken\":\"1cc0f44222d84d1ab7d51138d79e21db\"}| Field | Type | Required | Description |
|---|---|---|---|
| cardToken | string | Yes | Card token returned from card binding or first-time payment |
#GoodsDetail
| Name | Type | Length | Required | Description |
|---|---|---|---|---|
| goodsId | String | 32 | No | Merchant product ID |
| goodsName | String | 100 | No | Product name |
| quantity | Integer | - | No | Quantity |
| totalPrice | Long | - | No | Total price |
| skus | Sku | - | No | See detailed Sku list below |
#Sku
| Name | Type | Length | Required | Description |
|---|---|---|---|---|
| skuId | String | 32 | No | Merchant SKU ID |
| skuName | String | 100 | No | SKU name |
| totalPrice | Long | - | No | Total price |
| quantity | Integer | - | No | Quantity |
| skuInfo | String | 200 | No | Other SKU information, can send JSON |