德尚网络

Appearance

微信支付配置 ​

概述 ​

DSMall Pro集成了微信支付服务，支持公众号支付、小程序支付、H5支付等多种支付方式。本文档介绍如何配置微信支付服务。

关联提示：配置完成后，请参考 微信账户关联配置 将支付商户号关联到公众号和小程序。

申请微信支付 ​

1. 注册微信支付商户号 ​

  1. 访问 微信支付商户平台
  2. 点击"立即注册"
  3. 填写企业信息并提交资质材料
  4. 等待审核通过

2. 开通支付产品 ​

商户号审核通过后，需要开通相关支付产品：

2.1 开通公众号支付 ​

  1. 进入"产品中心" → "JSAPI支付"
  2. 点击"立即开通"

获取配置信息 ​

1. 获取商户信息 ​

  1. 登录微信支付商户平台
  2. 进入"账户中心" → "商户信息"
  3. 记录以下信息：
    • 商户号：微信支付商户号

2. 配置API密钥（APIV3） ​

2.1 申请API证书 ​

请按照 微信支付官方证书申请文档 完成证书申请。

2.2 下载证书文件 ​

2.3 设置API密钥 ​

请按照 APIv3密钥设置方法

安全提醒：

  • API密钥和证书文件是支付安全的核心
  • 请妥善保管，不要泄露给他人
  • 建议定期更换API密钥
  • 证书文件请备份到安全位置

3. 关联AppID ​

  1. 进入"产品中心" → "AppID账号管理"
  2. 点击"添加关联"
  3. 输入公众号AppID，设置支付权限
  4. 输入小程序AppID，设置支付权限
  5. 确认关联状态

详细步骤：请参考 微信支付AppID关联管理文档

配置步骤 ​

1. 网站后台配置 ​

在系统管理后台中配置：

  • 财务 → 收款设置
  • 填入以下信息：
    • APPID：微信支付商户号
    • 商户号：微信支付商户号
    • API密钥：APIV3密钥(商户秘钥)
    • 商户私钥：粘贴 apiclient_key.pem 文件内容
    • 商户公钥 ：粘贴 apiclient_cert.pem 文件内容
    • 微信支付公钥ID：微信支付公钥ID
    • 微信支付公钥：粘贴 wechatpay_cert.pem 文件内容
  • 保存配置

2. 开发配置 ​

在微信支付商户平台配置支付授权目录：

  1. 进入"产品中心" → "开发配置"
  2. 配置支付授权目录：
    • 公众号支付授权目录：https://yourdomain.com/
  3. 保存配置

开发配置界面

关联要求：配置完成后，请确保：

  • 商户号已关联公众号AppID
  • 商户号已关联小程序AppID
  • API证书已正确配置
  • 支付授权目录已配置

2. 支付方式配置 ​

根据业务需求配置支付方式：

公众号支付（JSAPI支付） ​

  • 适用于公众号内支付
  • 需要公众号已关联商户号
  • 需要已开通JSAPI支付产品

小程序支付 ​

  • 适用于小程序内支付
  • 需要小程序已关联商户号
  • 商户号审核通过后即可使用

功能说明 ​

配置完成后，系统将支持：

  • 公众号内支付
  • 小程序内支付
  • 支付结果通知
  • 退款功能

安全建议 ​

  1. 保护API密钥：不要泄露API密钥和证书文件
  2. 使用HTTPS：所有接口必须使用HTTPS
  3. 验证签名：验证支付回调签名
  4. 定期更新证书：定期更换API证书和密钥
  5. 监控异常交易：设置交易监控
  6. 限制支付权限：只开通必要的支付产品
  7. 备份证书文件：定期备份证书文件到安全位置

常见问题 ​

Q：支付失败调试 ​

解决方案：

1. 开启调试日志 ​

当遇到支付失败问题时，可以通过以下方式开启调试日志：

修改配置文件

php
// 在 BaseTrade.php 中修改配置
protected $config = [
    'logger' => [
        'enable' => true,  // 开启日志
        'file' => './public/logs/pay.log',  // 日志文件路径
        'level' => 'debug',  // 设置为debug级别
        'type' => 'single',
        'max_file' => 30,
    ],
];

2. 查看调试日志 ​

开启调试后，支付相关的详细日志会记录在 public/logs/pay.log 文件中，包括：

最后更新：2024-01-20
维护者：DSPlatform技术团队