Alipay In-App Payments

This guide explains how to integrate Alipay In-App payments using the Alipay SDK (AlipayHK or AlipayCN). This payment method is used within a native app environment and provides a seamless user experience.

SDK Download

To begin integration, download the official SDK packages below:

HTTP Request

Endpoint : /trade/v1/payment
Method : POST

PayType	Description
`801110`	Alipay In-App (Settle By Alipay)
`801510`	Alipay In-App (Settle By QFPay)

Required Parameters

Parameter	Required	Type	Description
`txamt`	Yes	Int	Transaction amount in cents. Example: 100 = $1
`txcurrcd`	Yes	String(3)	Currency code (e.g. HKD)
`pay_type`	Yes	String(6)	Use 801110 for Alipay CN, 801510 for AlipayHK
`out_trade_no`	Yes	String(128)	Unique merchant transaction ID
`txdtm`	Yes	String(20)	Format: `YYYY-MM-DD hh:mm:ss`
`goods_name`	Yes	String	Product name
`return_url`	Yes	String	Redirect URL after payment
`seller_id`	No	String	Alipay seller account
`mchid`	No	String(16)	QFPay assigned Merchant ID

See Common Payment Parameters for shared fields.

Optional Parameters

Parameter Name	Parameter Key	Required	Type	Description
Product Description	`goods_info`	No	String	Required by Alipay. Special characters are not allowed.
Payment Tag	`pay_tag`	No	String(16)	Default: ALIPAYHK For Alipay Mainland use: ALIPAYCN
Order Expiry Time	`expired_time`	No (Main-scan only)	String(3)	Expiration time in minutes. Default is 30 minutes. Min: 5, Max: 120. Applicable to WeChat Pay and Alipay

Sample Request (Form Payload)

txamt=1
&txcurrcd=HKD
&pay_type=801510
&out_trade_no=052711570017898
&txdtm=2021-05-27 11:57:00
&goods_name=goods_name
&goods_info=goods_info
&mchid=nDB64h9qJ1An
&trade_name=trade_name
&goods_detail=goods_detail
&return_url=https://www.qfpay.global/
&pay_tag=ALIPAYHK
&seller_id=testoverseas9191@alipay.com

Response Fields (pay_params)

These fields are returned by QFPay and should be passed into the Alipay SDK.

Parameter Key	Sub Parameter Key	Description
`pay_params`	`partner`	Partner ID
	`seller_id`	Unique Alipay user ID of the receiving account
	`subject`	Product title / trade title / order title
	`body`	Detailed description of the transaction. For multiple items, concatenate descriptions into this field
	`total_fee`	Total order amount
	`notify_url`	Notification callback URL
	`service`	Service name
	`cardcd`	Card number
	`payment_type`	Payment type
	`_input_charset`	Character encoding format
	`it_b_pay`	Custom timeout parameter
	`return_url`	Redirect URL after payment
	`payment_inst`	Payment institution
	`currency`	Currency code
	`product_code`	Product code
	`sign`	RSA signature (Required)
	`sign_type`	Signature type
	`secondary_merchant_id`	Secondary merchant ID
	`secondary_merchant_name`	Secondary merchant name
	`secondary_merchant_industry`	Secondary merchant industry
`chnlsn`		Channel transaction number
Common Response Parameters	—	—

Sample QFPay Response

{
  "pay_type": "801510",
  "sysdtm": "2021-05-27 11:57:02",
  "paydtm": "2021-05-27 11:57:02",
  "udid": "qiantai2",
  "txcurrcd": "HKD",
  "txdtm": "2021-05-27 11:57:00",
  "txamt": "1",
  "resperr": "交易成功",
  "respmsg": "",
  "out_trade_no": "052711570017898",
  "syssn": "20210527154100020004180921",
  "pay_params": {
    "body": "goods_info",
    "forex_biz": "FP",
    "seller_id": "2088231067382451",
    "secondary_merchant_id": "1000007081",
    "service": "mobile.securitypay.pay",
    "payment_inst": "ALIPAYHK",
    "it_b_pay": "30m",
    "secondary_merchant_name": "IFlare Hong Kong Limited (external) - online",
    "_input_charset": "UTF-8",
    "sign": "iU1yXUnsCK7rJAu0DoN61arVexbIfo3GLR5jr3QzjkZ29INSPhcA4e%2F2%2BdPrsf5huzQAkxVKP0CTfvaGPMYqNkxmhoaJWUH0ZhgYDgKugMvtweBvRqOX2W0h3A%2F%2FIdJuxeyOAuh7bHiuazSB3ZH%2BEQwRGP%2Bkk8Jpha930gHwPtw%3D",
    "currency": "HKD",
    "out_trade_no": "20210527154100020004180921",
    "payment_type": "1",
    "total_fee": 0.01,
    "sign_type": "RSA",
    "notify_url": "https://test-o2-hk.qfapi.com/trade/alipay_hk/v1/notify",
    "partner": "2088231067382451",
    "secondary_merchant_industry": "5941",
    "product_code": "NEW_WAP_OVERSEAS_SELLER",
    "return_url": "https://www.qfpay.global/",
    "subject": "goods_name"
  },
  "respcd": "0000",
  "chnlsn": "",
  "cardcd": ""
}

Using Alipay SDK

After receiving the pay_params in the response, construct the orderInfo string required by the SDK in the following format:

Join all fields in the format: key="value"
Sort keys in ascending order (alphabetical)
Concatenate with &
Place sign and sign_type at the end

Sample

_input_charset="UTF-8"&body="goods_info"&currency="HKD"&forex_biz="FP"&it_b_pay="30m"&notify_url="https://test-o2-hk.qfapi.com/trade/alipay_hk/v1/notify"&out_trade_no="20210527154100020004180921"&partner="2088231067382451"&payment_inst="ALIPAYHK"&payment_type="1"&product_code="NEW_WAP_OVERSEAS_SELLER"&return_url="https://www.qfpay.global/"&secondary_merchant_id="1000007081"&secondary_merchant_industry="5941"&secondary_merchant_name="IFlare Hong Kong Limited (external) - online"&seller_id="2088231067382451"&service="mobile.securitypay.pay"&subject="goods_name"&total_fee="0.01"&sign="iU1yXUnsCK7rJAu0DoN61arVexbIfo3GLR5jr3QzjkZ29INSPhcA4e%2F2%2BdPrsf5huzQAkxVKP0CTfvaGPMYqNkxmhoaJWUH0ZhgYDgKugMvtweBvRqOX2W0h3A%2F%2FIdJuxeyOAuh7bHiuazSB3ZH%2BEQwRGP%2Bkk8Jpha930gHwPtw%3D"&sign_type="RSA"

Make sure you:

Follow the correct SDK version and region (HK vs CN)
Use the exact key names and values returned in pay_params
Keep your sign logic consistent with Alipay SDK format

Preparation

Business Scenarios

API Reference

In-Store Payments

Online Payments

Shared Endpoints

SDK Download

HTTP Request

Required Parameters

Optional Parameters

Sample Request (Form Payload)

Response Fields (pay_params)

Sample QFPay Response

Using Alipay SDK

Sample

​SDK Download

​HTTP Request

​Required Parameters

​Optional Parameters

​Sample Request (Form Payload)

​Response Fields (pay_params)

​Sample QFPay Response

​Using Alipay SDK

​Sample

SDK Download

HTTP Request

Required Parameters

Optional Parameters

Sample Request (Form Payload)

Response Fields (pay_params)

Sample QFPay Response

Using Alipay SDK

Sample