mirror of
https://gitee.com/binary/weixin-java-tools.git
synced 2025-04-05 17:38:05 +08:00
✨ #1248 增加微信刷脸支付支持相关接口
* 增加获取微信刷脸调用凭证接口 * 增加微信刷脸接口 1. 获取刷脸支付凭证接口 2. 刷脸支付接口
This commit is contained in:
dingzhiwei
Binary Wang
parent
d184ff8303
commit
8dffbd4fdb
@ -0,0 +1,126 @@
|
||||
package com.github.binarywang.wxpay.bean.request;
|
||||
|
||||
import com.thoughtworks.xstream.annotations.XStreamAlias;
|
||||
import lombok.*;
|
||||
import me.chanjar.weixin.common.annotation.Required;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 获取微信刷脸调用凭证请求对象类
|
||||
* 详见文档：https://pay.weixin.qq.com/wiki/doc/wxfacepay/develop/sdk-android.html#获取数据-getwxpayfacerawdata
|
||||
* Created by Jmdhappy on 2019-09-04.
|
||||
* </pre>
|
||||
*
|
||||
* @author <a href="https://github.com/jmdhappy/xxpay-master">XxPay</a>
|
||||
*/
|
||||
@Data
|
||||
@EqualsAndHashCode(callSuper = true)
|
||||
@Builder(builderMethodName = "newBuilder")
|
||||
@NoArgsConstructor
|
||||
@AllArgsConstructor
|
||||
@XStreamAlias("xml")
|
||||
public class WxPayFaceAuthInfoRequest extends BaseWxPayRequest {
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：门店编号
|
||||
* 变量名：store_id
|
||||
* 是否必填：是
|
||||
* 类型：string(32)
|
||||
* 示例值：1001
|
||||
* 描述：门店编号， 由商户定义， 各门店唯一
|
||||
* </pre>
|
||||
*/
|
||||
@Required
|
||||
@XStreamAlias("store_id")
|
||||
private String storeId;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：门店名称
|
||||
* 变量名：store_name
|
||||
* 是否必填：是
|
||||
* 类型：string(128)
|
||||
* 示例值：骏易科技
|
||||
* 描述：门店名称，由商户定义。（可用于展示）
|
||||
* </pre>
|
||||
*/
|
||||
@Required
|
||||
@XStreamAlias("store_name")
|
||||
private String storeName;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：终端设备编号
|
||||
* 变量名：device_id
|
||||
* 是否必填：是
|
||||
* 类型：string(32)
|
||||
* 示例值：
|
||||
* 描述：终端设备编号，由商户定义。
|
||||
* </pre>
|
||||
*/
|
||||
@Required
|
||||
@XStreamAlias("device_id")
|
||||
private String deviceId;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：附加字段
|
||||
* 变量名：attach
|
||||
* 是否必填：是
|
||||
* 类型：string
|
||||
* 示例值：
|
||||
* 描述：附加字段。字段格式使用Json
|
||||
* </pre>
|
||||
*/
|
||||
@XStreamAlias("attach")
|
||||
private String attach;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：初始化数据
|
||||
* 变量名：attach
|
||||
* 是否必填：是
|
||||
* 类型：string(2048)
|
||||
* 示例值：
|
||||
* 描述：初始化数据。由微信人脸SDK的接口返回。
|
||||
* </pre>
|
||||
*/
|
||||
@Required
|
||||
@XStreamAlias("rawdata")
|
||||
private String rawdata;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：当前时间
|
||||
* 变量名：now
|
||||
* 是否必填：否
|
||||
* 类型：String(10)
|
||||
* 示例值：1239878956
|
||||
* 描述：取当前时间，10位unix时间戳。 例如：1239878956
|
||||
* </pre>
|
||||
*/
|
||||
@Required
|
||||
@XStreamAlias("now")
|
||||
private String now;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：接口版本号.
|
||||
* 变量名：version
|
||||
* 是否必填：是
|
||||
* 类型：String
|
||||
* 示例值：1.0
|
||||
* 描述：版本号。固定为1
|
||||
* </pre>
|
||||
*/
|
||||
@Required
|
||||
@XStreamAlias("version")
|
||||
private String version;
|
||||
|
||||
@Override
|
||||
protected void checkConstraints() {
|
||||
//do nothing
|
||||
}
|
||||
|
||||
}
|
||||
@ -0,0 +1,177 @@
|
||||
package com.github.binarywang.wxpay.bean.request;
|
||||
|
||||
import com.thoughtworks.xstream.annotations.XStreamAlias;
|
||||
import lombok.*;
|
||||
import me.chanjar.weixin.common.annotation.Required;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 提交刷脸支付请求对象类
|
||||
* 详见文档：微信人脸支付商户开发文档
|
||||
* Created by Jmdhappy on 2019-09-05.
|
||||
* </pre>
|
||||
*
|
||||
* @author <a href="https://github.com/jmdhappy/xxpay-master">XxPay</a>
|
||||
*/
|
||||
@Data
|
||||
@EqualsAndHashCode(callSuper = true)
|
||||
@Builder(builderMethodName = "newBuilder")
|
||||
@NoArgsConstructor
|
||||
@AllArgsConstructor
|
||||
@XStreamAlias("xml")
|
||||
public class WxPayFacepayRequest extends BaseWxPayRequest {
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：设备号.
|
||||
* 变量名：device_info
|
||||
* 是否必填：否
|
||||
* 类型：String(32)
|
||||
* 示例值：013467007045764
|
||||
* 描述：终端设备号(商户自定义，如门店编号)
|
||||
* </pre>
|
||||
*/
|
||||
@XStreamAlias("device_info")
|
||||
private String deviceInfo;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：商品描述.
|
||||
* 变量名：body
|
||||
* 是否必填：是
|
||||
* 类型：String(128)
|
||||
* 示例值：image形象店-深圳腾大- QQ公仔
|
||||
* 描述：商品或支付单简要描述，格式要求：门店品牌名-城市分店名-实际商品名称
|
||||
* </pre>
|
||||
**/
|
||||
@Required
|
||||
@XStreamAlias("body")
|
||||
private String body;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：商品详情.
|
||||
* 变量名：detail
|
||||
* 是否必填：否
|
||||
* 类型：String(8192)
|
||||
* 示例值：
|
||||
* 描述：商品详细列表，使用Json格式，传输签名前请务必使用CDATA标签将JSON文本串保护起来。</pre>
|
||||
**/
|
||||
@XStreamAlias("detail")
|
||||
private String detail;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：附加数据.
|
||||
* 变量名：attach
|
||||
* 是否必填：否
|
||||
* 类型：String(127)
|
||||
* 示例值：说明
|
||||
* 描述：附加数据，在查询API和支付通知中原样返回，该字段主要用于商户携带订单的自定义数据
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("attach")
|
||||
private String attach;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：商户订单号.
|
||||
* 变量名：out_trade_no
|
||||
* 是否必填：是
|
||||
* 类型：String(32)
|
||||
* 示例值：1217752501201407033233368018
|
||||
* 描述：商户系统内部的订单号,32个字符内、可包含字母；更换授权码必须要换新的商户订单号 其他说明见商户订单号
|
||||
* </pre>
|
||||
**/
|
||||
@Required
|
||||
@XStreamAlias("out_trade_no")
|
||||
private String outTradeNo;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：总金额.
|
||||
* 变量名：total_fee
|
||||
* 是否必填：是
|
||||
* 类型：Int
|
||||
* 示例值：888
|
||||
* 描述：订单总金额，单位为分，只能为整数，详见支付金额
|
||||
* </pre>
|
||||
**/
|
||||
@Required
|
||||
@XStreamAlias("total_fee")
|
||||
private Integer totalFee;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：货币类型.
|
||||
* 变量名：fee_type
|
||||
* 是否必填：否
|
||||
* 类型：String(16)
|
||||
* 示例值：CNY
|
||||
* 描述：符合ISO4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("fee_type")
|
||||
private String feeType;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：终端IP.
|
||||
* 变量名：spbill_create_ip
|
||||
* 是否必填：是
|
||||
* 类型：String(16)
|
||||
* 示例值：127.0.0.1
|
||||
* 描述：调用微信支付API的机器IP
|
||||
* </pre>
|
||||
**/
|
||||
@Required
|
||||
@XStreamAlias("spbill_create_ip")
|
||||
private String spbillCreateIp;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：商品标记.
|
||||
* 变量名：goods_tag
|
||||
* 是否必填：否
|
||||
* 类型：String(32)
|
||||
* 示例值：1234
|
||||
* 描述：商品标记，代金券或立减优惠功能的参数，说明详见代金券或立减优惠
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("goods_tag")
|
||||
private String goodsTag;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：用户标识.
|
||||
* 变量名：openid
|
||||
* 是否必填：是
|
||||
* 类型：String(128)
|
||||
* 示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
|
||||
* 描述：用户在商户appid 下的唯一标识
|
||||
* </pre>
|
||||
*/
|
||||
@Required
|
||||
@XStreamAlias("openid")
|
||||
private String openid;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：人脸凭证.
|
||||
* 变量名：face_code
|
||||
* 是否必填：是
|
||||
* 类型：String(128)
|
||||
* 示例值：
|
||||
* 描述：人脸凭证，用于刷脸支付
|
||||
* </pre>
|
||||
**/
|
||||
@Required
|
||||
@XStreamAlias("face_code")
|
||||
private String faceCode;
|
||||
|
||||
@Override
|
||||
protected void checkConstraints() {
|
||||
//do nothing
|
||||
}
|
||||
|
||||
}
|
||||
@ -0,0 +1,38 @@
|
||||
package com.github.binarywang.wxpay.bean.result;
|
||||
|
||||
import com.thoughtworks.xstream.annotations.XStreamAlias;
|
||||
import lombok.Data;
|
||||
import lombok.EqualsAndHashCode;
|
||||
import lombok.NoArgsConstructor;
|
||||
|
||||
import java.io.Serializable;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 获取微信刷脸调用凭证返回结果.
|
||||
* 详见文档：https://pay.weixin.qq.com/wiki/doc/wxfacepay/develop/sdk-android.html#获取数据-getwxpayfacerawdata
|
||||
* </pre>
|
||||
*
|
||||
* @author Jmdhappy
|
||||
*/
|
||||
@Data
|
||||
@EqualsAndHashCode(callSuper = true)
|
||||
@NoArgsConstructor
|
||||
@XStreamAlias("xml")
|
||||
public class WxPayFaceAuthInfoResult extends BaseWxPayResult implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = -65138145275211272L;
|
||||
|
||||
/**
|
||||
* SDK调用凭证.
|
||||
*/
|
||||
@XStreamAlias("authinfo")
|
||||
private String authinfo;
|
||||
|
||||
/**
|
||||
* authinfo的有效时间, 单位秒.
|
||||
*/
|
||||
@XStreamAlias("expires_in")
|
||||
private String expiresIn;
|
||||
|
||||
}
|
||||
@ -0,0 +1,245 @@
|
||||
package com.github.binarywang.wxpay.bean.result;
|
||||
|
||||
import com.thoughtworks.xstream.annotations.XStreamAlias;
|
||||
import lombok.Data;
|
||||
import lombok.EqualsAndHashCode;
|
||||
import lombok.NoArgsConstructor;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 提交书刷脸支付接口响应结果对象类
|
||||
* Created by Jmdhappy on 2019-09-05.
|
||||
* </pre>
|
||||
*
|
||||
* @author <a href="https://github.com/jmdhappy/xxpay-master">XxPay</a>
|
||||
*/
|
||||
@Data
|
||||
@EqualsAndHashCode(callSuper = true)
|
||||
@NoArgsConstructor
|
||||
@XStreamAlias("xml")
|
||||
public class WxPayFacepayResult extends BaseWxPayResult {
|
||||
|
||||
private static final long serialVersionUID = -4116580976046716911L;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 设备号.
|
||||
* device_info
|
||||
* 否
|
||||
* String(32)
|
||||
* 013467007045764
|
||||
* 调用接口提交的终端设备号
|
||||
* </pre>
|
||||
*/
|
||||
@XStreamAlias("device_info")
|
||||
private String deviceInfo;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 用户标识.
|
||||
* openid
|
||||
* 是
|
||||
* String(128)
|
||||
* Y
|
||||
* 用户在商户appid 下的唯一标识
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("openid")
|
||||
private String openid;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 是否关注公众账号.
|
||||
* is_subscribe
|
||||
* 是
|
||||
* String(1)
|
||||
* Y
|
||||
* 用户是否关注公众账号，仅在公众账号类型支付有效，取值范围：Y或N;Y-关注;N-未关注
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("is_subscribe")
|
||||
private String isSubscribe;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 用户子标识.
|
||||
* sub_openid
|
||||
* 否
|
||||
* String(128)
|
||||
* Y
|
||||
* 子商户appid下用户唯一标识，如需返回则请求时需要传sub_appid
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("sub_openid")
|
||||
private String subOpenid;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 是否关注子公众账号.
|
||||
* sub_is_subscribe
|
||||
* 是
|
||||
* String(1)
|
||||
* Y
|
||||
* 用户是否关注子公众账号，仅在公众账号类型支付有效，取值范围：Y或N;Y-关注;N-未关注
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("sub_is_subscribe")
|
||||
private String subsSubscribe;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 交易类型.
|
||||
* trade_type
|
||||
* 是
|
||||
* String(16)
|
||||
* FACEPAY
|
||||
* 支付类型为 FACEPAY(即刷脸支付)
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("trade_type")
|
||||
private String tradeType;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 付款银行.
|
||||
* bank_type
|
||||
* 是
|
||||
* String(32)
|
||||
* CMC
|
||||
* 银行类型，采用字符串类型的银行标识，值列表详见银行类型
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("bank_type")
|
||||
private String bankType;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 货币类型.
|
||||
* fee_type
|
||||
* 否
|
||||
* String(16)
|
||||
* CNY
|
||||
* 符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("fee_type")
|
||||
private String feeType;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 订单金额.
|
||||
* total_fee
|
||||
* 是
|
||||
* Int
|
||||
* 888
|
||||
* 订单总金额，单位为分，只能为整数，详见支付金额
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("total_fee")
|
||||
private Integer totalFee;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 现金支付货币类型.
|
||||
* cash_fee_type
|
||||
* 否
|
||||
* String(16)
|
||||
* CNY
|
||||
* 符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("cash_fee_type")
|
||||
private String cashFeeType;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 现金支付金额.
|
||||
* cash_fee
|
||||
* 是
|
||||
* Int
|
||||
* 100
|
||||
* 订单现金支付金额，详见支付金额
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("cash_fee")
|
||||
private Integer cashFee;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 微信支付订单号.
|
||||
* transaction_id
|
||||
* 是
|
||||
* String(32)
|
||||
* 1217752501201407033233368018
|
||||
* 微信支付订单号
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("transaction_id")
|
||||
private String transactionId;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 商户订单号.
|
||||
* out_trade_no
|
||||
* 是
|
||||
* String(32)
|
||||
* 1217752501201407033233368018
|
||||
* 商户系统的订单号，与请求一致。
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("out_trade_no")
|
||||
private String outTradeNo;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 商品详情.
|
||||
* detail
|
||||
* 否
|
||||
* String(8192)
|
||||
* 与提交数据一致
|
||||
* 实际提交的返回
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("detail")
|
||||
private String detail;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 商家数据包.
|
||||
* attach
|
||||
* 否
|
||||
* String(128)
|
||||
* 123456
|
||||
* 商家数据包，原样返回
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("attach")
|
||||
private String attach;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 营销详情.
|
||||
* promotion_detail
|
||||
* 否
|
||||
* String(6000)
|
||||
* 示例见下文
|
||||
* 新增返回，单品优惠功能字段，需要接入请见详细说明
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("promotion_detail")
|
||||
private String promotionDetail;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 支付完成时间.
|
||||
* time_end
|
||||
* 是
|
||||
* String(14)
|
||||
* 20141030133525
|
||||
* 订单生成时间，格式为yyyyMMddHHmmss，如2009年12月25日9点10分10秒表示为20091225091010。详见时间规则
|
||||
* </pre>
|
||||
**/
|
||||
@XStreamAlias("time_end")
|
||||
private String timeEnd;
|
||||
|
||||
}
|
||||
@ -704,4 +704,37 @@ public interface WxPayService {
|
||||
* @throws WxPayException the wx pay exception
|
||||
*/
|
||||
String queryComment(WxPayQueryCommentRequest request) throws WxPayException;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 获取微信刷脸支付凭证.
|
||||
* 接口请求链接：https://payapp.weixin.qq.com/face/get_wxpayface_authinfo
|
||||
* 文档地址：https://pay.weixin.qq.com/wiki/doc/api/tools/sp_coupon.php?chapter=12_5
|
||||
* </pre>
|
||||
*
|
||||
* @param request the request
|
||||
* @return the wx pay get face authinfo result
|
||||
* @throws WxPayException the wx pay exception
|
||||
*/
|
||||
WxPayFaceAuthInfoResult getWxPayFaceAuthInfo(WxPayFaceAuthInfoRequest request) throws WxPayException;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 提交刷脸支付.
|
||||
* 文档地址：https://share.weiyun.com/5dxUgCw
|
||||
* 应用场景：
|
||||
* 用户在商超，便利店，餐饮等场景，在屏幕上通过刷脸完成支付。
|
||||
* 步骤1：用户在自助收银机上点击“刷脸支付”；
|
||||
* 步骤2：发起人脸识别，摄像头自动抓取识别用户人脸，提示用户输入11位手机号码；
|
||||
* 步骤3：商户收银系统提交刷脸支付；
|
||||
* 步骤4：微信支付后台收到支付请求，验证人脸信息，返回支付结果给商户收银系统。
|
||||
* 是否需要证书：不需要。
|
||||
* </pre>
|
||||
*
|
||||
* @param request the request
|
||||
* @return the wx pay facepay result
|
||||
* @throws WxPayException the wx pay exception
|
||||
*/
|
||||
WxPayFacepayResult facepay(WxPayFacepayRequest request) throws WxPayException;
|
||||
|
||||
}
|
||||
|
||||
@ -788,4 +788,25 @@ public abstract class BaseWxPayServiceImpl implements WxPayService {
|
||||
return responseContent;
|
||||
}
|
||||
|
||||
@Override
|
||||
public WxPayFaceAuthInfoResult getWxPayFaceAuthInfo(WxPayFaceAuthInfoRequest request) throws WxPayException {
|
||||
request.checkAndSign(this.getConfig());
|
||||
String url = "https://payapp.weixin.qq.com/face/get_wxpayface_authinfo";
|
||||
String responseContent = this.post(url, request.toXML(), false);
|
||||
WxPayFaceAuthInfoResult result = BaseWxPayResult.fromXML(responseContent, WxPayFaceAuthInfoResult.class);
|
||||
result.checkResult(this, request.getSignType(), true);
|
||||
return result;
|
||||
}
|
||||
|
||||
@Override
|
||||
public WxPayFacepayResult facepay(WxPayFacepayRequest request) throws WxPayException {
|
||||
request.checkAndSign(this.getConfig());
|
||||
|
||||
String url = this.getPayBaseUrl() + "/pay/facepay";
|
||||
String responseContent = this.post(url, request.toXML(), false);
|
||||
WxPayFacepayResult result = BaseWxPayResult.fromXML(responseContent, WxPayFacepayResult.class);
|
||||
result.checkResult(this, request.getSignType(), true);
|
||||
return result;
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
Loading…
Reference in New Issue
Block a user