安装设备并完成相关配置。
在设备上完成一笔刷脸支付,商户收款成功。
验证设备和支付宝交易商户号(pid/smid)的对应关系是否正确。
详见接口文档 。
注:
调用接口之前,需确保商户最近7天有在设备上完成刷脸收款的记录,否则校验不通过。
直连场景以支付签约 pid 为准,间连场景(含直付通)以商户 smid 为准。
接口入参 device_id_type 建议使用 id ,即使用 biz_tid (设备 id )作为设备唯一标识。获取设备 id 的方法:
开发iot小程序:iot小程序开发请参见 iot 小程序接入指南,获取设备id的方法请参见 获取系统属性 接口。
开发iot 应用:iot应用开发请参见 iotsdk开发文档,获取设备id的方法请参见 设备信息 接口。
通过蜻蜓系统设置页面查看:详见 。
收集商户支付宝账号:
间连场景(含直付通) 必选,要求与商户支付宝收单 smid 进件信息匹配的支付宝账号,比如营业执照对应的企业支付宝账号或法人身份证号对应的个人支付宝账号。
直连场景 可选,要求与商户支付签约 pid 对应的支付宝账号。
通过 api 请求商户授权:支持扫码或推送消息两种方式向商户发起授权。
方式一:申请授权二维码。
详见接口文档 。直连场景入参 merchant_no 填写商户支付宝 pid ,间连场景入参 merchant_no 填写商户 smid。
方式二:发送请求授权的消息,商家登录支付宝查看服务提醒。
详见接口文档 。直连场景入参 merchant_no 填写商户支付宝 pid ,间连场景入参 merchant_no 填写商户 smid。
商户登录支付宝 app 确认授权。
商户使用支付宝扫码或查看服务提醒。
间连场景(含直付通) 确认绑定间连商户号(smid)。
确认授权 isv 获取代运营权限。
获取商户授权结果:支持消息通知或主动查询两种方式获取授权结果。
方式一:主动查询。
接口文档详见 。直连场景出参 merchant_no 为商户支付宝 pid ,间连场景出参 bind_user_id 为商户支付宝 pid 。
方式二:消息通知。
接口文档详见 。直连场景出参 merchant_no 为商户支付宝 pid ,间连场景出参 bind_user_id 为商户支付宝 pid 。
注:
以上代运营授权相关接口入参 operate_type 需使用 operation_auth 。
如果服务商已在其他场景(如新蓝海报名等)获取商户代运营授权并且获取了商户支付宝 pid,此处无需重复操作授权。
门店是指商户支付宝账号名下的门店,获取商户门店代运营授权后,即可通过 蚂蚁门店管理 api 查询或创建门店id 。
服务商获取商户代运营门店授权后即可调用门店管理api,无需使用“第三方应用”授权。
调用相关接口时,无论是直连还是间连场景,入参 ip_role_id 均须使用商户支付宝 pid,不能使用 smid 。
创建新门店:收集设备所在门店信息,代商户创建门店 id,无需针对特殊类目增加额外入参(对接文档详见 蚂蚁门店管理)。
查询已有门店:从商户支付宝账户已有门店列表中选择设备所在门店,接口文档详见 。如果没有找到设备所在的门店,则需要创建新门店。
注:
需获取商户支付宝 pid 名下的 门店 id ,不能使用 smid 创建门店 id 。
未对接api的情况下,可以登录 ,针对已授权门店代运营的商家,查询或创建门店id。
上报设备 id 、设备所在商户支付宝 pid 以及设备所在门店 id 。
详见接口文档 。
注:
调用接口之前,需确保商户最近7天有在设备上完成刷脸收款的记录,否则无法绑定成功。
直连场景以支付签约 pid 为准,间连场景(含直付通)以商户 smid 为准。
当设备更换商户或门店时需要调用接口更新绑定信息(无需解绑),更新成功后自动覆盖原有绑定信息。
接口入参 device_id_type 推荐使用 id ,即使用 biz_tid (设备 id )作为设备唯一识别标识。获取设备 id 的方法:
开发iot小程序:iot小程序开发请参见 iot 小程序接入指南,获取设备id的方法请参见 获取系统属性 接口。
开发iot 应用:iot应用开发请参见 iotsdk开发文档,获取设备id的方法请参见 设备信息 接口。
通过蜻蜓系统设置页面查看:详见 。
支持使用设备编号查询在前述流程中已绑定的信息。
详见接口文档 。
更新设备三绑定信息:当设备更换商户或门店时需要调用设备三绑定 api 更新绑定信息(无需解绑)。
说明:
如果您在调用 api 时出现报错:
欢迎前往 提问、留言。
在 中根据错误码的类型,查找相关错误码及凯发app官方网站的解决方案。
在 中排查遇到的问题。
您还可以在 直接搜索您要的答案。