99AI 文档

主题

支付配置 ​

配置概述 ​

支付配置用于管理系统支持的支付方式，包括启用/禁用支付方式、选择支付渠道和设置显示优先级。系统支持微信支付、支付宝、PayPal、Stripe 等多种支付方式。

主要功能：

  • 支付方式管理：启用或禁用各种支付方式
  • 渠道选择：为每个支付方式选择具体的支付渠道
  • 优先级设置：控制支付方式在用户端的显示顺序
  • 灵活配置：根据业务需求选择合适的支付方式

配置项说明 ​

微信支付 ​

启用状态 ​

  • 说明：控制是否在用户端显示微信支付选项
  • 选项：启用/禁用
  • 提示：禁用后用户无法使用微信支付

支付渠道 ​

  • 说明：选择微信支付的支付渠道
  • 选项：
    • wechat_official：微信公众号支付
    • wechat_h5：微信 H5 支付
    • wechat_app：微信 APP 支付
    • 其他第三方聚合支付渠道
  • 必填：是
  • 提示：需在渠道配置中先配置对应渠道的参数

优先级 ​

  • 说明：控制微信支付在用户端的显示顺序
  • 格式：数字输入
  • 排序规则：数字越小越靠前
  • 建议：设置为主要支付方式时可设为 1

支付宝 ​

启用状态 ​

  • 说明：控制是否在用户端显示支付宝选项
  • 选项：启用/禁用

支付渠道 ​

  • 说明：选择支付宝的支付渠道
  • 选项：
    • alipay_official：支付宝官方
    • epay：易支付等第三方聚合支付
    • 其他聚合支付渠道
  • 必填：是

优先级 ​

  • 说明：控制支付宝在用户端的显示顺序
  • 格式：数字输入
  • 建议：设为 2，仅次于微信支付

PayPal ​

启用状态 ​

  • 说明：控制是否在用户端显示 PayPal 选项
  • 选项：启用/禁用
  • 提示：适合海外用户

支付渠道 ​

  • 说明：选择 PayPal 的支付渠道
  • 选项：
    • paypal_official：PayPal 官方
    • 其他第三方渠道
  • 必填：是

优先级 ​

  • 说明：控制 PayPal 在用户端的显示顺序
  • 格式：数字输入
  • 建议：设为 3，作为补充支付方式

Stripe ​

启用状态 ​

  • 说明：控制是否在用户端显示 Stripe 选项
  • 选项：启用/禁用
  • 提示：支持信用卡支付，适合国际用户

支付渠道 ​

  • 说明：选择 Stripe 的支付渠道
  • 选项：
    • stripe_official：Stripe 官方
    • 其他第三方渠道
  • 必填：是

优先级 ​

  • 说明：控制 Stripe 在用户端的显示顺序
  • 格式：数字输入
  • 建议：设为 4，作为国际支付方式

配置流程 ​

配置支付方式前的准备工作 ​

  1. 申请支付账号：

    • 微信支付：需要企业资质，在微信商户平台申请
    • 支付宝：需要企业资质，在支付宝开放平台申请
    • PayPal：在 PayPal 官网注册商户账号
    • Stripe：在 Stripe 官网注册账号

  2. 配置支付渠道：

    • 在"渠道配置"中填写各支付渠道的参数
    • 包括商户号、API 密钥、证书等
    • 确保渠道配置测试通过

  3. 启用支付方式：

    • 在支付配置中启用对应的支付方式
    • 选择已配置的支付渠道
    • 设置合理的优先级

推荐配置顺序 ​

国内用户为主：

  1. 微信支付（优先级 1）
  2. 支付宝（优先级 2）
  3. 其他支付方式作为补充

国际用户为主：

  1. PayPal（优先级 1）
  2. Stripe（优先级 2）
  3. 其他支付方式作为补充

混合用户群体：

  1. 微信支付（优先级 1）
  2. 支付宝（优先级 2）
  3. PayPal（优先级 3）
  4. Stripe（优先级 4）

配置建议 ​

支付方式选择 ​

根据用户群体选择：

  • 国内用户：微信支付 + 支付宝（覆盖 95% 以上用户）
  • 海外用户：PayPal + Stripe（国际主流支付方式）
  • 混合用户：同时配置国内外支付方式

根据业务类型选择：

  • 电商购物：微信支付 + 支付宝
  • 数字服务：可增加 PayPal 和 Stripe
  • 企业服务：银行转账 + 对公账户

优先级设置策略 ​

  1. 主流支付方式：设为 1-3
  2. 补充支付方式：设为 4-6
  3. 备用支付方式：设为 7+

渠道选择建议 ​

官方渠道 vs 第三方渠道：

官方渠道优势：

  • 费率较低
  • 直接对接，稳定性好
  • 资金到账快

第三方渠道优势：

  • 接入简单，一个渠道支持多种支付方式
  • 统一管理，减少维护成本
  • 适合中小企业

安全建议 ​

  1. 密钥管理：

    • 不要在代码中硬编码密钥
    • 定期更换 API 密钥
    • 使用环境变量存储敏感信息

  2. 回调验证：

    • 验证支付回调的真实性
    • 检查订单金额和状态
    • 防止重复处理同一订单

  3. 日志记录：

    • 记录所有支付请求和响应
    • 记录异常和错误信息
    • 便于问题排查和对账

常见问题 ​

Q：为什么支付配置保存后无法使用？ ​

A：请检查：

  1. 是否已在"渠道配置"中配置对应渠道参数
  2. 渠道参数是否正确（商户号、密钥等）
  3. 是否启用了该支付方式
  4. 查看服务器日志获取详细错误信息

Q：如何测试支付功能？ ​

A：

  1. 使用支付平台的测试环境（沙箱）
  2. 创建测试订单，进行小额测试
  3. 验证支付流程和回调处理
  4. 测试通过后再切换到生产环境

Q：可以同时使用多个支付渠道吗？ ​

A：可以。但建议：

  1. 每个支付方式只选择一个主渠道
  2. 其他渠道作为备用
  3. 主渠道故障时自动切换到备用渠道

Q：支付失败如何处理？ ​

A：

  1. 查看订单状态和错误日志
  2. 检查渠道配置是否正确
  3. 确认支付平台账号状态正常
  4. 联系支付平台客服查询

Q：如何查看支付数据统计？ ​

A：

  • 在订单列表中可以查看所有支付记录
  • 可以按支付方式、时间范围筛选
  • 导出数据进行进一步分析

Q：支持哪些货币？ ​

A：

  • 微信支付、支付宝：主要支持人民币（CNY）
  • PayPal、Stripe：支持多种国际货币（USD、EUR 等）
  • 具体支持的货币取决于支付平台和渠道配置

Q：如何处理退款？ ​

A：

  1. 在订单管理中找到需要退款订单
  2. 通过支付平台提供的退款接口处理
  3. 记录退款原因和相关信息
  4. 更新订单状态和用户余额

相关文档 ​