应用:手机支付使用apple pay进行支付(apple pay是银联和苹果公司合作推出的支付产品,既可实现近场支付又可完成远程支付的服务,通过NFC、指纹识别以及Wallet实现安全可靠的近场支付服务,通过指纹识别和Wallet实现远程支付)
官方文档:https://open.unionpay.com/tjweb/acproduct/list?apiSvcId=460
示例
**********************
配置文件
acp_sdk.properties
##############SDK配置文件(证书方式签名)################
# 说明:
# 1. 使用时请将此文件复制到src文件夹下替换原来的acp_sdk.properties。
# 2. 具体配置项请根据注释修改。
#
################################################
##########################入网测试环境交易发送地址(线上测试需要使用生产环境交易请求地址)#############################
##交易请求地址
acpsdk.frontTransUrl=https://gateway.test.95516.com/gateway/api/frontTransReq.do
acpsdk.backTransUrl=https://gateway.test.95516.com/gateway/api/backTransReq.do
acpsdk.singleQueryUrl=https://gateway.test.95516.com/gateway/api/queryTrans.do
acpsdk.batchTransUrl=https://gateway.test.95516.com/gateway/api/batchTrans.do
acpsdk.fileTransUrl=https://filedownload.test.95516.com/
acpsdk.appTransUrl=https://gateway.test.95516.com/gateway/api/appTransReq.do
acpsdk.cardTransUrl=https://gateway.test.95516.com/gateway/api/cardTransReq.do
#以下缴费产品使用,其余产品用不到
acpsdk.jfFrontTransUrl=https://gateway.test.95516.com/jiaofei/api/frontTransReq.do
acpsdk.jfBackTransUrl=https://gateway.test.95516.com/jiaofei/api/backTransReq.do
acpsdk.jfSingleQueryUrl=https://gateway.test.95516.com/jiaofei/api/queryTrans.do
acpsdk.jfCardTransUrl=https://gateway.test.95516.com/jiaofei/api/cardTransReq.do
acpsdk.jfAppTransUrl=https://gateway.test.95516.com/jiaofei/api/appTransReq.do
########################################################################
# 报文版本号,固定5.1.0,请勿改动
acpsdk.version=5.1.0
# 签名方式,证书方式固定01,请勿改动
acpsdk.signMethod=01
# 是否验证验签证书的CN,测试环境请设置false,生产环境请设置true。非false的值默认都当true处理。
acpsdk.ifValidateCNName=false
# 是否验证https证书,测试环境请设置false,生产环境建议优先尝试true,不行再false。非true的值默认都当false处理。
acpsdk.ifValidateRemoteCert=false
#后台通知地址,填写接收银联后台通知的地址,必须外网能访问
acpsdk.backUrl=http://abz8ys.natappfree.cc/notify
#前台通知地址,填写银联前台通知的地址,必须外网能访问
acpsdk.frontUrl=http://abz8ys.natappfree.cc/return
#########################入网测试环境签名证书配置 ################################
# 多证书的情况证书路径为代码指定,可不对此块做配置。
# 签名证书路径,必须使用绝对路径,如果不想使用绝对路径,可以自行实现相对路径获取证书的方法;测试证书所有商户共用开发包中的测试签名证书,生产环境请从cfca下载得到。
# windows样例:
acpsdk.signCert.path=D:/certs/acp_test_sign.pfx
# linux样例(注意:在linux下读取证书需要保证证书有被应用读的权限)(后续其他路径配置也同此条说明)
#acpsdk.signCert.path=/SERVICE01/usr/ac_frnas/conf/ACPtest/acp700000000000001.pfx
# 签名证书密码,测试环境固定000000,生产环境请修改为从cfca下载的正式证书的密码,正式环境证书密码位数需小于等于6位,否则上传到商户服务网站会失败
acpsdk.signCert.pwd=000000
# 签名证书类型,固定不需要修改
acpsdk.signCert.type=PKCS12
##########################加密证书配置################################
# 敏感信息加密证书路径(商户号开通了商户对敏感信息加密的权限,需要对 卡号accNo,pin和phoneNo,cvn2,expired加密(如果这些上送的话),对敏感信息加密使用)
acpsdk.encryptCert.path=D:/certs/acp_test_enc.cer
##########################验签证书配置################################
# 验签中级证书路径(银联提供)
acpsdk.middleCert.path=D:/certs/acp_test_middle.cer
# 验签根证书路径(银联提供)
acpsdk.rootCert.path=D:/certs/acp_test_root.cer
acpsdk.validateCert.dir=D:/certs/
**********************
config 层
UnionpayConfig:加载配置属性,初始化SDKConfig
@Configuration
public class UnionpayConfig implements ApplicationRunner {
@Override
public void run(ApplicationArguments args) {
SDKConfig.getConfig().loadPropertiesFromSrc();
}
}
**********************
service 层
UnionpayService
public interface UnionpayService {
String pay(String orderId,String txnAmt); //支付接口
}
**********************
serviceImpl 层
UnionpayServiceImpl
@Service
public class UnionpayServiceImpl implements UnionpayService {
@Override
public String pay(String orderId, String txnAmt) {
Map<String, String> requestData = new HashMap<>();
/***银联全渠道系统,产品参数,除了encoding自行选择外其他不需修改***/
requestData.put("version", SDKConstants.VERSION_5_1_0); //版本号,全渠道默认值
requestData.put("encoding", SDKConstants.UTF_8_ENCODING); //字符集编码,可以使用UTF-8,GBK两种方式
requestData.put("signMethod", SDKConfig.getConfig().getSignMethod()); //签名方法
requestData.put("txnType", "01"); //交易类型 ,01:消费
requestData.put("txnSubType", "01"); //交易子类型, 01:自助消费
requestData.put("bizType", "000802");
requestData.put("channelType", "08"); //渠道类型,这个字段区分B2C网关支付和手机wap支付;07:PC,平板 08:手机
/***商户接入参数***/
requestData.put("merId", "777***"); //商户号码,请改成自己申请的正式商户号或者open上注册得来的777测试商户号
requestData.put("accessType", "0"); //接入类型,0:直连商户
requestData.put("orderId",orderId); //商户订单号,8-40位数字字母,不能含“-”或“_”,可以自行定制规则
requestData.put("txnTime", DemoBase.getCurrentTime()); //订单发送时间,取系统时间,格式为YYYYMMDDhhmmss,必须取当前时间,否则会报txnTime无效
requestData.put("currencyCode", "156"); //交易币种(境内商户一般是156 人民币)
requestData.put("txnAmt", txnAmt); //交易金额,单位分,不要带小数点
String accNo=AcpService.encryptData("6259020040003629",SDKConstants.UTF_8_ENCODING);
requestData.put("accNo",accNo);
requestData.put("encryptCertId",AcpService.getEncryptCertId()); //加密证书的certId,配置在acp_sdk.properties文件 acpsdk.encryptCert.path属性下
Map<String,String> customerInfoMap=new HashMap<>();
customerInfoMap.put("customerNm","tom"); //主要填写 持卡人姓名(PassKitApi 中的paymentData->data->cardholderName)
// 和支付密码(PassKitApi 中的paymentData->data-> encryptedPINData)
//若PassKitApi中未返回,则无需上送
customerInfoMap.put("pin", "81103e8d9ea8afc5c6147b09e7cd2d8db88b82080021ffffffffffff");
String customerInfoStr = AcpService.getCustomerInfo(customerInfoMap,accNo,DemoBase.encoding);
requestData.put("customerInfo",customerInfoStr);
Map<String,String> cardTransDataMap=new HashMap<>();
cardTransDataMap.put("ICCardData", "nyYI/RZhrTzcBF+fNgIAAYECACGDaMOcdhXu5YlSgbnWkLdA1R4D4A7AQ3BAxKYgz7w6ElseNh0uWnMWPtLLtu+/Cg98b/1MSLOhfPfkTtm9QSBb8jqVBMC96llxK7aWP2yY/rt1tCLy9Up6dxjmf2IhbvvTX1LnOCnOEQn+");
//PassKitApi 中的paymentData->data-> paymentData-> emvData
cardTransDataMap.put("carrierTp", "6"); //勿改,applePay后台接入固定用法
cardTransDataMap.put("carrierAppTp", "2"); //勿改,applePay后台接入固定用法
String cardTransDataStr = AcpService.getCardTransData(cardTransDataMap,requestData,DemoBase.encoding);
requestData.put("cardTransData", cardTransDataStr); //请参考getCardTransData方法内部,相关要素从读卡器采集。
//前台通知地址 (需设置为外网能访问 http https均可),支付成功后的页面 点击“返回商户”按钮的时候将异步通知报文post到该地址
//如果想要实现过几秒中自动跳转回商户页面权限,需联系银联业务申请开通自动返回商户权限
//异步通知参数详见open.unionpay.com帮助中心 下载 产品接口规范 网关支付产品接口规范 消费交易 商户通知
requestData.put("frontUrl", DemoBase.frontUrl);
//后台通知地址(需设置为【外网】能访问 http https均可),支付成功后银联会自动将异步通知报文post到商户上送的该地址,失败的交易银联不会发送后台通知
//后台通知参数详见open.unionpay.com帮助中心 下载 产品接口规范 网关支付产品接口规范 消费交易 商户通知
//注意:1.需设置为外网能访问,否则收不到通知 2.http https均可 3.收单后台通知后需要10秒内返回http200或302状态码
// 4.如果银联通知服务器发送通知后10秒内未收到返回状态码或者应答码非http200,那么银联会间隔一段时间再次发送。总共发送5次,每次的间隔时间为0,1,2,4分钟。
// 5.后台通知地址如果上送了带有?的参数,例如:http://abc/web?a=b&c=d 在后台通知处理程序验证签名之前需要编写逻辑将这些字段去掉再验签,否则将会验签失败
requestData.put("backUrl", DemoBase.backUrl);
// 报文中特殊用法请查看 PCwap网关跳转支付特殊用法.txt
/**请求参数设置完毕,以下对请求参数进行签名并生成html表单,将表单写入浏览器跳转打开银联页面**/
//报文中certId,signature的值是在signData方法中获取并自动赋值的,只要证书配置正确即可。
Map<String, String> submitFromData = AcpService.sign(requestData, SDKConstants.UTF_8_ENCODING);
//获取请求银联的地址:对应属性文件acp_sdk.properties文件中的acpsdk.appTransUrl
String url = SDKConfig.getConfig().getCardRequestUrl();
//生成自动跳转的Html表单
return AcpService.createAutoFormHtml(url, submitFromData,SDKConstants.UTF_8_ENCODING);
}
}
**********************
controller 层
UnionpayController
@RestController
public class UnionpayController {
@Resource
private UnionpayService unionpayService;
@RequestMapping("/pay")
public void pay(HttpServletResponse response) throws Exception{
response.setHeader("content-type", "text/html;charset=UTF-8");
response.getWriter().write(unionpayService.pay(DemoBase.getOrderId(),"20000"));
}
@RequestMapping("/return")
public String fun(HttpServletRequest request){
Map<String,String> result=new HashMap<>();
System.out.println("====== 前台通知 ======");
Enumeration<String> names=request.getParameterNames();
if (names!=null){
while (names.hasMoreElements()){
String name=names.nextElement();
String value=request.getParameter(name);
result.put(name,value);
System.out.println(name+" ==> "+value);
if (result.get(name)==null||"".equals(result.get(name))){
result.remove(name);
}
}
}
if (AcpService.validate(result, SDKConstants.UTF_8_ENCODING)){ //前台参数验签
return "success";
}else {
return "验签失败";
}
}
@RequestMapping("/notify")
public void hello2(HttpServletRequest request,HttpServletResponse response) throws Exception{
Map<String,String> result=new HashMap<>();
System.out.println("======= 后台通知 ========");
Enumeration<String> names=request.getParameterNames();
if (names!=null){
while (names.hasMoreElements()){
String name=names.nextElement();
String value=request.getParameter(name);
result.put(name,value);
System.out.println(name+" ==> "+value);
if (result.get(name)==null||"".equals(result.get(name))){
result.remove(name);
}
}
}
if (AcpService.validate(result, SDKConstants.UTF_8_ENCODING)){
System.out.println("后台验签成功");
}else {
System.out.println("后台验签失败");
}
response.getWriter().print("ok");
}
}