description | true | Purchase itemized list or order description. Try to avoid special characters so that the payment request is not blocked by the web application firewall. For Taiwan channels please refer to Guideline for Taiwan channels. |
language | false | Default language, i.e. English, will be displayed without the langcode specified. |
merchantMetaData | false | Merchants are allowed to pass metadata for each transaction in JSON format only. Metadata that were passed via payment request will be returned in extraP parameters in extraData. |
customer.firstName | true | Buyer’s full name. (Please do not pass in dummy data if you want to use the saved cards feature, as this info will be used to identify the ownership of the card’ s token. If you need to use dummy data, kindly refer to guest_checkout.) |
customer.lastName | true | Buyer's full name is a concatenation of customer.firstName and customer.lastName. |
customer.email | true | Buyer’s email address. Must be a valid email. (Please do not pass in dummy data if you want to use the saved cards feature, as this info will be used to identify the ownership of the card’ s token. If you need to use dummy data, kindly refer to guest_checkout.) |
customer.billingPhone | true | Buyer’s mobile number or contact number. Must be a valid mobile number. (Please do not pass in dummy data if you want to use the saved cards feature, as this info will be used to identify the ownership of the card’ s token. If you need to use dummy data, kindly refer to guest_checkout.) |
customer.billingAddress1 | optional, mandatory for specific channel | Billing address line 1. |
customer.billingAddress2 | optional, mandatory for specific channel | Billing address line 2. |
customer.billingPostcode | optional, mandatory for specific channel | Billing address zipcode or postcode. |
customer.billingCity | optional, mandatory for specific channel | Billing address city. |
customer.billingState | optional, mandatory for specific channel | Billing address state. |
customer.billingCountry | optional, mandatory for specific channel | Buyer’s country E.g. MY for Malaysia. |
customer.shippingFirstName | optional, mandatory for specific channel | Receiver name. |
customer.shippingLastName | optional, mandatory for specific channel | Receiver name is a concatenation of customer.shippingFirstName and customer.shippingLastName. |
customer.shippingAddress1 | optional, mandatory for specific channel | Delivery address line 1. |
customer.shippingAddress2 | optional, mandatory for specific channel | Delivery address line 2. |
customer.shippingPostcode | optional, mandatory for specific channel | Delivery destination zipcode. |
customer.shippingCity | optional, mandatory for specific channel | Delivery destination city. |
customer.shippingState | optional, mandatory for specific channel | Delivery destination state. |
customer.shippingCountry | optional, mandatory for specific channel | Delivery destination country. |
extraData.shippingMerchantId | conditional for partner | Partner’s sub-merchant MID. |
extraData.shippingMerchantUrl | conditional for partner | Partner’s sub-merchant URL. |
extraData.shippingMerchantMcc | conditional for partner | Partner’s sub-merchant MCC. |
extraData.isEscrow | optional, for escrow payment | Set the value to 1 to indicate this is an escrow payment. Escrow transactions also can be set after the transaction has been created using escrow API. |
extraData.non3ds | conditional for partner, 0 or 1 | Applicable to card processing via specific processor using specific currency for pre-approved partners only. Equal to 0 by default and 1 for non-3DS transaction. |
extraData.tccType | optional, for card type transaction | Available value is: SALS = Capture Transaction (Default) AUTH = Authorize Transaction (Please inform PG before starting using pre-auth). |
extraData.tokenStatus | false | Default value will be 0. If the value is 1 the save card checkbox will be check as default. |
extraData.installMonth | optional, mandatory for installment payment | Total month of installment. E.g: 0, 3, 6, 12, 24. |
extraData.cashWaitTime | false | To overwrite the allowed waiting time for cash payment in hour(s), values greater than “Payment Expiry Time” in merchant profile will be capped.. |
extraData.splitInfo | optional, | as data delimiter and comma (, ) as recipient separator | Used for “Alipay Split Payment”. Format as: id|amount, id|amount. |
extraData.appDeeplink | false | Mobile deeplink/universal link that allows e-wallet In-App payment. |
extraData.waitTime | false | When the payment page will be expired in second(s) and redirect to cancelurl after timeout. |
extraData.paymentExpirationTime | false | For non-cash payment only. A timestamp (ISO 8601) that determines when the requestURL (payment link) will expire, in UTC. Eg. 2023-12-31T23:59:59Z. |
extraData.guestCheckout | conditional | Used to indicate that this checkout does not belong to a registered user. Equal to 0 by default and 1 if the merchant does not hold the customer’s bill_name, bill_email or bill_mobile. Saved card payment will disabled if set as 1. |
extraData.icpMemeberId | false | Unique ID for Taiwan ESUN channels. Merchant will be able to retrieve it from the extraP parameter in the payment response. |