• English
  • User & Product Information

    Payer

    NameTypeLengthRequiredDescription
    bankCodestring-NoPayer bank code
    bankNamestring-NoPayer bank name
    accountNostring-NoBank card account or mobile wallet account number, consisting entirely of numbers, in the format e.g. 009203123456789
    accountNamestring-NoPayer account name

    CustomerInfo

    NameTypeLengthRequiredDescription
    userIdstring15NoUser ID
    userNamestring15NoUser Name. Please fill in this field in Pakistan.
    phonestring15NoUser's mobile phone number, displayed on the cashier page by default. Supports multiple formats e.g. 07011698742 / 7011698742 / 023407011698742 / 02347011698742. See Area Code Format.
    firstNamestring50NoCustomer First Name
    lastNamestring50NoCustomer Last Name
    emailstring50NoEmail. Please fill in this field in Pakistan.
    addressstring50NoAddress
    certificateNostring13NoOnly for JazzCash in Pakistan. The value will be displayed on the checkout page.

    cardPayerInfo (ZA)

    cardPayerInfo is 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}
    FieldTypeRequiredDescription
    cardNostringYesCard number
    cvvstringYesCVV / CVC2
    expiryMonthstringYesExpiry month
    expiryYearstringYesExpiry year (last two digits)
    holderNamestringNoCardholder name
    rememberCardbooleanNoWhen true, the response returns a cardToken
    forceThreeDsstringNoEnforce verification: AUTO (automatic, default) / FORCE (force 3DS).

    Mode 2: Bound Token (returning customer / MIT deduction)

    {\"cardToken\":\"1cc0f44222d84d1ab7d51138d79e21db\"}
    FieldTypeRequiredDescription
    cardTokenstringYesCard token returned from card binding or first-time payment

    GoodsDetail

    NameTypeLengthRequiredDescription
    goodsIdString32NoMerchant product ID
    goodsNameString100NoProduct name
    quantityInteger-NoQuantity
    totalPriceLong-NoTotal price
    skusSku-NoSee detailed Sku list below

    Sku

    NameTypeLengthRequiredDescription
    skuIdString32NoMerchant SKU ID
    skuNameString100NoSKU name
    totalPriceLong-NoTotal price
    quantityInteger-NoQuantity
    skuInfoString200NoOther SKU information, can send JSON