Skip to main content
This guide describes how to integrate Alipay Web Payments for both Hong Kong and overseas merchants.
AlipayHK does not support the native Alipay checkout page.
For AlipayHK, merchants typically request a QR code / payment URL and embed it in the merchant page (e.g. as a QR code image or via an iframe).

Overview

Alipay Web Payments allow customers to complete a purchase by scanning a QR code (or opening a hosted payment URL). After payment confirmation, funds are deducted from the customer’s wallet and the result is returned to the merchant system.
  • Mainland China users pay in CNY; QFPay settles to merchants in the configured settlement currency.
  • Hong Kong users pay in HKD.
If return_url is provided, the customer is redirected back to the merchant website after payment.

HTTP Request

Endpoint POST /trade/v1/payment

Supported Pay Types


Request Parameters


Optional Parameters


Response Parameters


Code Examples

Use the language tabs below. Replace the placeholders with your own credentials and values.

Sample Response


Notes

Render the QR code or iframe using pay_url.
Do not reuse out_trade_no across payments or refunds.
If respcd is 1143 or 1145, retry or query the transaction result using /trade/v1/query.