Skip to main content

WAP Payment


WAP Payment or H5 Payment enables merchants to call up digital wallet module in mobile browser Chrome etc. to collect payment.

HTTP Request

Endpoint : /trade/v1/payment

Method : POST

PayType: you can find the different digital wallets pay_type from the table below.

800212WeChat H5 Payment, details please refer to WeChat Pay H5 (in mobile browser)
801512Alipay Hong Kong WAP payment, details please refer to Alipay Service Window H5
800712UNIONPAY WAP Payment
805812PayMe Online WAP Payment

Request Parameters

txamtYesInt(11)Payment amount of the transaction. Unit in cents (i.e. 100 = $1)
txcurrcdYesString(3)Transaction currency. View the Currencies table for a complete list of available currencies
pay_typeYesString(6)Payment type e.g. PayMe WAP Payment = 805812
out_trade_noYesString(128)API Order Number, external transaction number / Merchant platform transaction number: This parameter must be unique for each payment and refund request under the same merchant account in the system.
txdtmYesString(20)Request transaction time format:
YYYY-MM-DD hh:mm:ss
goods_nameNoString(64)Product name identification, Goods Name / Marking: Cannot exceed 20 alphanumeric or contain special characters. Cannot be empty for app payment. Parameter needs to be UTF-8 encoded if it is written in Chinese characters.
mchidNoString(16)QFPay merchant number. May or may not be given to merchant. If MCHID is given, it is mandatory to provide the MCHID .On the contrary, if MCHID is not provided, merchants shall not pass the MCHID field in the API request.
txzoneNoString(5)Transaction Time zone: Record of the transaction in local time, default time zone is Beijing time UTC+8 (+0800).
udidNoString(40)Unique transaction device ID. Is displayed on the merchant portal.
return_urlNoString(255)Redirect URL that the user will be redirected to when the payment finishes.
notify_urlNoString(255)Notification URL that the merchant will receive notification when the payment finishes.

Response Parameters

pay_typeString(6)Payment type, e.g. PayMe Wap Payment
sysdtmString(20)System transaction time, format:YYYY-MM-DD hh:mm:ss
This parameter value is used as the cut-off time for settlements.
txdtmString(20)Request transaction time, format:YYYY-MM-DD hh:mm:ss
resperrString(128)Response message
txamtInt(11)Payment amount
respmsgString(128)Other message information
out_trade_noString(128)External transaction number
syssnString(40)QFPay transaction number
respcdString(4)Return code, 0000 = Request successful.
1143/1145 = merchants are required to continue to query the transaction result.
All other return codes indicate transaction failure. Please refer to the page Transaction Status Codes for a complete list of response codes.
pay_urlString(512)Payment URL, generate QR code in Desktop web; redirect URL in WAP