4. 商户证书与平台证书管理

商户与支付平台之间的双向认证依赖 X.509 证书体系。商户需要维护两套证书：商户证书（用于向平台证明身份）和平台证书（用于验证平台返回数据的签名）。本章围绕证书的生命周期管理，重点讲解获取、链验证、过期处理与自动更新。

4.1 证书体系原理

商户证书通常由支付平台签发（或由商户自签名后上传），平台证书则由商户主动拉取后缓存。证书链验证遵循 X.509 v3 路径验证：从叶子证书逐级向上，直到自签名的根证书。

4.2 获取商户证书

4.2.1 文件形式

支付平台通常提供两种方式让商户获取证书：

• 控制台下载：登录商户平台，在“安全设置”中下载包含私钥的 PKCS#12 文件（密码保护）。
• API 签发：调用平台提供证书签发接口，生成 CSR 并上传，平台返回已签名的商户证书和中间 CA。

获取后应执行以下操作：

1. 将 .p12 转换为 PEM 格式（私钥 + 证书分离）。
2. 提取证书链文件（商户证书 + 中间 CA + 根 CA 串联）。
3. 计算证书指纹（SHA256）并记录，用于运行时校验。

# 将 p12 转换为私钥 PEM（需要输入密码）
openssl pkcs12 -in merchant.p12 -nocerts -nodes -out merchant_key.pem

# 提取证书链（包含全部 CA）
openssl pkcs12 -in merchant.p12 -nokeys -chain -out merchant_chain.pem

# 验证证书链是否完整
openssl verify -CAfile root_ca.pem -untrusted intermediate.pem merchant_chain.pem

4.2.2 代码加载

SDK 中常见的证书加载实现（以 Java 为例）：

import java.security.KeyStore;
import java.security.cert.CertificateFactory;
import java.security.cert.X509Certificate;
import java.io.FileInputStream;

// 加载私钥和证书链（PKCS12）
KeyStore ks = KeyStore.getInstance("PKCS12");
ks.load(new FileInputStream("merchant.p12"), "password".toCharArray());
PrivateKey privateKey = (PrivateKey) ks.getKey("alias", "password".toCharArray());
X509Certificate[] chain = (X509Certificate[]) ks.getCertificateChain("alias");

// 加载平台根证书
CertificateFactory cf = CertificateFactory.getInstance("X.509");
X509Certificate root = (X509Certificate) cf.generateCertificate(new FileInputStream("root_ca.pem"));

4.3 验证证书链

4.3.1 验证流程

SDK 中建议使用平台提供的验证 API 或标准库的 PKIXParameters：

import java.security.cert.*;

CertPathBuilder builder = CertPathBuilder.getInstance("PKIX");
X509CertSelector selector = new X509CertSelector();
selector.setCertificate(merchantCert);
PKIXBuilderParameters params = new PKIXBuilderParameters(trustStore, selector);
params.setRevocationEnabled(false); // 生产应启用 CRL/OCSP
CertPath certPath = builder.build(params).getCertPath();

4.3.2 常见验证失败原因

4.4 证书过期处理

证书过期会导致签名验证失败，支付请求被拒绝。处理策略：

• 提前预警：在证书到期前 30 天通过日志、告警通知运维。
• 自动切换：SDK 在加载证书时检查有效期，若剩余天数低于阈值（如 7 天），触发异步更新。
• 双证书缓冲：保存新旧两套证书，在新证书生效前旧证书仍可处理正在进行的交易。

// 证书过期检查示例
long daysUntilExpiry = (merchantCert.getNotAfter().getTime() - System.currentTimeMillis()) 
                        / (1000 * 60 * 60 * 24);
if (daysUntilExpiry < 7) {
    logger.warn("商户证书将在 {} 天后过期，开始更新", daysUntilExpiry);
    certificateUpdater.scheduleUpdate();
}

4.5 自动更新机制

4.5.1 更新流程

1. 检测触发：定时任务（每小时）检查证书有效期或收到平台推送的证书更换通知。
2. 下载新证书：调用平台提供的“获取最新证书” API，返回新商户证书链及中间 CA。
3. 链验证：对新链执行 X.509 验证，确保由同一 CA 签发。
4. 指纹比对：检查新证书的序列号、主题、公钥指纹与旧证书的差异，排除中间人攻击。
5. 平滑切换：更新内存中的证书引用，旧证书保留一个时间段（如 5 分钟）以处理迁移中的请求。
6. 持久化：将新证书写入持久存储（文件 / 数据库 / 密钥管理服务）。

4.5.2 平台证书的自动更新

平台证书（公钥）的更新通常由商户主动拉取：

• 定时轮询平台提供的“证书列表”接口（返回 JSON 数组，包含证书序列号、有效期、公钥 PEM）。
• 根据平台推送的 certificate_change_notification 回调事件触发更新。
• 更新时注意保留旧证书直到新的平台证书被验证为有效（避免误替换导致验签失败）。

// 拉取平台证书示例（伪代码）
List<PlatformCert> certs = fetchPlatformCertificates();
for (PlatformCert candidate : certs) {
    if (candidate.getSerialNumber().equals(currentSerial)) {
        continue; // 已有的证书
    }
    // 验证新证书链
    if (verifyChain(candidate.getCertPem(), rootCaList)) {
        cachePlatformCert(candidate);
        logger.info("更新平台证书 {}, 有效期至 {}", candidate.getSerial(), candidate.getExpiry());
    }
}

4.6 证书生命周期 SVG 图

4.7 调试与常见错误

4.7.1 调试建议

• 使用 openssl x509 -text -noout -in cert.pem 查看证书详细信息。
• 启用 SDK 的调试日志：-Djavax.net.debug=ssl:handshake（Java）或 LOG_LEVEL=DEBUG。
• 在测试环境中对同一证书链使用 openssl verify -CAfile root.pem -untrusted intermediate.pem 手动验证。

4.7.2 常见错误及对策

4.8 性能与稳定性优化

• 证书缓存：将平台证书列表在内存中缓存，减少对外部接口的频繁调用。设置缓存刷新间隔（建议 10 分钟）。
• 异步更新：证书过期检查和更新操作在独立后台线程执行，不阻塞业务请求。
• 重试策略：自动更新失败后使用指数退避（初始 1s，最大 5min），防止对平台服务造成冲击。
• 监控告警：上报证书剩余天数指标到监控系统（如 Prometheus），设置 P1 告警（证书剩余天数 < 3 天）。
• 降级预案：如果更新连续失败超过 3 次，切换为手动模式并通知运维；生产环境保留离线证书部署脚本作为最后手段。