H5应用对接

接入提示

本方案适用于浏览器环境接入小程序支付场景。

🚀 快速开始

核心参数说明

微信小程序 AppID: wx87168b525bf5fc8b (固定值)

支付宝小程序 AppID: 2019111969268396 (固定值)

支付页面路径: other/halfPay/index (固定值)

支付模式: pay_model = 0 (收银台模式，固定值)

商户编号(sm): 请求接口client-id参数，用于识别商户

门店编码(m): 从平台方获取，用于标识具体门店

订单号(no): 通过预下单接口生成，唯一标识订单

✅ 接入成功！结束！ 详细说明请往下看 ↓

📋 接入指引

用户点击提交订单后，来源方请求平台方 订单支付 接口预下单。

平台方生成待支付订单，返回订单号。

来源方通过URLScheme拉起小程序进行支付

微信支付：微信小程序明文URLScheme

支付宝支付：支付宝小程序URLScheme

用户在小程序内完成支付流程

支付完成后关闭小程序，返回来源网页。

来源网页调用 订单查询 接口主动查询订单结果

🔌 接口说明

1. 创建订单

请求 订单支付 接口，传入订单的基本信息，返回订单号

提示

支付模式参数pay_model传0收银台模式

2. 拉起小程序收银台

💡

目前支持 微信支付 和 支付宝支付 两种方式

通用支付参数说明：

参数	参数说明	是否必填	备注
no	订单号，通过预下单生成	是	如：203921827372199232
sm	商户编号(client-id)	是	如：EW_N1233221220
m	门店编码	是	如：EW_N1233221223

2.1 拉起微信支付收银台

参考微信官方文档 微信小程序明文URLScheme

appid 为微信半屏小程序 appid：wx87168b525bf5fc8b

path 为拉起的支付页路径: other/halfPay/index

query 为携带的通用支付参数，需要进行urlencode编码，示例：

encodeURIComponent('no=203921827372199232&sm=EW_N1233221220&m=EW_N1233221223')

2.2 拉起支付宝支付收银台

参考支付宝官方文档 支付宝小程序URLScheme

appId 为支付宝半屏小程序 appid：2019111969268396

page 为拉起的支付页路径: other/halfPay/index

query 为携带的通用支付参数，需要进行urlencode编码，示例：

encodeURIComponent('no=203921827372199232&sm=EW_N1233221220&m=EW_N1233221223')

3. 支付结果检测

请求 订单查询 接口，传入订单号，获取订单信息

小程序收银台关闭后，无法同步通知来源方支付状态，建议采用以下方式：

推荐方式：弹窗确认

页面重新获得焦点时弹出确认弹窗

用户选择"我已支付"或"未支付"

根据用户选择查询订单状态并处理结果

备选方式：定时轮询

设置定时器定期查询订单状态

根据订单状态自动处理支付结果

💻 代码示例

核心流程说明

创建订单 → 调用订单支付接口，获取订单号

拉起支付 → 拉起支付小程序

检测结果 → 主动查询订单状态，确保数据同步

代码示例

❓ 常见问题

1. 无法跳转到小程序

问题: 点击支付按钮后页面没有跳转到小程序
原因:

用户设备未安装微信/支付宝

微信/支付宝版本过低，不支持URLScheme

浏览器阻止了跳转

URLScheme格式错误

解决方案:

提示用户安装或更新微信/支付宝

检查URLScheme参数名是否正确，参数值是否编码正确

微信是appid（小写），支付宝是appId（驼峰）

页面路径参数，微信是path，支付宝是page

query参数需要进行 urlencode 编码

2. 支付结果检测不准确

问题: 支付状态检测延迟或错误
原因:

网络请求延迟

订单状态更新延迟

检测频率设置不当

检测异步通知回调url是否正确

解决方案:

设置合理的检测间隔（建议3-5秒）

实现指数退避策略

设置检测超时时间

提供手动查询按钮

3. 支付遇到问题？

问题: 拉起小程序后，未能成功唤起微信/支付宝支付，显示支付遇到问题
原因:

未配置可用的微信/支付宝支付通道

现有微信/支付宝支付通道被风控

解决方案:

检查后台支付通道配置

关闭异常通道，确保可用微信/支付宝通道数

🚀 快速开始#

📋 接入指引#

🔌 接口说明#

1. 创建订单#

2. 拉起小程序收银台#

2.1 拉起微信支付收银台#

2.2 拉起支付宝支付收银台#

3. 支付结果检测#

💻 代码示例#

核心流程说明#

代码示例#

❓ 常见问题#

1. 无法跳转到小程序#

2. 支付结果检测不准确#

3. 支付遇到问题？#

🚀 快速开始

📋 接入指引

🔌 接口说明

1. 创建订单

2. 拉起小程序收银台

2.1 拉起微信支付收银台

2.2 拉起支付宝支付收银台

3. 支付结果检测

💻 代码示例

核心流程说明

代码示例

❓ 常见问题

1. 无法跳转到小程序

2. 支付结果检测不准确

3. 支付遇到问题？