Files

微信支付密钥文件说明

文件说明

必需文件

  1. apiclient_cert.p12 - 微信支付商户证书
    • 文件大小约2-3KB
    • 用途:用于退款、撤销等需要证书的操作
    • 获取方式:从微信商户平台下载

可选文件

  1. apiclient_key.pem - 微信支付私钥文件

    • 用途:用于签名验证
    • 格式PEM格式的私钥文件
  2. apiclient_cert.pem - 微信支付公钥文件

    • 用途:用于验证微信返回的数据
    • 格式PEM格式的公钥文件

获取方式

1. 登录微信商户平台

2. 下载证书

  • 进入:账户中心 → API安全 → API证书
  • 下载 apiclient_cert.p12 文件

3. 设置证书密码

  • 下载时会要求设置证书密码
  • 请妥善保管密码,后续配置需要用到

配置说明

application.yml 配置

wx2:
  # 证书路径(需要配置全路径)
  certUrl: ${WX_CERT_URL:./certs/wechat/apiclient_cert.p12}

环境变量配置

# Windows
set WX_CERT_URL=C:\Users\admin\Desktop\1818AI_admin\1818_user_server\certs\wechat\apiclient_cert.p12

# Linux/Mac
export WX_CERT_URL=/path/to/project/certs/wechat/apiclient_cert.p12

安全建议

  1. 文件权限:设置适当的文件读取权限
  2. 路径安全:不要使用相对路径,使用绝对路径
  3. 定期更新证书有效期通常为1年请及时更新
  4. 备份管理:将证书文件备份到安全位置

常见问题

Q: 证书文件路径错误

A: 确保使用绝对路径,并且文件确实存在于指定位置

Q: 证书密码错误

A: 检查证书密码是否正确,密码通常在下载时设置

Q: 证书文件损坏

A: 重新从微信商户平台下载证书文件

Q: 权限不足

A: 确保应用有读取证书文件的权限

测试验证

配置完成后,可以通过以下方式测试:

  1. 启动应用
  2. 调用退款接口
  3. 检查日志中是否有证书相关错误
  4. 确认退款功能正常工作

注意事项

⚠️ 重要提醒

  • 证书文件包含敏感信息,请勿泄露
  • 生产环境建议使用环境变量配置路径
  • 定期检查证书有效期
  • 证书丢失请立即联系微信支付客服