java 支付宝支付 交易退款接口alipay.trade.re

alipay.trade.refund(统一收单交易退款接口)

当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，支付宝将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路退到买家帐号上。 交易超过约定时间（签约时设置的可退款时间）的订单无法进行退款 支付宝退款支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。一笔退款失败后重新提交，要采用原来的退款单号。总退款金额不能超过用户实际支付金额

支付宝开发文档参考 https://docs.open.alipay.com/api_1/alipay.trade.refund

项目中具体代码实现：

/**
     * @param alipayRefundRequestDTO :
     * @return java.lang.String
     * @Description 支付宝退款接口
     * @Author huangkeyuan
     * @Date 20:21 2019-12-12
     */
    @PostMapping("refund")
    @Override
    public String alipayRefund(@RequestBody AlipayRefundRequestDTO alipayRefundRequestDTO) {

        //实例化具体API对应的request类,类名称和接口名称对应,当前调用接口名称：
        AlipayTradeRefundRequest request = new AlipayTradeRefundRequest();
        //SDK已经封装掉了公共参数，这里只需要传入业务参数。以下方法为sdk的model入参方式(model和biz_content同时存在的情况下取biz_content)。
        AlipayTradeRefundModel model = new AlipayTradeRefundModel();

        model.setOutTradeNo(alipayRefundRequestDTO.getOuttradeno());
        model.setOutRequestNo(alipayRefundRequestDTO.getOutrefundno());
        model.setRefundAmount(alipayRefundRequestDTO.getRefundfee());
        request.setBizModel(model);

        /**实例化客户端*/
        CertAlipayRequest certAlipayRequest = new CertAlipayRequest();
        certAlipayRequest.setServerUrl(aliPayConfig.getSERVERURL());
        certAlipayRequest.setAppId(aliPayConfig.getAPPID());
        certAlipayRequest.setPrivateKey(aliPayConfig.getAPP_PRIVATE_KEY());
        certAlipayRequest.setFormat(aliPayConfig.getFORMAT());
        certAlipayRequest.setCharset(aliPayConfig.getCHARSET());
        certAlipayRequest.setSignType(aliPayConfig.getSIGN_TYPE());
        certAlipayRequest.setCertPath(aliPayConfig.getAPP_CERT_PATH());
        certAlipayRequest.setAlipayPublicCertPath(aliPayConfig.getALIPAY_CERT_PATH());
        certAlipayRequest.setRootCertPath(aliPayConfig.getALIPAY_ROOT_CERT_PATH());
        try {
            //构造client
            AlipayClient alipayClient = new LMAlipayClient(certAlipayRequest);
            AlipayTradeRefundResponse response = alipayClient.execute(request);
            log.info("支付宝退款返回信息,{}",response.getBody());
            return response.getBody();
        } catch (AlipayApiException e) {
            log.error(e.getMessage(), e);
            return null;
        }
    }

注意点

1.参数

1.outTradeNo 支付的时候传入的商家的支付订单编号
2.outRequestNo 本次退款的退款单号，标识一次退款请求，同一笔交易多次退款需要保证唯一，如需部分退款，则此参数必传。
3.refundAmount 退款金额

2.签名错误

在签名调用支付下单接口时，签名顺利通过了，本以为这里退款接口的签名应该也没问题；但是确实出现签名错误的问题；

后面找到原因是下单和退款的接口调用的api不同所以后面走的签名方法也不同。问题出现在：退款接口的签名在读取appCertSN为空。 做了修改之后签名就对了；
附上修改的方法：

private <T extends AlipayResponse> T _execute(AlipayRequest<T> request, AlipayParser<T> parser, String authToken, String appAuthToken) throws AlipayApiException {
        long beginTime = System.currentTimeMillis();
        Map<String, Object> rt = this.doPost(request, authToken, appAuthToken, this.appCertSN);
        if (rt == null) {
            return null;
        } else {
            Map<String, Long> costTimeMap = new HashMap();
            if (rt.containsKey("prepareTime")) {
                costTimeMap.put("prepareCostTime", (Long)((Long)rt.get("prepareTime")) - beginTime);
                if (rt.containsKey("requestTime")) {
                    costTimeMap.put("requestCostTime", (Long)((Long)rt.get("requestTime")) - (Long)((Long)rt.get("prepareTime")));
                }
            }

            AlipayResponse tRsp = null;

            try {
                ResponseEncryptItem responseItem = this.decryptResponse(request, rt, parser);
                tRsp = parser.parse(responseItem.getRealContent());
                tRsp.setBody(responseItem.getRealContent());
                this.checkResponseSign(request, parser, responseItem.getRespContent(), tRsp.isSuccess());
                if (costTimeMap.containsKey("requestCostTime")) {
                    costTimeMap.put("postCostTime", System.currentTimeMillis() - (Long)((Long)rt.get("requestTime")));
                }
            } catch (RuntimeException var11) {
                AlipayLogger.logBizError((String)rt.get("rsp"), costTimeMap);
                throw var11;
            } catch (AlipayApiException var12) {
                AlipayLogger.logBizError((String)rt.get("rsp"), costTimeMap);
                throw new AlipayApiException(var12);
            }

            tRsp.setParams((AlipayHashMap)rt.get("textParams"));
            if (!tRsp.isSuccess()) {
                AlipayLogger.logErrorScene(rt, tRsp, "", costTimeMap);
            } else {
                AlipayLogger.logBizSummary(rt, tRsp, costTimeMap);
            }

            return (T)tRsp;
        }
    }