fastadmin_tailored/docs/channel/wechat_mini_program.md

微信小程序渠道配置

概述

微信小程序是微信生态中的重要应用形态，具有免安装、即用即走的特点。本文档描述了微信小程序渠道的完整配置流程。

基本信息

• 渠道标识: wechat_mini_program
• 渠道名称: 微信小程序
• 渠道类型: 小程序
• 所属分组: 微信生态 (wechat)

配置要素

1. 基本配置

// 渠道基本信息
'channel' => 'wechat_mini_program',
'name' => '微信小程序',
'status' => true, // 开启/关闭
'description' => '微信小程序平台接入'

2. 微信平台配置

必填参数

• AppId: 小程序应用ID
• AppSecret: 小程序应用密钥

配置示例

'wechat_config' => [
    'appid' => 'wx9a7153e5b40d9663',
    'secret' => '8a743955faa5873af394f31d4a58c086',
    'token' => '', // 消息推送Token（可选）
    'aes_key' => '', // 消息加解密Key（可选）
]

获取方式

1. 登录微信公众平台 (mp.weixin.qq.com)
2. 选择小程序类型
3. 在「开发」-「开发管理」-「开发设置」中获取

3. 支付配置

微信小程序支持以下支付方式：

3.1 微信支付 ✅ (推荐)

• 状态: 开启
• 优先级: 1
• 配置要求:
  • 需要开通微信支付商户号
  • 配置支付回调域名
  • 设置支付证书

'payment_config' => [
    'wechat' => [
        'enabled' => true,
        'mch_id' => '商户号',
        'key' => '商户密钥',
        'cert_path' => '证书路径',
        'key_path' => '密钥路径',
        'notify_url' => '支付回调地址'
    ]
]

3.2 余额支付 ✅

• 状态: 开启
• 优先级: 2
• 说明: 用户使用账户余额进行支付

'payment_config' => [
    'balance' => [
        'enabled' => true,
        'min_amount' => 0.01, // 最小支付金额
        'max_amount' => 10000, // 最大支付金额
    ]
]

3.3 不支持的支付方式 ❌

• 支付宝支付
• 线下支付
• 货到付款

4. 登录配置

4.1 自动登录

• 状态: 开启/关闭
• 说明: 进入应用后，用户将会自动授权登录，未注册用户将会自动注册

'login_config' => [
    'auto_login' => true,
    'auto_register' => true,
]

4.2 绑定手机号

• 状态: 开启/关闭
• 说明: 授权登录后，未绑定手机号的用户，将会立即提醒绑定手机号

'login_config' => [
    'force_mobile' => true,
    'mobile_verify' => true, // 手机号验证
]

5. 功能特性

功能	支持状态	说明
支付功能	✅	支持微信支付、余额支付
分享功能	✅	支持分享到微信好友、朋友圈
定位功能	✅	支持获取用户地理位置
拍照功能	✅	支持调用摄像头拍照
推送功能	✅	支持模板消息推送

配置流程

1. 微信公众平台配置

1. 注册小程序

   • 访问 https://mp.weixin.qq.com
   • 注册小程序账号
   • 完成主体认证

2. 获取开发信息

   • 在「开发」-「开发管理」-「开发设置」中获取AppID
   • 生成AppSecret

3. 配置服务器域名

   • 在「开发」-「开发管理」-「开发设置」中配置
   • request合法域名：https://your-domain.com
   • uploadFile合法域名：https://your-domain.com
   • downloadFile合法域名：https://your-domain.com

4. 配置支付域名（如需支付功能）

   • 在微信支付商户平台配置
   • 设置支付回调域名

2. 系统后台配置

1. 基本信息配置

   渠道状态: 开启
   渠道名称: 微信小程序
   渠道描述: 微信小程序平台
   

2. 平台参数配置

   AppId: wx9a7153e5b40d9663
   AppSecret: 8a743955faa5873af394f31d4a58c086
   

3. 支付方式配置

   微信支付: 开启
   余额支付: 开启
   支付宝支付: 关闭
   货到付款: 关闭
   

4. 登录方式配置

   自动登录: 开启
   绑定手机号: 开启
   

3. 开发配置

1. 小程序代码配置

   // app.js
   App({
    globalData: {
      apiUrl: 'https://your-domain.com/api',
      appId: 'wx9a7153e5b40d9663'
    }
   })
   

   1. 登录授权 javascript // 获取用户信息 wx.getUserProfile({ desc: '用于完善会员资料', success: (res) => { // 发送用户信息到服务器 } })

2. 支付调用

   // 微信支付
   wx.requestPayment({
    timeStamp: '',
    nonceStr: '',
    package: '',
    signType: 'MD5',
    paySign: '',
    success: function(res) {
      // 支付成功
    }
   })
   

   测试验证

   1. 开发者工具测试

   • 使用微信开发者工具
   • 测试登录授权流程
   • 测试支付功能（需要真机）

   2. 真机测试

   • 扫码体验版小程序
   • 测试完整业务流程
   • 验证支付功能

   3. 接口测试

   # 测试登录接口
   curl -X POST "https://your-domain.com/api/login" \
   -H "Content-Type: application/json" \
   -d '{"code":"微信登录code","channel":"wechat_mini_program"}'
   
   # 测试支付接口
   curl -X POST "https://your-domain.com/api/payment/create" \
   -H "Content-Type: application/json" \
   -d '{"amount":100,"channel":"wechat_mini_program","payment_type":"wechat"}'
   

注意事项

1. 域名配置

   • 必须使用HTTPS协议
   • 域名需要备案
   • 需要在微信公众平台配置合法域名

2. 支付配置

   • 需要开通微信支付
   • 配置支付回调地址
   • 测试环境和生产环境分别配置

3. 用户授权

   • 获取用户信息需要用户主动授权
   • 不能强制用户授权
   • 需要做好授权失败的处理

4. 版本发布

   • 开发完成后需要提交审核
   • 审核通过后才能发布
   • 建议先发布体验版测试

常见问题

Q1: AppId和AppSecret在哪里获取？

A: 在微信公众平台的「开发」-「开发管理」-「开发设置」中获取。

Q2: 为什么不支持支付宝支付？

A: 微信小程序只支持微信支付，不支持第三方支付。

Q3: 如何测试支付功能？

A: 支付功能需要在真机上测试，开发者工具无法测试支付。

Q4: 登录授权失败怎么办？

A: 检查域名配置、AppId配置，确保小程序已发布或设置为体验版。

相关链接

• 微信小程序开发文档
• 微信支付开发文档
• 微信公众平台
• 微信开发者工具