iot小程序支付能力 -凯发app官方网站

更新时间：2023-05-23 09:59:12

我的文档

设置

介绍

iot 小程序和普通支付宝小程序使用的都是

当面付

，不同的是凯发k8官方网娱乐官方的支付方式支持刷脸支付和扫码支付，支付流程也有较大差异，iot 小程序支付通过

my.ix.startapp

打开收银台进行支付；my.ix.startapp 是启动 iot 应用的 api，在这个 api 的基础上扩展的收银台 api；收银台 api 是 iot 小程序集成刷脸/扫码支付功能的主要部件。

绑定产品并开通

小程序创建完成后，开发者登录

> 进入小程序详情页 >

在

开发

产品绑定

绑定产品

，添加

当面付

。

开通

还需要完成开通才能使用

当面付

。请在

商家平台

的产品详情页面点击

立即开通

，填写并提交相关信息。详情可查看

开通产品

。

启动收银台

使用说明

●

收银台功能要求蜻蜓应用 2.8.1 及以上版本。

●

蜻蜓设备每 30 分钟自动检查最新软件版本，若检查到新版本则在闲置 5 分钟后下载安装，开机或重启则会直接检查更新并下载安装。自动升级暂不支持手动关闭。

●

iot 小程序开发刷脸支付功能，需要在服务端接入当面付

alipay.trade.pay

（统一收单交易支付接口），不需要开通其他功能。

●

收银台功能支持刷脸支付和扫码支付，而扫码支付支持花呗分期，刷脸支付不支持花呗分期。

●

蜻蜓应用 2.9.0

之前的版本

，

若需要测试收银台功能，需要先完成

iot 小程序分发

，否则可能导致调试后直接退出收银台和不返回

barcode

付款码等现象。若小程序未上架，可以先使用蜻蜓api测试小程序appid：2019053165441001 进行分发。调试完成后请尽快使用正式版的小程序 appid 进行分发。

可调用如下代码获取版本：

//.js

my.ix.getversionsync({

packagename: 'zoloz.phone.android.alipay.com.dragonfly'}).versionname

调用流程

蜻蜓小程序调用收银台api

进入收银台页面用户选择刷脸或者扫码

收银台回调方法返回接收支付宝付款码

将付款码传回小程序服务端或发送到收银机（点击

my.ix.writehid

查看发送方法）

小程序服务端/收银机服务端调用支付宝当面付条码支付接口

alipay.trade.pay

发起支付

刷脸支付自动获取支付结果/扫码支付自行监听支付结果并传入。

两种凯发k8官方网娱乐官方的支付方式特点

●

扫码成功后收银台会返回付款码（barcode），并且默认自动退出，需要小程序自定义支付结果页。

●

刷脸成功后收银台会返回付款码（barcode）, 此时收银台界面不会退出, 会保留在前台获取并展示刷脸支付结果, 可以通过

my.ix.oncashiereventreceive

获取收银台页面实际退出的时机。

●

通过收银台 api 获取的刷脸付款码（barcode），仅用于

当面付

接口 alipay.trade.pay（统一收单交易支付接口）发起支付。调用 alipay.trade.pay 发起支付时，入参 scene=bar_code。如果传入其他值会导致收银台无法获取刷脸支付结果。

●

目前 iot 小程序的刷脸支付已支持

当面付

的

资金授权

。

●

刷脸支付结果页默认展示时长为5秒，有运营内容（如会员开卡等）时为10秒。

●

刷脸支付页面和刷脸支付结果页不支持自定义。

启动收银台示例代码

●

scenemode 参数：传入 pos 代表在连接收银机场景使用，启动收银台时不播报付款引导语音，页面展示电子海报。小程序容器 10.1.60.24 开始支持。

●

收银台操作指令：是指控制在收银台界面上刷脸、扫码等功能开关的指令。蜻蜓应用 2.9.3 版本开始支持收银台操作指令，具体参考

收银台操作指令

。

●

showscanpayresult 参数已失效，建议去除或传入 false。扫码成功后收银台会返回付款码 barcode，并且默认自动退出，需要小程序自定义支付结果页。

my.request请求服务器端

开发者通过调用

my.request

在 iot 小程序前端请求小程序服务器，启动收银台 my.ix.startapp({ appname: 'cashier', ... }) 返回的出参 barcode、buyerid 等参数交互给到服务器端，供 alipay.trade.pay（统一收单交易支付接口）完成支付并回传支付结果。收银机场景，需自行实现与收银机服务器端交互。

my.request 请求异常可以参考

my.request 常见问题

自助排查。

alipay.trade.pay（统一收单交易支付接口）完成支付代码示例如下。

服务器端使用启动收银台 my.ix.startapp({ appname: 'cashier', ... }) 返回的出参 barcode、buyerid 等参数进行调用接口支付。

接口返回示例：

刷脸支付 > 调用

my.ix.oncashiereventreceive

开启收银台事件监听示例代码如下。

监听到收银台退出事件后一定要

my.ix.offcashiereventreceive

关闭监听。