微信小程序对接

接入提示

本方案适用于，商户已有自营微信小程序，需要在小程序内对接支付收银的场景。

接入半屏小程序前，请先确认已经开通商户号，配置完对应的支付信息。

🚀 快速开始

核心参数说明

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

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

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

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

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

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

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

⚙️ 接入准备

💡

商户需要自备一个小程序

在小程序后台 【账号设置】 - 【第三方设置】 内的 【半屏小程序管理】 功能模块，申请添加半屏支付小程序。

联拓商业云小程序appid： wx87168b525bf5fc8b

重要！！

需要确认支付进件主体关系，以及支付通道中是否配置了半屏支付小程序的appid

📋 接入指引

用户点击提交订单后，来源小程序请求平台方 订单支付 接口

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

来源小程序通过微信官方api拉起半屏支付小程序，打开半屏小程序方法： 半屏小程序官方文档

来源小程序拉起平台半屏支付小程序后，进入半屏小程序支付流程

半屏小程序内会请求微信下单，请求成功唤醒密码框

消费者输入密码完成付款，页面提示成功并弹窗【返回】

消费者取消支付，则提示支付失败，可点击按钮【返回】或【重新支付】

点击【返回】后，会通过extraData返回给来源小程序数据，来源小程序可在 App.onShow 中获取到这份数据

extraData参数非百分百携带，建议来源小程序调用 订单查询 接口主动查询订单结果

🔌 接口说明

1. 创建订单

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

提示

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

2. 小程序对接半屏小程序

参见微信官方文档 打开半屏小程序

appId 为指定的半屏小程序 appid：wx87168b525bf5fc8b

path 为拉起的支付页路径 /other/halfPay/index ，支持传入query参数，示例：

/other/halfPay/index?sm=EW_N1233221220&m=EW_N1233221223&no=203921827372199232

半屏小程序支付页参数说明：

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

打开半屏后，返回上一个小程序的方式

1. 点击页面上的返回按钮，可携带extraData

2. 物理返回或点击右上角"X"关闭，不携带extraData

温馨提示

建议接入方自行查询订单支付状态，避免状态丢失导致不同步

extraData状态可以在onShow中监听并获取，参数如下：

{
    order_no: "传入订单号",
    // 支付状态 success 成功 cancel 取消 error 失败
    pay_status: "支付状态"
}

监听示例代码：

3. 查询支付结果

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

💻 代码示例

核心流程说明

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

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

设置监听 → 拉起成功后设置支付结果监听

监听回调 → 监听支付结果，处理完后移除监听

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

微信小程序原生代码

uniapp代码示例

❓ 常见问题

1. 无法拉起半屏小程序

问题: 调用 wx.openEmbeddedMiniProgram 失败
原因:

未在小程序后台配置半屏小程序管理

非用户主动点击触发

appid 配置错误

解决方案:

检查小程序后台配置

确保在用户点击事件中调用

验证 appid 是否正确

2. 支付结果丢失

问题: 无法获取支付结果
原因: 用户通过物理返回键或右上角关闭按钮退出

解决方案:

在 onShow 中监听场景值 1038

主动调用订单查询接口

建议在支付完成后显示确认页面

3. 订单状态不同步

问题: 支付成功但订单状态未更新
原因: 异步通知延迟或失败

解决方案:

实现主动查询机制

设置重试机制

监控异步通知状态

4. 支付遇到问题？

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

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

现有微信支付通道被风控

解决方案:

检查后台支付通道配置

关闭异常通道，确保可用微信通道数

🚀 快速开始#

⚙️ 接入准备#

📋 接入指引#

🔌 接口说明#

1. 创建订单#

2. 小程序对接半屏小程序#

3. 查询支付结果#

💻 代码示例#

核心流程说明#

微信小程序原生代码#

uniapp代码示例#

❓ 常见问题#

1. 无法拉起半屏小程序#

2. 支付结果丢失#

3. 订单状态不同步#

4. 支付遇到问题？#

🚀 快速开始

⚙️ 接入准备

📋 接入指引

🔌 接口说明

1. 创建订单

2. 小程序对接半屏小程序

3. 查询支付结果

💻 代码示例

核心流程说明

微信小程序原生代码

uniapp代码示例

❓ 常见问题

1. 无法拉起半屏小程序

2. 支付结果丢失

3. 订单状态不同步

4. 支付遇到问题？