ChinaPay银联电子支付-退款功能

最新推荐文章于 2024-04-21 07:08:16 发布

架构攻城之路

最新推荐文章于 2024-04-21 07:08:16 发布

阅读量2.7k

点赞数 2

分类专栏： Java SpringBoot 文章标签：银联支付退款架构 Java

本文链接：https://blog.csdn.net/a1036645146/article/details/102754067

版权

Java 同时被 2 个专栏收录

42 篇文章 4 订阅

订阅专栏

SpringBoot

19 篇文章 0 订阅

订阅专栏

引言

如果还不了解UnionPay、ChinaPay概念与配置的，可以先移步到《B2B电商平台--ChinaPay银联电子支付功能》，此篇文章会带你熟悉ChinaPay支付流程的完整开发步骤。

一、消费类交易流程

本次只讲解退款申请流程，所以上面两个流程简单看下即可，退款流程如下：

二、后续类交易接口

根据ChinaPay银联接口开发文档4.15后续类交易接口说明：

后续类交易主要是指对已发生的交易，做后续的相关的交易处理；包括：退款、退款撤销、消费撤销、预授权撤销、预授权完成撤销、预授权完成、通知分账。退款的相关操作也可以在企业门户系统中进行操作，但是商户只能选择一种方式进行操作。

1、接入地址

测试环境

生产环境

从提供的地址分类，就可以看出，该后续交易类接口，提供退款申请、退款撤销、通知分账、消费撤销、预授权等功能，具体可通过请求参数区分。

2、请求报文

商户向 ChinaPay 的交易平台提交订单，表单采用“post”方式提交,提交页面中表单（FORM）的应该包括如下( 注意各字段的大小写, 编码方式统一用 UTF-8)：

注：请求参数很多，这里就不全部截取了，开发者只要将必填字段发送到银联即可。

3、应答报文（同步）

对于 0401 退款、0402 退款撤销、0403 消费撤销、9908 通知分账的交易，当 ChinaPay交易平台接收商户提交的订单后，会返回商户同步处理结果。包括如下( 响应数据以以 key=value 形式，用用”&” 符号分隔)：

这里可以看出，调用后续类交易接口时，会同步应答响应码、描述、签名，通过响应码确认请求成功与否。其中，退款申请会同步返回“1003：商户已审核”表示退款申请成功，还需要等待银联的异步回调通知真正退款到账成功。

4、结果通知（异步）

当 ChinaPay 交易平台处理完成时，ChinaPay 会将订单信息发送给商户，应答的数据域段包括如下内容：(以页面 Form 数据为例, 注意大小写, 编码方式统一用 UTF-8，后台应答数据的发送的域段名和下面的一致)

其中，上图红框参数容易误解为支付时的交易流水号、交易日期、订单支付完成时间，其实是指本次后续交易请求单的收单流水号、完成时间。比如，我们是在进行退款申请，那么，此次异步回调结果，如下：

AcqSeqId：退款受理流水号（由银联生成返回）
AcqDate：退款申请受理日期
CompleteDate：退款完成日期
CompleteTime：退款完成时间

三、退款申请开发

同理，在进行公司实际项目退款功能开发前，最好要先写好测试类，先把银联退款申请功能接口调通，再把测试类整合进自己的项目中，结合实际业务开发，这里只展示测试demo，具体退款业务需要结合自己项目的实际需求哦。

本demo也是基于SpringBoot构建的测试应用，项目结构如下：

1、security.properties

## Security properties configuration file
# 验签证书路径
verify.file=E:/my-demo/chinapay-demo/src/main/resources/chinapay/cp-test.cer
# 路径
sign.filePath=E:/my-demo/chinapay-demo/src/main/resources/chinapay
# 交易证书路径
sign.file=E:/my-demo/chinapay-demo/src/main/resources/chinapay/cp-test.pfx
# 交易证书密码
sign.file.password=123456
# 交易证书的密钥容器格式
sign.cert.type=PKCS12
# 报文中不参与签名的字段名称，多个字段用逗号进行分隔
sign.invalid.fields=Signature,CertId
# 签名值字段名称
signature.field=Signature
# 日志名称
log4j.name=CONSOLE

2、pom 文件引入：

<dependency>
    <groupId>com.chinapay.sdk</groupId>
    <artifactId>chinapay-sdk</artifactId>
    <version>1.0.0</version>
</dependency>

3、退款申请接口：

/**
 * @description: 退款
 * @author: stwen_gan
 * @date: 2019/09/24
 **/
@Slf4j
@Controller
@RequestMapping
public class RefundController {
    //退款地址
    private static String refundUrl = "https://newpayment-test.chinapay.com/CTITS/service/rest/forward/syn/000000000065/0/0/0/0/0";
//    private static String refundUrl = "https://payment.chinapay.com/CTITS/service/rest/forward/syn/000000000065/0/0/0/0/0";
    /**
     * 退款申请、撤销
     * @param req
     * @param resp
     * @return
     * @throws Exception
     */
    @RequestMapping("/refund")
    @ResponseBody
    public String refund(HttpServletRequest req, HttpServletResponse resp) throws Exception {
        log.info("####################开始退款####################");
        Map<String, String> paramMap = new TreeMap<>();
        Date nowDate = new Date();
        paramMap.put("Version", "20140728");
        paramMap.put("AccessType","0"); //接入类型  0：商户身份接入（默认）1：机构身份接入
        paramMap.put("MerId", "000091908269337");//测试商户号
        paramMap.put("BusiType", "0001");//业务类型，固定值：0001
        //退款订单号
        paramMap.put("MerOrderNo", TimeUtil.dateToStr(nowDate,TimeUtil.YYYYMMDD)+TimeUtil.dateToStr(nowDate,TimeUtil.HHMMSS));
        paramMap.put("TranDate", TimeUtil.dateToStr(nowDate,TimeUtil.YYYYMMDD));
        paramMap.put("TranTime", TimeUtil.dateToStr(nowDate,TimeUtil.HHMMSS));
        paramMap.put("MerBgUrl", "http://ggzz.ngrok.ygqit.com/refundNotify");//支付异步通知地址:用来接收交易结果后台通知的地址
        //退款
        paramMap.put("OriOrderNo", "20190926141435");//原始交易订单号
        //撤销退款
//        paramMap.put("OriOrderNo", "20190920153459");//原始交易订单号
        paramMap.put("OriTranDate", "20190926");//商户原始交易日期
        paramMap.put("RefundAmt", "1");//退款金额--单位：分，当 TranType=0401 退款交易时 RefundAmt 必填，当 TranType 为其他值时， 交易时不能传 RefundAmt
        paramMap.put("TranType", "0401");//退款交易
//        paramMap.put("TranType", "0402");//退款撤销
        System.out.println("==============退款订单号===========:"+paramMap.get("MerOrderNo"));
        System.out.println("==============退款申请日期===========:"+paramMap.get("TranDate"));
        System.out.println("==============退款申请时间===========:"+paramMap.get("TranTime"));
        //paramMap.put("OrderAmt", "1");//订单金额--单位：分，当 TranType=0202 或 9908 时，OrderAmt 必填，当 TranType 为其他值，交易时不能传 OrderAmt
//        paramMap.put("CurryNo", "CNY");//交易币种：默认为人民币：CNY
//        paramMap.put("SplitType", "0001");//分账类型：不分账不填写此域；分账交易退款，此字段传 0001
//        paramMap.put("SplitMethod", "0401");//订单分账方式：0：按金额分账 ，1：按比例分账
//        paramMap.put("MerSplitMsg", "0401");//分账信息
        SecssUtil secssUtil = ChinaPayUtil.secssUtil;
        //签名
        secssUtil.sign(paramMap);
        if (!SecssConstants.SUCCESS.equals(secssUtil.getErrCode()))
        {
            log.error(secssUtil.getErrCode() + "=" + secssUtil.getErrMsg());
            return secssUtil.getErrMsg();
        }
        String signature = secssUtil.getSign();
        paramMap.put("Signature", signature);
        System.out.println("####################请求总参数####################:"+paramMap);
        //http请求
        String result = HttpUtils.send(refundUrl, paramMap);
        System.out.println("返回结果："+result);
        Map<String, String> resultMap = ChinaPayUtil.strToMap(result);
        //返回数据验签
        boolean verifyFlag = ChinaPayUtil.verifyNotify(resultMap);
        if (!verifyFlag) {
            log.error("ChinaPay返回数据验签失败！");
            return "ChinaPay返回数据验签失败！";
        }
        return resultMap.get("respCode")+":"+resultMap.get("respMsg");
    }
}

4、退款异步回调

/**
 * 退款异步回调
 * @param request
 * @param response
 * @return
 */
@RequestMapping("/refundNotify")
public String refundNotify(HttpServletRequest request,HttpServletResponse response){
    log.info("退款申请异步回调");
    Map<String, String[]> requestParams = request.getParameterMap();
    //ChinaPay后台返回所有字段需要解码
    Map<String, String> notifyMap = ChinaPayUtil.parseNotifyMsg(requestParams);
    // 验证退款单状态是否成功：0000-退款成功，其他请参考银联支付接口文档附录B
    String return_code = notifyMap.get("OrderStatus");
    log.info("订单状态 return_code:{}" ,return_code);
    if (!"0000".equals(return_code)) {
        log.error("退款单号："+ notifyMap.get("MerOrderNo") +"退款失败。原始订单号："+ notifyMap.get("OriOrderNo"));
    }
    // TODO 具体处理平台后续业务，如更新订单状态、退款状态等
    
    return "退款成功";
}

其中，ChinaPayUtil 工具类如下，主要是初始化商户签名、验签配置信息：

@Slf4j
public class ChinaPayUtil {
    public static final SecssUtil secssUtil;
    //初始化
    static {
        secssUtil = new SecssUtil();
        Resource resource = new ClassPathResource("./security.properties");
        File file = null;
        try {
            file = resource.getFile();
        } catch (IOException e) {
            e.printStackTrace();
        }
        boolean bool = secssUtil.init(file.getPath());
        if (bool) {
           PaymentLog.info("ChinaPay交易证书、验签证书初始化成功！");
        } else {
           PaymentLog.error("ChinaPay交易证书、验签证书初始化失败："+secssUtil.getErrCode() + "=" + secssUtil.getErrMsg());
        }
    }
}

四、测试退款

先调用银联支付请求，交易一张订单(银联支付还不知道，请查看此文《B2B电商平台--ChinaPay银联电子支付功能》)，记录交易流水号与交易日期，填入退款申请接口请求相应参数中，然后运行应用，访问下该退款接口，成功的话，会返回“1003：商户已审核”，如下：

注：异步回调这里就不测试了，需要等待银联那边退款成功才会回调。

八、总结

这里演示了退款申请的具体步骤，其实，相对于支付对接，都差不多的开发流程，只要按照银联接口文档来开发即可，请求参数有些许疑惑的可以咨询银联技术人员。退款对接并不难，更多的工作量是在平台业务处理这边，比如，我们的是B2B系统，区分预付款与尾款，可能是分多笔退款、部分退款，主要分几块：用户端退款模块（PC与移动端）、商户端退款模块（PC与移动端）、后台管理审核退款模块等。

往期推荐

●Spring Cloud Alibaba Nacos 配置中心对比与实战

●超级全面的MySQL优化--一篇足以【建议收藏】

●Java/JDK 13 新特性详解

●Spring Cloud Alibaba 微服务全家桶体验-2019阿里云峰会PPT

●Spring Cloud Alibaba 完美融合Dubbo-Nacos示例

●如何使用Seata保证Dubbo微服务间的一致性

●B2B电商平台--ChinaPay银联电子支付功能

●学会Zookeeper分布式锁，让面试官对你刮目相看

●SpringCloud电商秒杀微服务-Redisson分布式锁方案

架构攻城之路

关注

2
点赞
踩
6

收藏

觉得还不错? 一键收藏
2
评论
ChinaPay银联电子支付-退款功能

引言如果还不了解UnionPay、ChinaPay概念与配置的，可以先移步到《B2B电商平台--ChinaPay银联电子支付功能》，此篇文章会带你熟悉ChinaPay支付流程的完整开发步骤。一、消费类交易流程本次只讲解退款申请流程，所以上面两个流程简单看下即可，退款流程如下：二、后续类交易接口根据ChinaPay银联接口开发文档4.15后续类交易接口说明：后...
复制链接

扫一扫

专栏目录