扫脸支付/smilepay

刷脸API:

https://docs.alipay.com/pre-open/20180402104715814204/quickstart

https://doc.open.alipay.com/docs/doc.htm?docType=1&articleId=108568

这里一定要详细了解官方提供的API,我这里这是我当时接入的流程给大家在解说一下,避免一些不必要的坑.

一.介绍
1.刷脸服务:
    刷脸支付是支付宝基于人工智能、生物识别、大数据风控技术，最新实现的新型支付方式。用户在无需携带任何设备情况下，2.通过刷脸完成支付。
核心能力:
    通过手机号+脸，获得用户的支付宝UID，与支付业务结合完成刷脸支付，让支付更便捷！
3.用户范围:
    目前刷脸支付，仅面向大陆+实名的支付宝用户开放，简单说有中国身份证号的支付宝用户，可以使用。

二,接入
第一步：创建应用
第二步：配置密钥
第三步：搭建和配置开发环境
1.下载服务端SDK
2.接口调用配置
第四步：接口调用

这里就不细说了, API上都有说明,大家看看就明白了.

其实上面这些流程都是前期准备的,看API就能弄好,

技术接入流程图:

项目依赖:

<dependency>
   <groupId>com.alipay.api</groupId>
   <artifactId>alipay-sdk-java</artifactId>
   <version>3.0.52.ALL</version>
</dependency>

<dependency>
   <groupId>commons-logging</groupId>
   <artifactId>commons-logging</artifactId>
   <version>1.1.3</version>
</dependency>

guanfangshuo     这里详细说一如何调用接口调用.
1.服务初始化:
开发者通过该接口启动蚂蚁佐罗的服务初始化，进而使用刷脸识别用户的服务。

/**
     * zoloz install，zoloz app install
     *
     * @param info
     * @return
     */
    public void zolozInstall(final Map info)

入参Map的key，value说明如下：
Key名称 Value说明
merchantId 必填项，签约商户的pid。来自蚂蚁开放平台，示例："2088011211821038"
partnerId 必填项，ISV的pid。对于自用型商户，填写签约商户的pid，和merchantId保持一致
appId 必填项，支付宝分配给开发者的应用ID，和当面付请求的appid保持一致。
deviceNum 必填项，商户机具终端编号，和当面付请求的terminal_id 保持一致
storeCode 可选，商户门店编号，和当面付请求的store_id保持一致，如果当面付请求中传入了store_id，这里也需要传入
deviceMac 可选，设备Mac 地址，例如："CC:B8:A8:0F:63:3C"
brandCode 可选， 品牌编码，商户自定义
areaCode 可选，区域编码，商户自定义
geo 可选，机具坐标，例如"0.000000,0.000000"
wifiMac 可选，wifi Mac地址
wifiName 可选，wifi Mac名字
2.获取设备信:
/**
     * zoloz getMetaInfo，zoloz获取metaInfo
     *
     * @param info
     * @param zolozCallback
     * @return
     */
    public void zolozGetMetaInfo(final Map info, final ZolozCallback zolozCallback)

入参Map的key，value说明如下：
Key名称 Value说明
merchantId 必填项，签约商户的pid。来自蚂蚁开放平台，示例："2088011211821038"
partnerId 必填项，ISV的pid。对于自用型商户，填写签约商户的pid，和merchantId保持一致
appId 必填项，支付宝分配给开发者的应用ID，和当面付请求的appid保持一致。
deviceNum 必填项，商户机具终端编号，和当面付请求的terminal_id 保持一致
storeCode 可选，商户门店编号，和当面付请求的store_id保持一致，如果当面付请求中传入了store_id，这里也需要传入
deviceMac 可选，设备Mac 地址，例如："CC:B8:A8:0F:63:3C"
brandCode 可选， 品牌编码，商户自定义
areaCode 可选，区域编码，商户自定义
geo 可选，机具坐标，例如"0.000000,0.000000"
wifiMac 可选，wifi Mac地址
wifiName 可选，wifi Mac名字
3.人脸初始化:
通过该接口获取刷脸服务的初始化信息。
这里详细说一下
首先这里使用支付宝的DefaultAlipayClient进行调用,同时支付宝提供了一个属性ZolozAuthenticationCustomerSmilepayInitializeRequest,在这里设置你的业务参数
ZolozAuthenticationCustomerSmilepayInitializeRequest request = new ZolozAuthenticationCustomerSmilepayInitializeRequest();
         request.setBizContent(JsonUtils.convertObjectToString(*));
在去执行alipayClient中的execute方法,获取响应信息,这里已经封装好了, 直接就会调用支付的刷脸初始化接口了,还是很简单的.
ZolozAuthenticationCustomerSmilepayInitializeResponse response = alipayClient.execute(request);
而支付宝提供的响应信息并不是很详细, 需要实际进行调用,观察日志才是最全的,(这里是一个坑,我已经踩过了,就把我打出的日志信息给大家)   
{
                      "businessCode": 业务方设置的code码,
                      "resultObject": {
                                                "zimId": "2af0963d558620d5156d10e4c5575a0e",
                                                  "zimInitClientData": "{
                             /**很多信息*/
                                    }"
                                                },
                      "success": true
                }    
支付宝会返回给你两个重要的的信息1.zimId和zimInitClientData,而支付宝API只说到了zimid,但是这两个字段信息都是非常重要的,在下面的逻辑中都会用到,开始我们只传了zimid去调用换脸识别接口,
支付宝只给返回code=1061的信息,这让我们当时很尴尬, 找了很长时间,才发现这个问题.所以这里大家注意一下
4.唤起人脸识别:
开发者通过该接口唤起人脸识别流程。

/**
     * zoloz verify，zoloz调用smile2pay
     *
     * @param zimId
     * @param params
     * @param zolozCallback
     * @return
     */
    public void zolozVerify(final String zimId, final Map params, ZolozCallback zolozCallback)


参数名称 参数类型 参数说明
zimId String 人脸初始化接口返回的zimId, 其中包含了唤起人脸验证的关键参数
params Map 与zolozInstall和zolozGetMetaInfo中传入的Map一致


这里两个参数分别是上面我们人脸初始化获取的两个信息字段, 传进来就可以真正调用刷脸功能了.


*这里说一下:
刷脸支付调用alipay.trade.pay时auth_code取值为ftoken,且scene=security_code,所以你首先要有一个条码支付的接口
ftoken:是唤醒人脸识别ZolozCallback zolozCallback 给返回的
security_code:场景码,这个设置一个常量set进去就ok了
5.服务释放:
开发者通过该接口释放刷脸sdk的服务。
/**
     * zoloz uninstall，zoloz app uninstall
     *
     * @param
     * @return
     */
    public void zolozUninstall() 

到这里整个刷脸识别支付过程就完成了.虽然说支付宝给的API一般吧,但是细心读取,还是有搞头的,这里建议大家首先开发出一套完整的支付系统 ,支付提供的API:https://docs.open.alipay.com/api_1/alipay.trade.fastpay.refund.query

然后在开发刷脸支付就简单多了.

这里就说到这, 大家如果用到的话,哪里不明白可以评论.