channel_config_checklist.md 6.6 KB

渠道配置清单

概述

本文档为系统支持的所有渠道提供快速配置清单,帮助开发者快速了解各渠道的配置要点和注意事项。

渠道配置清单

微信生态

微信公众号 (wechat_official_account)

  • 必填参数: AppId, AppSecret, Token
  • 支付方式: ✅微信支付, ✅余额支付
  • 登录方式: 网页授权, 绑定手机号
  • 关键配置:
    • 网页授权域名
    • JS接口安全域名
    • 支付授权目录
  • 注意事项: 需要认证公众号, 配置服务器验证

微信小程序 (wechat_mini_program)

  • 必填参数: AppId, AppSecret
  • 支付方式: ✅微信支付, ✅余额支付
  • 登录方式: 自动登录, 绑定手机号
  • 关键配置:
    • 服务器域名配置
    • 支付回调域名
    • 业务域名配置
  • 注意事项: 需要小程序认证, 支付需要真机测试

移动应用

iOS APP (ios_app)

  • 必填参数: Bundle ID, App Store ID, Team ID
  • 支付方式: ✅微信支付, ✅支付宝支付, ✅余额支付
  • 登录方式: 苹果登录, 微信登录, 绑定手机号
  • 关键配置:
    • 开发者证书
    • Provisioning Profile
    • 推送证书
  • 注意事项: 需要Apple开发者账号, 严格遵守审核指南

Android APP (android_app)

  • 必填参数: Package Name, App签名
  • 支付方式: ✅支付宝支付, ✅微信支付, ✅余额支付
  • 登录方式: Google登录, 微信登录, 绑定手机号
  • 关键配置:
    • 应用签名配置
    • 推送服务配置
    • 权限申请
  • 注意事项: 需要Google开发者账号, 适配不同Android版本

网页端

H5 (h5)

  • 必填参数: 域名, SSL证书
  • 支付方式: ✅微信支付, ✅支付宝支付, ✅余额支付
  • 登录方式: 微信登录, QQ登录, 绑定手机号
  • 关键配置:
    • HTTPS配置
    • CDN配置
    • SEO优化
  • 注意事项: 需要域名备案, 移动端适配

PC (pc)

  • 必填参数: 域名, SSL证书
  • 支付方式: ✅支付宝支付, ✅线下支付, ✅余额支付
  • 登录方式: QQ登录, 微信登录, 绑定手机号
  • 关键配置:
    • 响应式设计
    • 浏览器兼容性
    • 统计分析配置
  • 注意事项: 考虑IE兼容性, 大屏幕适配

小程序平台

抖音小程序 (douyin_mini_program)

  • 必填参数: AppId, AppSecret
  • 支付方式: ✅支付宝支付, ✅余额支付
  • 登录方式: 自动登录, 绑定手机号
  • 关键配置:
    • 服务器域名配置
    • 支付回调地址
  • 注意事项: 不支持微信支付, 审核周期较长

QQ小程序 (qq_mini_program)

  • 必填参数: AppId, AppSecret
  • 支付方式: ✅余额支付
  • 登录方式: 自动登录, 绑定手机号
  • 关键配置:
    • 服务器域名配置
  • 注意事项: 仅支持余额支付, 需要引导用户充值

支付宝小程序 (alipay_mini_program)

  • 必填参数: AppId, 私钥, 公钥
  • 支付方式: ✅支付宝支付, ✅余额支付
  • 登录方式: 自动登录, 绑定手机号
  • 关键配置:
    • RSA密钥配置
    • 服务器域名配置
  • 注意事项: 原生支持支付宝支付, 密钥配置复杂

配置优先级

高优先级配置

  1. 基本信息: 渠道状态、名称、描述
  2. 平台参数: AppId、AppSecret、密钥等
  3. 域名配置: HTTPS域名、备案状态
  4. 支付配置: 商户号、回调地址

中优先级配置

  1. 登录配置: 第三方登录、自动登录
  2. 功能开关: 各种功能的开启状态
  3. 安全配置: SSL证书、加密设置

低优先级配置

  1. UI配置: 主题色彩、图标设置
  2. 统计配置: 埋点统计、数据分析
  3. 优化配置: CDN、缓存设置

通用配置要求

域名要求

  • 必须使用HTTPS协议
  • 域名需要完成备案
  • 配置正确的DNS解析
  • 申请有效的SSL证书

支付配置

  • 开通对应的商户号
  • 配置正确的回调地址
  • 设置支付证书和密钥
  • 测试支付功能完整性

登录配置

  • 配置第三方登录平台
  • 设置用户授权流程
  • 处理登录失败情况
  • 绑定用户手机号验证

安全配置

  • 使用HTTPS加密传输
  • 配置防火墙和安全策略
  • 定期更新SDK版本
  • 监控安全漏洞

测试验证清单

功能测试

  • 登录授权流程
  • 支付功能完整性
  • 分享功能测试
  • 基本业务流程

兼容性测试

  • 不同设备适配
  • 不同系统版本
  • 不同浏览器支持
  • 网络环境测试

性能测试

  • 页面加载速度
  • 接口响应时间
  • 资源使用情况
  • 内存泄漏检查

安全测试

  • 数据传输加密
  • 用户信息保护
  • 支付安全验证
  • 接口安全防护

常见问题汇总

配置类问题

  1. AppId获取失败: 检查开发者平台账号状态
  2. 域名配置错误: 确认域名备案和DNS解析
  3. 证书配置失败: 检查证书有效期和格式

支付类问题

  1. 支付失败: 检查商户号配置和回调地址
  2. 支付回调异常: 确认回调地址可访问性
  3. 支付金额限制: 了解各平台支付限额

登录类问题

  1. 授权失败: 检查AppId和域名配置
  2. 用户信息获取失败: 确认授权作用域设置
  3. 登录状态丢失: 检查session和token管理

发布类问题

  1. 审核被拒: 仔细阅读审核指南和拒绝理由
  2. 版本发布失败: 检查包体大小和资源配置
  3. 功能不可用: 确认所有配置项正确设置

配置维护

定期检查

  • 证书过期时间
  • 域名续费状态
  • 开发者账号有效性
  • 第三方SDK版本

安全更新

  • 及时更新SDK版本
  • 修复已知安全漏洞
  • 更新加密算法
  • 强化访问控制

性能优化

  • 监控接口性能
  • 优化资源加载
  • 调整缓存策略
  • 升级服务器配置

技术支持

官方文档

开发工具

社区支持

  • 官方开发者社区
  • 技术交流群
  • 在线技术支持
  • 问题反馈渠道

注意: 本清单会根据各平台政策变化和技术更新进行调整,请定期查看最新版本。