Hong Kong Payment Integration

Before reading this document, please make sure to review API Description Guide

限额

Transaction Type	Limit Range
Collection	USD: 0.99-499.99, HKD: 1-5000

Amount Decimal Places: HKD — 2 decimal places | USD — 2 decimal places

Collection API

Collection Request

Description:

Create a collection order

URL:

HKD: /hkd/collect/apply
Note: appId HKD, amount HKD, settlement HKD
USD: /usd/collect/apply
Note: appId USD, amount USD, settlement USD

Parameters:

Name	Required	Type	Description
appId	Yes	Long	Business ID (retrieved from the backend, must correspond to the currency in the URL)
orderId	Yes	String	Merchant order number (must be unique, max length: 48)
name	Yes	String	Customer name, recommended to use the real name. Format: firstName + lastName separated by a space, e.g. `John Doe`
phone	Yes	String	Real phone number (format reference: Phone Format)
email	Yes	String	Valid email address
amount	Yes	String	Transaction amount, up to 2 decimal places
payType	Yes	String	Transaction type
inBankCode	Yes	String	Payment method
callBackUrl	Yes	String	Redirect URL after successful payment
callBackFailUrl	Yes	String	Redirect URL after failed payment
cancelUrl	No	String	If provided, the payment page displays a Back button that redirects the user to this URL when clicked.
notifyUrl	No	String	Notification URL
subject	No	String	Payment note
body	No	String	Payment details
partnerUserId	Yes	String	Unique user identifier (e.g., userId). Must be valid, otherwise it may affect risk control. Allowed characters: digits, letters, and common symbols `-~!@#$%&*()_`
sign	Yes	String	Signature

Response Data

Name	Type	Description
orderId	String	Merchant order number (must be unique)
orderNo	String	Platform order number
payUrl	String	Payment URL
sign	String	Signature

Collection Query

Description:

Query collection order

URL:

HKD: /hkd/collect/query
USD: /usd/collect/query

Parameters:

Name	Required	Type	Description
appId	Yes	Long	Business ID (retrieved from the backend, must correspond to the currency in the URL)
orderId	Yes	String	Merchant order number
orderNo	No	String	Platform order number (faster response)
sign	Yes	String	Signature

Response Data

Name	Type	Description
orderId	String	Merchant order number (must be unique)
orderNo	String	Platform order number
amount	String	Transaction amount
actualAmount	String	Amount received
fee	String	Fee
status	Integer	Status (0: Not started, 1: Processing, 2: Success (final), 3: Failed (final), -1: Pending confirmation)
payTime	String	Payment success time (present when status=2)(local currency time), format: `yyyy-MM-dd HH:mm:ss`
errorMsg	String	Error message (present when status=3)
sign	String	Signature

Payment Methods

Currency	Payment Type (payType)	Payment Code (inBankCode)	Limit	Status	Description
HKD	EWALLET	WXPAY_SCANCODE	1-1000	Available	WeChat HK QR Code Payment
HKD	EWALLET	ALIPAY_HKD	1-5000	Available	AlipayHK
USD	EWALLET	HK_WXPAY_SCANCODE_USD	0.99-120	Available	WeChat HK QR Code Payment
USD	BANK_TRANSFER	ALIPAY_USD	0.99-499.99	Available	AlipayHK
USD	BANK_TRANSFER	PAYME_USD	1-1000	Maintenance	PayMe

Quick start

Merchant Guide

Common Payment

Global Payment

Unified API

Appendix

Merchant FAQ

Hong Kong Payment Integration

限额

Collection API

Collection Request

Collection Query

Payment Methods

​限额

​Collection API

​Collection Request

​Collection Query

​Payment Methods

​Related Topics

限额

Collection API

Collection Request

Collection Query

Payment Methods

Related Topics