🆕 #1744 微信支付增加电商收付通-普通支付相关接口

* new:电商收付通普通支付

Co-authored-by: 曾浩 <epdcgsi@dingtalk.com>
This commit is contained in:
cloudX 2020-09-09 11:32:43 +08:00 committed by GitHub
parent dfec2e3aef
commit 935988530d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
6 changed files with 685 additions and 15 deletions

View File

@ -8,7 +8,10 @@ import java.io.Serializable;
import java.util.List;
/**
* 合单支付 对象
* 合单支付API
* <pre>
* 文档地址:https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/pages/e-combine.shtml
* </pre>
*/
@Data
@NoArgsConstructor

View File

@ -0,0 +1,654 @@
package com.github.binarywang.wxpay.bean.ecommerce;
import com.google.gson.annotations.SerializedName;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.io.Serializable;
import java.math.BigDecimal;
import java.util.List;
/**
* 普通支付电商收付通API
* <pre>
* 文档地址:https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/pages/e_transactions.shtml
* </pre>
*/
@Data
@NoArgsConstructor
public class PartnerTransactionsRequest implements Serializable {
/**
* <pre>
* 字段名服务商公众号ID
* 变量名sp_appid
* 是否必填
* 类型string32
* 描述
* 服务商申请的公众号或移动应用appid
* 示例值wx8888888888888888
* </pre>
*/
@SerializedName(value = "sp_appid")
private String spAppid;
/**
* <pre>
* 字段名服务商户号
* 变量名sp_mchid
* 是否必填
* 类型string32
* 描述
* 服务商户号由微信支付生成并下发
* 示例值1230000109
* </pre>
*/
@SerializedName(value = "sp_mchid")
private String spMchid;
/**
* <pre>
* 字段名子商户公众号ID
* 变量名sub_appid
* 是否必填
* 类型string32
* 描述
* 子商户申请的公众号或移动应用appid
* 示例值wxd678efh567hg6999
* </pre>
*/
@SerializedName(value = "sub_appid")
private String subAppid;
/**
* <pre>
* 字段名二级商户号
* 变量名sub_mchid
* 是否必填
* 类型string32
* 描述
* 二级商户的商户号有微信支付生成并下发
* 示例值1900000109
* </pre>
*/
@SerializedName(value = "sub_mchid")
private String subMchid;
/**
* <pre>
* 字段名商品描述
* 变量名description
* 是否必填
* 类型string127
* 描述
* 商品描述
* 示例值Image形象店-深圳腾大-QQ公仔
* </pre>
*/
@SerializedName(value = "description")
private String description;
/**
* <pre>
* 字段名商户订单号
* 变量名out_trade_no
* 是否必填
* 类型string127
* 描述
* 商户系统内部订单号, 只能是数字大小写字母_-*且在同一个商户号下唯一详见商户订单号
* 特殊规则最小字符长度为6
* 示例值1217752501201407033233368018
* </pre>
*/
@SerializedName(value = "out_trade_no")
private String out_trade_no;
/**
* <pre>
* 字段名交易结束时间
* 变量名time_expire
* 是否必填
* 类型string(14)
* 描述
* 订单失效时间遵循rfc3339标准格式格式为YYYY-MM-DDTHH:mm:ss+TIMEZONEYYYY-MM-DD表示年月日T出现在字符串中表示time元素的开头HH:mm:ss表示时分秒TIMEZONE表示时区+08:00表示东八区时间领先UTC 8小时即北京时间例如2015-05-20T13:29:35+08:00表示北京时间2015年5月20日 13点29分35秒
* 示例值2019-12-31T15:59:60+08:00
* </pre>
*/
@SerializedName(value = "time_expire")
private String timeExpire;
/**
* <pre>
* 字段名附加数据
* 变量名attach
* 是否必填
* 类型string(128)
* 描述
* 附加数据在查询API和支付通知中原样返回可作为自定义参数使用
* 示例值自定义数据
* </pre>
*/
@SerializedName(value = "attach")
private String attach;
/**
* <pre>
* 字段名通知地址
* 变量名notify_url
* 是否必填
* 类型string127
* 描述
* 通知URL必须为直接可访问的URL不允许携带查询串
* 示例值https://www.weixin.qq.com/wxpay/pay.php
* </pre>
*/
@SerializedName(value = "notify_url")
private String notifyUrl;
/**
* <pre>
* 字段名订单优惠标记
* 变量名goods_tag
* 是否必填
* 类型string32
* 描述
* 订单优惠标记
* 示例值WXG
* </pre>
*/
@SerializedName(value = "goods_tag")
private String goodsTag;
/**
* <pre>
* 字段名+结算信息
* 变量名settle_info
* 是否必填
* 类型Object
* 描述结算信息
* </pre>
*/
@SerializedName(value = "settle_info")
private SettleInfo settleInfo;
/**
* <pre>
* 字段名订单金额
* 变量名amount
* 是否必填
* 类型object
* 描述
* 订单金额信息
* </pre>
*/
@SerializedName(value = "amount")
private Amount amount;
/**
* <pre>
* 字段名优惠功能
* 变量名detail
* 是否必填
* 类型object
* 描述
* 优惠功能
* </pre>
*/
@SerializedName(value = "detail")
private Discount detail;
/**
* <pre>
* 字段名支付者
* 变量名payer
* 是否必填仅JSAPI支付必传
* 类型object
* 描述
* 支付者信息
* </pre>
*/
@SerializedName(value = "payer")
private Payer payer;
/**
* <pre>
* 字段名场景信息
* 变量名scene_info
* 是否必填仅H5支付必传
* 类型object
* 描述
* 支付场景描述
* </pre>
*/
@SerializedName(value = "scene_info")
private SceneInfo sceneInfo;
@Data
@NoArgsConstructor
public static class Discount implements Serializable {
/**
* <pre>
* 字段名订单原价
* 变量名cost_price
* 是否必填
* 类型int64
* 描述
* 1商户侧一张小票订单可能被分多次支付订单原价用于记录整张小票的交易金额
* 2当订单原价与支付金额不相等则不享受优惠
* 3该字段主要用于防止同一张小票分多次支付以享受多次优惠的情况正常支付订单不必上传此参数
* 示例值608800
* </pre>
*/
@SerializedName(value = "cost_price")
private Integer costPrice;
/**
* <pre>
* 字段名商品小票ID
* 变量名invoice_id
* 是否必填
* 类型string32
* 描述
* 商品小票ID
* 示例值微信123
* </pre>
*/
@SerializedName(value = "invoice_id")
private Integer invoiceId;
/**
* <pre>
* 字段名单品列表
* 变量名goods_detail
* 是否必填
* 类型array
* 描述
* 单品列表信息
* 条目个数限制1undefined
* </pre>
*/
@SerializedName(value = "goods_detail")
private List<GoodsDetail> goodsDetails;
}
@Data
@NoArgsConstructor
public static class Amount implements Serializable {
/**
* <pre>
* 字段名总金额
* 变量名total
* 是否必填
* 类型int64
* 描述
* 订单总金额单位为分
* 示例值100
* </pre>
*/
@SerializedName(value = "total")
private Integer total;
/**
* <pre>
* 字段名币类型
* 变量名currency
* 是否必填
* 类型string(16)
* 描述
* CNY人民币境内商户号仅支持人民币
* 示例值CNY
* </pre>
*/
@SerializedName(value = "currency")
private String currency;
}
@Data
@NoArgsConstructor
public static class Payer implements Serializable {
/**
* <pre>
* 字段名用户服务标识
* 变量名sp_openid
* 是否必填
* 类型string(128)
* 描述
* 用户在服务商appid下的唯一标识
* 示例值oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
* </pre>
*/
@SerializedName(value = "sp_openid")
private String spOpenid;
/**
* <pre>
* 字段名用户子标识
* 变量名sub_openid
* 是否必填
* 类型string(128)
* 描述
* 用户在子商户appid下的唯一标识
* 示例值oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
* </pre>
*/
@SerializedName(value = "sub_openid")
private String subOpenid;
}
@Data
@NoArgsConstructor
public static class SettleInfo implements Serializable{
/**
* <pre>
* 字段名是否指定分账
* 变量名profit_sharing
* 是否必填
* 类型bool
* 描述
* 是否分账与外层profit_sharing同时存在时以本字段为准
* true
* false
* 示例值true
* </pre>
*/
@SerializedName(value = "profit_sharing")
private Boolean profitSharing;
/**
* <pre>
* 字段名补差金额
* 变量名subsidy_amount
* 是否必填
* 类型int64
* 描述
* SettleInfo.profit_sharing为true时该金额才生效
* 注意单笔订单最高补差金额为5000元
* 示例值10
* </pre>
*/
@SerializedName(value = "subsidy_amount")
private BigDecimal subsidyAmount;
}
@Data
@NoArgsConstructor
public static class GoodsDetail implements Serializable {
/**
* <pre>
* 字段名商户侧商品编码
* 变量名merchant_goods_id
* 是否必填
* 类型string(32)
* 描述
* 由半角的大小写字母数字中划线下划线中的一种或几种组成
* 示例值商品编码
* </pre>
*/
@SerializedName(value = "merchant_goods_id")
private String merchantGoodsId;
/**
* <pre>
* 字段名微信侧商品编码
* 变量名wechatpay_goods_id
* 是否必填
* 类型string(32)
* 描述
* 微信支付定义的统一商品编号没有可不传
* 示例值1001
* </pre>
*/
@SerializedName(value = "wechatpay_goods_id")
private String wechatpayGoodsId;
/**
* <pre>
* 字段名商品名称
* 变量名goods_name
* 是否必填
* 类型string(256)
* 描述
* 商品的实际名称
* 示例值iPhoneX 256G
* </pre>
*/
@SerializedName(value = "goods_name")
private String goodsName;
/**
* <pre>
* 字段名商品数量
* 变量名quantity
* 是否必填
* 类型int64
* 描述
* 用户购买的数量
* 示例值1
* </pre>
*/
@SerializedName(value = "quantity")
private Integer quantity;
/**
* <pre>
* 字段名商品单价
* 变量名unit_price
* 是否必填
* 类型int64
* 描述
* 商品单价单位为分
* 示例值828800
* </pre>
*/
@SerializedName(value = "unit_price")
private Integer unitPrice;
}
@Data
@NoArgsConstructor
public static class SceneInfo implements Serializable {
/**
* <pre>
* 字段名商户端设备号
* 变量名device_id
* 是否必填
* 类型string(16)
* 描述
* 终端设备号门店号或收银设备ID
* 特殊规则长度最小7个字节
* 示例值POS1:1
* </pre>
*/
@SerializedName(value = "device_id")
private String deviceId;
/**
* <pre>
* 字段名用户终端IP
* 变量名payer_client_ip
* 是否必填
* 类型string(45)
* 描述
* 用户端实际ip
* 格式: ip(ipv4+ipv6)
* 示例值14.17.22.32
* </pre>
*/
@SerializedName(value = "payer_client_ip")
private String payerClientIp;
/**
* <pre>
* 字段名H5场景信息
* 变量名h5_info
* 是否必填(H5支付必填)
* 类型object
* 描述
* H5场景信息
* </pre>
*/
@SerializedName(value = "h5_info")
private H5Info h5Info;
/**
* <pre>
* 字段名商户门店信息
* 变量名store_info
* 是否必填(H5支付必填)
* 类型object
* 描述
* 商户门店信息
* </pre>
*/
@SerializedName(value = "store_info")
private StoreInfo storeInfo;
}
@Data
@NoArgsConstructor
public static class H5Info implements Serializable {
/**
* <pre>
* 字段名场景类型
* 变量名type
* 是否必填
* 类型string(32)
* 描述
* 场景类型枚举值
* iOSIOS移动应用
* Android安卓移动应用
* WapWAP网站应用
* 示例值iOS
* </pre>
*/
@SerializedName(value = "type")
private String type;
/**
* <pre>
* 字段名应用名称
* 变量名app_name
* 是否必填
* 类型string(64)
* 描述
* 应用名称
* 示例值王者荣耀
* </pre>
*/
@SerializedName(value = "app_name")
private String appName;
/**
* <pre>
* 字段名网站URL
* 变量名app_url
* 是否必填
* 类型string(128)
* 描述
* 网站URL
* 示例值https://pay.qq.com
* </pre>
*/
@SerializedName(value = "app_url")
private String appUrl;
/**
* <pre>
* 字段名iOS平台BundleID
* 变量名bundle_id
* 是否必填
* 类型string(128)
* 描述
* iOS平台BundleID
* 示例值com.tencent.wzryiOS
* </pre>
*/
@SerializedName(value = "bundle_id")
private String bundleId;
/**
* <pre>
* 字段名Android平台PackageName
* 变量名package_name
* 是否必填
* 类型string(128)
* 描述
* Android平台PackageName
* 示例值com.tencent.tmgp.sgame
* </pre>
*/
@SerializedName(value = "package_name")
private String packageName;
}
@Data
@NoArgsConstructor
public static class StoreInfo implements Serializable {
/**
* <pre>
* 字段名门店编号
* 变量名id
* 是否必填
* 类型string(32)
* 描述
* 商户侧门店编号
* 示例值0001
* </pre>
*/
@SerializedName(value = "id")
private String id;
/**
* <pre>
* 字段名门店名称
* 变量名name
* 是否必填
* 类型string(256)
* 描述
* 商户侧门店名称
* 示例值腾讯大厦分店
* </pre>
*/
@SerializedName(value = "name")
private String name;
/**
* <pre>
* 字段名地区编码
* 变量名area_code
* 是否必填
* 类型string(32)
* 描述
* 地区编码详细请见省市区编号对照表(https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/ecommerce/applyments/chapter4_1.shtml)
* 示例值440305
* </pre>
*/
@SerializedName(value = "area_code")
private String areaCode;
/**
* <pre>
* 字段名详细地址
* 变量名address
* 是否必填
* 类型string(512)
* 描述
* 详细的商户门店地址
* 示例值广东省深圳市南山区科技中一道10000号
* </pre>
*/
@SerializedName(value = "address")
private String address;
}
}

View File

@ -1,7 +1,6 @@
package com.github.binarywang.wxpay.bean.ecommerce;
import com.github.binarywang.wxpay.bean.ecommerce.enums.TradeTypeEnum;
import com.github.binarywang.wxpay.v3.util.AesUtils;
import com.github.binarywang.wxpay.v3.util.SignUtils;
import com.google.gson.annotations.SerializedName;
import lombok.Data;
@ -10,17 +9,13 @@ import lombok.experimental.Accessors;
import java.io.Serializable;
import java.security.PrivateKey;
import java.util.HashMap;
import java.util.Map;
import java.util.Random;
import java.util.UUID;
/**
* 合单支付 JSAPI支付结果响应
*/
@Data
@NoArgsConstructor
public class CombineTransactionsResult implements Serializable {
public class TransactionsResult implements Serializable {
/**
* <pre>

View File

@ -19,9 +19,9 @@ public enum TradeTypeEnum {
/**
* 合单url
*/
private String combineUrl;
private final String combineUrl;
/**
* 单独下单url
*/
private String partnerUrl;
private final String partnerUrl;
}

View File

@ -56,14 +56,26 @@ public interface EcommerceService {
/**
* <pre>
* 合单下单-JS支付API.
* 合单支付API(APP支付JSAPI支付H5支付NATIVE支付).
* 请求URLhttps://api.mch.weixin.qq.com/v3/combine-transactions/jsapi
* 文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/pay/combine/chapter3_2.shtml
* 文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/pages/e-combine.shtml
* </pre>
*
* @param tradeType 支付方式
* @param request 请求对象
* @return 预支付交易会话标识, 数字和字母微信生成的预支付会话标识用于后续接口调用使用
* @return 调起支付需要的参数
*/
<T> T combineTransactions(TradeTypeEnum tradeType, CombineTransactionsRequest request) throws WxPayException;
/**
* <pre>
* 服务商模式普通支付API(APP支付JSAPI支付H5支付NATIVE支付).
* 请求URLhttps://api.mch.weixin.qq.com/v3/pay/partner/transactions/jsapi
* 文档地址: https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/pages/transactions_sl.shtml
* </pre>
* @param tradeType 支付方式
* @param request 请求对象
* @return 调起支付需要的参数
*/
<T> T partnerTransactions(TradeTypeEnum tradeType, PartnerTransactionsRequest request) throws WxPayException;
}

View File

@ -9,7 +9,6 @@ import com.github.binarywang.wxpay.v3.util.RsaCryptoUtil;
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import lombok.RequiredArgsConstructor;
import org.apache.commons.lang3.StringUtils;
import java.net.URI;
@ -45,10 +44,17 @@ public class EcommerceServiceImpl implements EcommerceService {
public <T> T combineTransactions(TradeTypeEnum tradeType, CombineTransactionsRequest request) throws WxPayException {
String url = this.payService.getPayBaseUrl() + tradeType.getCombineUrl();
String response = this.payService.postV3(url, GSON.toJson(request));
CombineTransactionsResult result = GSON.fromJson(response, CombineTransactionsResult.class);
TransactionsResult result = GSON.fromJson(response, TransactionsResult.class);
return result.getPayInfo(tradeType, request.getCombineAppid(),
request.getCombineMchid(), payService.getConfig().getPrivateKey());
}
@Override
public <T> T partnerTransactions(TradeTypeEnum tradeType, PartnerTransactionsRequest request) throws WxPayException {
String url = this.payService.getPayBaseUrl() + tradeType.getPartnerUrl();
String response = this.payService.postV3(url, GSON.toJson(request));
TransactionsResult result = GSON.fromJson(response, TransactionsResult.class);
return result.getPayInfo(tradeType, request.getSpAppid(),
request.getSpMchid(), payService.getConfig().getPrivateKey());
}
}