支付宝小程序对接

接入提示

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

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

🚀 快速开始

核心参数说明

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

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

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

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

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

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

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

⚙️ 接入准备

💡

商户需要自备一个小程序

在小程序后台 【小程序信息】 - 【基础设置】 - 【小程序互相跳转页面】 - 【半屏跳转】 内的 【我的调用】 功能模块，申请添加半屏支付小程序。

联拓商业云小程序appid： 2019111969268396

📋 接入指引

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

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

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

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

半屏小程序内会请求支付宝下单，请求成功唤醒密码框

消费者输入密码完成付款，页面提示成功并弹窗【返回】（或进入支付宝支付完成后广告页，手动点右上角返回）

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

点击【返回】后，会关闭半屏，返回给来源小程序

半屏小程序无法通知订单支付状态，建议来源小程序调用 订单查询 接口主动查询订单结果

🔌 接口说明

1. 创建订单

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

提示

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

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

参见支付宝官方文档 打开半屏小程序

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

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

半屏小程序，无法通知来源小程序订单的支付状态

温馨提示

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

监听示例代码：

3. 查询支付结果

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

💻 代码示例

核心流程说明

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

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

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

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

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

支付宝小程序原生代码

uniapp代码示例

❓ 常见问题

1. 无法拉起半屏小程序

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

未在小程序后台配置调用名单内配置半屏小程序

非用户主动点击触发

appid 配置错误

解决方案:

检查小程序后台配置

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

验证 appid 是否正确

2. 支付结果丢失

问题: 无法获取支付结果
原因: 支付宝半屏小程序支付后，无法通知来源小程序支付结果

解决方案:

在 onAppShow 中监听，主动调用订单查询接口

建议在支付完成后显示确认页面，引导用户点击我已支付/暂未支付，点击后查询订单状态

3. 订单状态不同步

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

解决方案:

实现主动查询机制

设置重试机制

监控异步通知状态

4. 支付遇到问题？

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

未配置可用的支付宝支付通道

现有支付宝支付通道被风控

解决方案:

检查后台支付通道配置

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

🚀 快速开始#

⚙️ 接入准备#

📋 接入指引#

🔌 接口说明#

1. 创建订单#

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

3. 查询支付结果#

💻 代码示例#

核心流程说明#

支付宝小程序原生代码#

uniapp代码示例#

❓ 常见问题#

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

2. 支付结果丢失#

3. 订单状态不同步#

4. 支付遇到问题？#

🚀 快速开始

⚙️ 接入准备

📋 接入指引

🔌 接口说明

1. 创建订单

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

3. 查询支付结果

💻 代码示例

核心流程说明

支付宝小程序原生代码

uniapp代码示例

❓ 常见问题

1. 无法拉起半屏小程序

2. 支付结果丢失

3. 订单状态不同步

4. 支付遇到问题？