H5 / Web 支付接入 · YHT
XPay 商户接口 · 2026-11-09 更新 · 金额单位：人民币元
商户网页只处理支付展示与跳转；创建订单、签名、查单和到账确认放在商户服务器。下单接口见 法币下单。
当前怎样选择
| 目标场景 | payMethod | 接入方式与条件 |
|---|---|---|
| 电脑 Web，支付宝扫码 | aliQr | 已验证。服务器下单，网页展示返回的二维码，用户用支付宝扫一扫；服务器核对付款。 |
| 手机 H5，支付宝支付 | aliPay | 需开通支付宝手机网站支付；当前渠道未开通。开通后使用本次返回的支付链接或表单，真机验收后上线。 |
| 手机 H5，微信外浏览器 | wxMobileH5 | 需开通微信标准 H5；当前渠道未开通。下单传真实付款 IP，按返回链接跳转。 |
| 电脑 Web，支付宝网站收银台 | aliPc | 需单独开通电脑网站支付；当前渠道未开通。不是 aliQr 的同义编码。 |
| 电脑 Web，微信扫码 | wxNative | 需单独开通微信扫码；当前渠道未开通。 |
| 微信内网页 | wxPub 或 wxH5 | 依赖公众号授权与支付配置；当前仍待验收。wxPub 由商户提供匹配 openid；wxH5 为平台公众号收银台历史编码。 |
| 微信小程序 | wxLite | 需匹配的 subAppId 和 openid，在对应小程序调用 wx.requestPayment；不能直接放到普通网页执行。 |
可立即接入：支付宝 Web 扫码
- 商户服务器提交
payMethod=aliQr，金额使用amount，单位元。 - 成功返回
payDataType=codeurl时，将qrCode或payData的原始字符串编码为二维码，在网页展示。 - 用户用支付宝扫码付款。若返回
codeimgurl，内容是二维码图片地址，展示图片即可。 - 网页向自己的服务器查询订单进度；由服务器签名请求 XPay 查单。
- 收到通知后，由商户服务器签名查单；确认
status=2且金额与订单号一致，再幂等完成业务。网页轮询也使用服务端查单结果。
不要把扫码链接直接标成“手机 H5 支付已支持”。同一部手机无法通过扫描自己的屏幕完成通用扫码流程；移动网页跳转支付宝等场景需单独验收。不要将小程序支付参数当网页链接。
H5 开通后的参数准备
微信标准 H5 使用 wxMobileH5；支付宝手机网站使用 aliPay。沿用下单接口公共字段，填写实际商户 notifyUrl、redirectUrl，以及付款用户 clientIp；这些方式不需要小程序 openid 或 subAppId。平台需先开通通道能力和商户授权，之后再测手机浏览器唤起、取消、付款、回调与查单。
按 payDataType 使用结果
| 类型（返回为小写） | 正确使用方式 |
|---|---|
| payurl | 以原样返回的链接打开支付页面；链接可能过期 |
| codeurl | 将内容生成二维码；不是二维码图片地址 |
| codeimgurl | 内容为二维码图片地址 |
| wxapp | 微信支付参数字符串，解析 JSON 后交给匹配的公众号、小程序或 APP 环境 |
| aliapp | 交给对应支付宝 APP SDK |
| form | 支付表单内容；不是普通 URL，由商户按可信支付结果安全承接 |
无论哪种前端方式，下单受理、支付窗口关闭和返回结果页都不等于付款成功；统一以服务端查单及业务通知核验。
