对接农业银行支付（微信和支付宝）的总结（四）

2022-04-26  本文已影响0人  天草二十六_简村人

一、写在前面的话

首先感谢很多简友给我来消息，询问关于对接的源码；其次是有简友提醒我，有人在百度文库盗贴了我的文档；最后我想奉劝大家，如果有退款需求，建议不要对接农行，后面我会详细说明原因。

之前的文章也写了很多关于农行接口的出入参，其实他们本身也是有在线文档的，比我的文章里写的示例要清晰一些。（比杭州银行的离线Pdf或Doc要先进一步了，可惜它的其他方面体验差远了）

二、主要内容

三、对账接口

需要特别指出，对账接口有很多个，如果你对接的是微信/支付宝方式的话，需要使用“微信支付宝交易对账单下载”。注意不要使用接口“农行交易对账单下载”。

农行的对账单接口.png

我相信，怎么使用http接口是很容易的，这里就不讲，需要指明的是日期字段的值，容易传错。
错在哪呢，其实它文档里也有写，谁让我们没看仔细呢。。。

可用来下载微信支付宝支付指定日期的对账单。
T 日对账单在 T+1 日 17:00 之后生成，因此请求对账单下载不应早于次日 17:00。

经我验证过，时间不用等到17点，上午就可以获取到了，具体几点开始有了账单的，就不想去细究了。

好了，关于对账接口，最后贴下他的格式，以及解析示例。

商户号|交易类型|订单编号|交易时间|交易金额|商户账号|商户动账金额|客户账号|账户类型|商户回佣手续费|商户分期手续费|会计日期|主机流水号|9014流水号|原订单号^^
103881909993435|weixinpay|B13220406092802072109|20220406092803|0.01|19015601949001842|0.01|otDNot8jM13dT_rhF9_OOVpRiO1M|OTHERS|0|0.00|20220407|242190361|46ECEP01092733452084|B13220406092802072109^^
103881909993435|weixinpay|132204061003230B71896|20220406100323|0.01|19015601949001842|0.01|otDNot8jM13dT_rhF9_OOVpRiO1M|OTHERS|0|0.00|20220407|242190361|46ECEP01100210191273|132204061003230B71896^^
103881909993435|weixinpay|132204061017200722B71|20220406101720|0.01|19015601949001842|0.01|otDNot8jM13dT_rhF9_OOVpRiO1M|OTHERS|0|0.00|20220407|242190361|46ECEP01101514287394|132204061017200722B71^^
103881909993435|WeiXinRefund|R112204061758490B72381|20220406175849|0.01|19015601040025213|0.01|||0|0.00|20220407|242190361|46ECEP01175501714434|1122040B6175627072375^^
103881909993435|weixinpay|B13220406094924072229|20220406094924|0.01|19015601949001842|0.01|otDNot8jM13dT_rhF9_OOVpRiO1M|OTHERS|0|0.00|20220407|242190361|46ECEP01094430716845|B13220406094924072229^^
103881909993435|weixinpay|1122040B6175627072375|20220406175627|0.01|19015601949001842|0.01|otDNotxTIe0B7VT1vGxbIbXqIQu0|OTHERS|0|0.00|20220407|242190361|46ECEP01175058463786|1122040B6175627072375

最后，贴出解析农行账单的伪代码，关于对账，有空我再写一系列的文章。

import cn.hutool.core.date.DateUtil;
import com.xxx.service.pay.constant.PayConstants;
import com.xxx.service.pay.domain.model.BillInfo;
import com.xxx.service.pay.domain.service.dto.BankTradeDTO;
import com.xxx.service.pay.utils.AmountUtils;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;

import java.util.List;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

@Slf4j
@Component("billParser" + PayConstants.PayChannelType.AbcBank)
public class BillParserAbcBank implements IBillParser {
    private static final String BILL_OF_PAY_TYPE = "pay";

    private static final String BILL_OF_REFUND_TYPE = "refund";

    private static final Pattern PATTERN = Pattern.compile("(.*?)\\|(.*?)\\|(.*?)\\|(.*?)\\|(.*?)\\|(.*?)\\|(.*?)\\|(.*?)\\|(.*?)\\|(.*?)\\|(.*?)\\|(.*?)\\|(.*?)\\|(.*?)\\|(.*?)$");

    @Override
    public <T> void parser(T object, BillInfo billInfo, List<BankTradeDTO> payTradeDTOList, List<BankTradeDTO> refundTradeDTOList) throws Exception {
        String billContent = (String) object;

        String[] array = billContent.split("\\^\\^");

        if (array.length > 1) {
            this.parseDetailLine(array, payTradeDTOList, refundTradeDTOList, billInfo);
        }
    }

    /**
     * 解析明细数据.
     * <p>
     * 先删除明细数据的标题, 再循环遍历数据值
     * </p>
     *
     * @param array
     * @param payTradeDTOList
     * @param refundTradeDTOList
     */
    private void parseDetailLine(String[] array, List<BankTradeDTO> payTradeDTOList, List<BankTradeDTO> refundTradeDTOList, BillInfo billInfo) {
        int totalPayAmount = 0;
        int totalPayCount = 0;

        int totalRefundAmount = 0;
        int totalRefundCount = 0;

        int totalPayFee = 0;
        int totalRefundFee = 0;

        // 跳过第一行，下标从1开始
        for (int i = 1; i < array.length; i++) {
            // 正则匹配校验
            Matcher totalMatcher = PATTERN.matcher(array[i]);
            if (!totalMatcher.find()) {
                return;
            }

            String[] detailArray = array[i].split("\\|");
            // 交易类型
            String tradeType = detailArray[1].toLowerCase();
            // 对银行而言, 商户订单号
            String outTradeNo = detailArray[2];
            // 交易时间
            String tradeTime = detailArray[3];
            // 交易金额
            int amount = AmountUtils.changeY2F(detailArray[4]);
            // 手续费
            int fee = AmountUtils.changeY2F(detailArray[10]);
            // 平台流水号
            String tradeNo = detailArray[13];

            //支付订单
            if (tradeType.endsWith(BILL_OF_PAY_TYPE)) {
                BankTradeDTO payTradeDTO = BankTradeDTO.builder()
                        .tradeTime(DateUtil.parse(tradeTime))
                        .outTradeNo(outTradeNo)
                        .tradeNo(tradeNo)

                        .amount(amount)
                        .fee(fee)
                        .build();

                totalPayAmount += amount;
                totalPayFee += fee;
                totalPayCount++;
                payTradeDTOList.add(payTradeDTO);
            }

            if (tradeType.endsWith(BILL_OF_REFUND_TYPE)) {
                BankTradeDTO refundTradeDTO = BankTradeDTO.builder()
                        .tradeTime(DateUtil.parse(tradeTime))
                        .outTradeNo(outTradeNo)
                        .tradeNo(tradeNo)

                        .amount(Math.abs(amount))
                        .fee(fee)
                        .build();

                totalRefundAmount += amount;
                totalRefundFee += fee;
                totalRefundCount++;
                refundTradeDTOList.add(refundTradeDTO);
            }
        }

        billInfo.setBankPayTrade(totalPayAmount, totalPayCount, totalPayFee);

        billInfo.setBankRefundTrade(totalRefundAmount, totalRefundCount, totalRefundFee);
    }

}

import com.xxx.service.pay.domain.model.BillInfo;
import com.xxx.service.pay.domain.service.dto.BankTradeDTO;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.BeansException;
import org.springframework.beans.factory.BeanFactory;
import org.springframework.beans.factory.BeanFactoryAware;
import org.springframework.beans.factory.NoSuchBeanDefinitionException;
import org.springframework.stereotype.Service;

import java.util.List;

/**
 * 账单解析工厂类
 */
@Slf4j
@Service
public class BillParserFactory implements BeanFactoryAware {

    private BeanFactory beanFactory;

    @Override
    public void setBeanFactory(BeanFactory beanFactory) throws BeansException {
        this.beanFactory = beanFactory;
    }

    public Object getService(String payInterface) {
        return beanFactory.getBean(payInterface);
    }


    public <T> void parser(T object, BillInfo billInfo, List<BankTradeDTO> payTradeDTOList, List<BankTradeDTO> refundTradeDTOList) throws Exception {

        String parserClassName = "billParser" + billInfo.getChannelType();

        IBillParser service;
        try {
            // 根据名字获取相应的解析器
            service = (IBillParser) this.getService(parserClassName);
        } catch (NoSuchBeanDefinitionException e) {
            log.error("根据解析器的名字, 没有找到相应的解析器, [parserClassName={}, mchId={}, channelType={}, billDate={}]",
                    parserClassName, billInfo.getMchId(), billInfo.getChannelType(), billInfo.getBillYmd());
            return;
        }
        // 使用相应的解析器解析文件
        service.parser(object, billInfo, payTradeDTOList, refundTradeDTOList);
    }
}

import com.xxx.service.pay.domain.model.BillInfo;
import com.xxx.service.pay.domain.service.dto.BankTradeDTO;

import java.util.List;

/**
 * 解析对账单为统一格式
 *
 */
public interface IBillParser {
    /**
     * 解析对账单
     *
     * @param object
     * @param billInfo
     * @param payTradeDTOList
     * @param refundTradeDTOList
     * @param <T>
     * @throws Exception
     */
    <T> void parser(T object, BillInfo billInfo, List<BankTradeDTO> payTradeDTOList, List<BankTradeDTO> refundTradeDTOList) throws Exception;
}

四、退款接口

农行也是对接了微信的api接口，所以我们要理解农行的退款机制，一定要先理解微信官方的api。这里还得吐槽下，它的对账机制没有杭州银行做得灵活。站在我们的角度，我们对接的是银行方，他们回复你的答案却是说“你对接的是微信”。真的是只做桥接啊！！

1、微信的退款接口

我们使用的老版接口，后面微信支付是有升级的，不过我们升级的意愿不大。

默认是使用未结算资金，
白话讲，就是当天收到了多少钱，这笔钱就是未结算的钱，这些钱才能用来抵扣退款给用户的钱。

2、农行的退款接口

没有退款资金来源的字段！！也就是说我们无法指定退款资金的来源，任由农行的退款机制。它使用的是微信默认方式，不让对接方选择。你说气人不气人~~

    @NoArgsConstructor
    @AllArgsConstructor
    @Builder
    @Data
    public static class DicRequest {
        /**
         * 退款-Refund
         */
        private String trxType;

        /**
         * 订单日期: YYYY/MM/DD
         */
        private String orderDate;
        /**
         * 订单时间: HH:MM:SS
         */
        private String orderTime;

        /**
         * 平台支付流水号
         */
        private String orderNo;

        /**
         * 退款交易编号
         */
        private String newOrderNo;

        /**
         * 币种：156-人民币
         */
        private Integer currencyCode;

        /**
         * 退款金额，单位：元
         */
        private String trxAmount;

    }

五、劝退

本文对农行的退款出现的一个大坑做了具体分析，希望能帮助到要对接农行的朋友。奉劝需要对接退款的朋友，本文可以算是劝退篇了！！

上一篇下一篇

猜你喜欢

热点阅读