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