银联订阅ChatGPT支付对接实战：从技术选型到生产环境避坑指南

3次阅读

没有评论

共计 2608 个字符，预计需要花费 7 分钟才能阅读完成。

订阅类业务在支付环节常遇到几个典型问题：

重复扣款 ：由于网络抖动或系统重试机制，可能导致同一笔订单多次发起支付请求。
回调丢失 ：支付平台的通知可能因各种原因未能及时送达，导致订单状态不同步。
状态同步延迟 ：异步通知的延迟会导致用户体验下降，用户可能已经支付成功但服务未及时开通。

银联订阅相比其他支付渠道有几个技术优势：

交易状态明确性 ：银联的异步通知机制确保了交易状态的最终一致性，通知内容包含明确的交易结果。
支持长周期订阅 ：银联的协议支付支持按月、按年等长周期扣款，适合订阅类业务。
高可用性 ：银联的支付通道稳定性高，适合高并发场景。

引入依赖 ：

<dependency>
    <groupId>com.unionpay</groupId>
    <artifactId>acp-sdk-java</artifactId>
    <version>5.1.0</version>
</dependency>

初始化配置 ：

// 加载银联配置文件
SDKConfig.getConfig().loadPropertiesFromPath("/path/to/acp_sdk.properties");

生成签约协议号 ：

// 生成唯一的协议号，建议格式：商户 ID + 时间戳 + 随机数
String agreementNo = "MERCHANT" + System.currentTimeMillis() + new Random().nextInt(1000);

public boolean verifySign(Map<String, String> params) {
    try {
        // 使用银联 SDK 验签
        return AcpService.validate(params, "UTF-8");
    } catch (Exception e) {log.error("验签失败", e);
        return false;
    }
}

// 订单状态枚举
public enum OrderStatus {
    INIT,       // 初始状态
    PAYING,     // 支付中
    SUCCESS,    // 支付成功
    FAILED,     // 支付失败
    CLOSED      // 订单关闭
}

// 状态机处理
public void handlePaymentNotify(PaymentNotify notify) {
    // 1. 验签
    if (!verifySign(notify.getParams())) {throw new RuntimeException("验签失败");
    }

    // 2. 查询本地订单
    Order order = orderDao.findByOrderNo(notify.getOrderNo());

    // 3. 状态机处理
    if (order.getStatus() == OrderStatus.INIT) {order.setStatus(OrderStatus.PAYING);
        orderDao.update(order);
    }

    // 4. 处理支付结果
    if (notify.isSuccess()) {order.setStatus(OrderStatus.SUCCESS);
        // 开通服务
        subscriptionService.activate(order.getUserId());
    } else {order.setStatus(OrderStatus.FAILED);
    }

    orderDao.update(order);
}

指数退避重试机制 ：
第一次失败后等待 1 秒重试
第二次失败后等待 3 秒重试
第三次失败后等待 10 秒重试

public void retryPayment(Order order, int retryCount) {
    try {
        // 发起支付
        paymentService.pay(order);
    } catch (Exception e) {if (retryCount < MAX_RETRY) {
            // 计算等待时间：1, 3, 10, 30... 秒
            long waitTime = (long) Math.pow(3, retryCount) * 1000;
            Thread.sleep(waitTime);
            retryPayment(order, retryCount + 1);
        }
    }
}

网络超时配置 ：
连接超时：建议 5 秒
读取超时：建议 15 秒

每日定时对账流程 ：
凌晨 2 点启动对账任务
下载银联对账文件
逐笔核对本地订单与银联记录
生成差异报告并自动处理常见差异

@Scheduled(cron = "0 0 2 * * ?")
public void dailyReconciliation() {
    // 1. 下载对账文件
    File reconFile = unionPayService.downloadReconFile("yesterday");

    // 2. 解析文件
    List<ReconRecord> records = parseReconFile(reconFile);

    // 3. 核对订单
    for (ReconRecord record : records) {Order order = orderDao.findByOrderNo(record.getOrderNo());
        if (order == null || order.getStatus() != record.getStatus()) {
            // 记录差异
            reconDiffDao.save(new ReconDiff(record, order));
        }
    }

    // 4. 处理差异
    handleReconDiffs();}