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:

• Alipay Overseas SDK Documentation
• AlipayHK SDK Download
• AlipayHK SDK Trigger Guide

---

HTTP Request

Endpoint : /trade/v1/payment
Method : POST

PayType	Description
801110	Alipay In-App (Overseas Merchants)
801510	Alipay In-App (HK Merchants)

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	Yes	String	Alipay seller account
mchid	Yes	String(16)	QFPay assigned Merchant ID

See Public 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:

1. Join all fields in the format: key="value"
2. Sort keys in ascending order (alphabetical)
3. Concatenate with &
4. 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"

note

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