aliSmilePay

立即使用

zolozGetMetaInfo zolozVerify

概述

此模块封装了支付宝刷脸付中的客户端人脸识别sdk。

接入支付宝刷脸付需要在支付宝开放平台创建应用并通过审核,具体请查看支付宝刷脸付集成文档

硬件要求

“刷脸付”软件应用需要部署在带有指定 3D 摄像头并且通过蚂蚁验证的硬件设备上(以下称为 IOT 刷脸设备)才可正常使用。

  • 如果您已有 IOT 刷脸设备,则可在签约“刷脸付”之后,找技术服务同学咨询集成的操作流程;
  • 如果您目前没有IOT刷脸设备,可点击 自助收银机具介绍 以及 智能售卖机具介绍 下载附件,直接联系厂商进行购买;
  • 如果您是设备厂商,可参考 刷脸付设备入驻流程
    • 申请成为蚂蚁 IOT 刷脸设备提供商。

刷脸付流程

  • 获取刷脸所需的设备信息(模块接口:zolozGetMetaInfo)
  • 刷脸初始化(调用接口在服务端实现)
  • 唤起人脸识别(模块接口:zolozVerify)
  • 查询接口得到UID(调用接口在服务端实现)
  • 调用收单接口完成支付(调用接口在服务端实现)

zolozGetMetaInfo

采集刷脸所需的设备信息并完成刷脸的准备工作。如果返回成功结果,则请求商户服务端调用支付宝开放平台的人脸初始化接口。

zolozGetMetaInfo(params, callback(ret))

params

merchantId:

  • 类型:字符串类型
  • 描述:签约商户的pid。以2088开头

partnerId:

  • 类型:字符串类型
  • 描述:(可选项) ISV的pid。对于自用型商户,填写签约商户的pid,和merchantId保持一致

appId:

  • 类型:字符串类型
  • 描述:(可选项) 支付宝分配给开发者的应用ID,和当面付请求的appid保持一致。

deviceNum:

  • 类型:字符串类型
  • 描述:商户机具终端编号,和当面付请求的terminal_id 保持一致

storeCode:

  • 类型:字符串类型
  • 描述:(可选项)商户门店编号,和当面付请求的store_id保持一致。

alipayStoreCode:

  • 类型:字符串类型
  • 描述: (可选项) 支付宝内部门店编号,和当面付请求中的alipay_store_id保持一致

extPar:

  • 类型:Json对象类型
  • 描述: (可选项) 其他参数,name为key,value为value

callback(ret,err)

ret:

  • 类型:JSON对象
  • 描述:正确返回
  • 内部字段:
  1. {status:, //布尔类型;是否添加成功
  2. metaInfo:, //字符串类型,此参数需要给服务端做刷脸初始化。内部字段:apdidToken/设备指纹,appName/应用名称,appVersion/应用版本,bioMetaInfo/生物信息,osVersion/系统版本,machineInfo/设备硬件相关信息,merchantInfo/商户相关信息,remoteLogID/刷脸调用的事务ID,extInfo/扩展参数,用于商户服务端传入信息
  3. }

err:

  • 类型:JSON对象
  • 描述:错误返回
  • 内部字段:
  1. {
  2. code:'' //字符串类型;返回码;1000/调用成功,1003/用户选择退出,1004/超时,1005/用户选用其他支付方式
  3. }

示例代码

  1. var aliSmilePay = api.require('aliSmilePay');
  2. aliSmilePay.zolozGetMetaInfo({
  3. merchantId:'',
  4. partnerId:'',
  5. appId:'',
  6. deviceNum:'',
  7. storeCode:'',
  8. alipayStoreCode:'',
  9. }, function(ret,err) {
  10. alert(ret);
  11. });

可用性

android系统

可提供的1.0.0及更高版本

zolozVerify

唤起人脸识别。如果认证成功,将返回一个ftoken。该ftoken用于后续查询被认证用户的信息

zolozVerify(params, callback(ret))

params

zimId:

  • 类型:字符串类型
  • 描述:刷脸付token,根据zolozGetMetaInfo接口返回的数据从服务端获取得到

protocal:

  • 类型:字符串类型
  • 描述:刷脸付协议。根据zolozGetMetaInfo接口返回的数据从服务端获取得到

smileMode:

  • 类型:数字类型
  • 描述:(可选项)指定选择刷脸模式,0:主屏幕显示;1:双面屏机具,副屏幕显示
  • 默认:0

callback(ret,err)

ret:

  • 类型:JSON对象
  • 描述:正确返回
  • 内部字段:
  1. {status:, //布尔类型;是否添加成功
  2. fToken:‘’, //字符串类型,用来支付或完成其他操作
  3. subCode:‘’, //字符串类型,二级返回码
  4. msg:‘’, //字符串类型,返回信息
  5. result:{ //Json对象类型;
  6. alipayUid:'', //字符串类型;支付宝账户的uid,这个UID是客户端接口返回的结果,并不安全。如果需要依赖UID进行业务决策,请不要使用这个UID数据。请通过服务端ftoken查询接口(query)得到可信的UID
  7. }
  8. }

err:

  • 类型:JSON对象
  • 描述:错误返回
  • 内部字段:
  1. {
  2. code:'' //字符串类型;返回码;1000/调用成功,1003/用户选择退出,1004/超时,1005/用户选用其他支付方式
  3. }

示例代码

  1. var aliSmilePay = api.require('aliSmilePay');
  2. aliSmilePay.zolozVerify({
  3. zimId:'',
  4. protocal:'',
  5. }, function(ret,err) {
  6. alert(ret);
  7. });

可用性

android系统

可提供的1.0.0及更高版本