张掖市微信小店开发教程

‌

一、开发前准备​​

1. 注册并开通微信小店

• ​​主体要求​​：需为企业/个体工商户（个人暂不支持），需提供营业执照、法人身份证、银行账户等信息。
• ​​步骤​​：
1. 登录 微信公众平台，注册并认证公众号（服务号或小程序）。
2. 进入公众号后台 → 左侧导航栏「微信小店」→ 点击「开通」，按提示提交资质（营业执照、管理员信息等）。
3. 审核通过后，小店基础功能（商品、订单、支付）自动开通。

2. 获取关键凭证

• ​​商户号（mch_id）​​：用于支付接口调用（需单独申请微信支付商户号，部分小店场景可能自动关联）。
• ​​API密钥（API Key）​​：用于接口签名验证（在微信支付商户平台设置）。
• ​​AppID​​：公众号或小程序的唯一标识（在各自后台获取）。
• ​​服务器IP白名单​​：需将开发服务器IP添加到微信公众平台或支付商户平台的“IP白名单”，否则接口调用会被拒绝。

3. 熟悉开发文档

• 官方接口文档：微信小商店开放平台（含商品、订单、物流等接口）。
• 微信支付文档：微信支付开发指南（支付、退款等核心功能）。

​​二、核心接口调用（以RESTful API为例）​​

微信小店提供​​商品管理、订单管理、物流查询、售后管理​​等API，需通过access_token鉴权。以下是关键步骤：

1. 获取access_token

access_token是调用所有接口的凭证，有效期2小时，需定期刷新。
​​请求示例（HTTP GET）​​：

http
复制
GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

• APPID：公众号/小程序的AppID；
• APPSECRET：公众号/小程序的密钥（需在后台保密）。

​​返回结果​​：

json
复制
{
  "access_token": "ACCESS_TOKEN",
  "expires_in": 7200
}

2. 商品管理接口（示例）

​​场景​​：新增一个商品到小店。
​​接口路径​​：POST https://api.weixin.qq.com/shop/goods/add?access_token=ACCESS_TOKEN
​​请求参数​​（JSON格式）：

json
复制
{
  "goods_detail": {
    "name": "测试商品",          // 商品名称（必填）
    "price": 100,              // 价格（分，必填）
    "description": "描述",       // 商品描述
    "image_url": "https://xxx.jpg", // 主图URL（必填）
    "category_id": 10001,      // 类目ID（需通过「类目查询」接口获取）
    "stock": 100               // 库存（必填）
  }
}

​​返回结果​​：

json
复制
{
  "errcode": 0,
  "errmsg": "success",
  "goods_id": 123456           // 商品ID（后续操作需用到）
}

3. 订单管理接口（示例）

​​场景​​：查询订单详情。
​​接口路径​​：GET https://api.weixin.qq.com/shop/order/get?access_token=ACCESS_TOKEN&order_id=ORDER_ID
​​返回结果​​（关键字段）：

json
复制
{
  "errcode": 0,
  "errmsg": "success",
  "order_info": {
    "order_id": "123456789",   // 订单ID
    "out_order_no": "商家订单号", // 商家自定义订单号
    "total_fee": 10000,        // 总金额（分）
    "status": "PAID",          // 订单状态（PAID=已支付，SHIPPED=已发货等）
    "goods_list": [            // 商品列表
      {
        "goods_id": 123,
        "goods_name": "测试商品",
        "quantity": 1
      }
    ]
  }
}

4. 支付接口（关键）

微信小店支付需通过​​微信支付商户号​​完成，核心流程：

1. 商家生成预支付订单（调用统一下单接口）；
2. 用户支付后，微信异步通知商家服务器；
3. 商家验证通知签名，更新订单状态。

​​统一下单接口示例（HTTP POST）​​：

http
复制
POST https://api.mch.weixin.qq.com/v3/pay/transactions/jsapi

​​请求参数（JSON）​​：

json
复制
{
  "mchid": "商户号",
  "out_trade_no": "商家订单号",
  "appid": "APPID",
  "description": "商品描述",
  "notify_url": "https://你的服务器/notify", // 支付结果通知地址
  "amount": {
    "total": 100,         // 金额（分）
    "currency": "CNY"
  },
  "payer": {
    "openid": "用户openid" // 用户在公众号内的唯一标识（需前端获取）
  }
}

​​注意​​：需使用商户私钥对请求签名（具体签名算法见微信支付签名指南）。

​​三、前端开发（公众号/H5/小程序）​​

1. 公众号内H5页面

• ​​JS-SDK集成​​：需引入微信JS-SDK，实现分享、获取用户信息等功能。

  html
  预览
  复制
  <script src="https://res.wx.qq.com/open/js/jweixin-1.6.0.js"></script>
  

  通过后端接口获取jsapi_ticket和签名，配置JS-SDK权限：

  javascript
  运行
  复制
  wx.config({
    debug: false,
    appId: 'APPID',
    timestamp: 时间戳,
    nonceStr: '随机字符串',
    signature: '签名',
    jsApiList: ['updateAppMessageShareData', 'scanQRCode'] // 需要使用的接口列表
  });
  

2. 小程序开发

• ​​关联小商店​​：小程序需绑定已开通的微信小店（在小程序后台「电商」→「小商店」中关联）。
• ​​调用小商店API​​：通过wx.request调用小商店接口（需先获取access_token）。

  javascript
  运行
  复制
  wx.request({
    url: 'https://api.weixin.qq.com/shop/goods/list?access_token=ACCESS_TOKEN',
    method: 'GET',
    success(res) {
      console.log('商品列表：', res.data);
    }
  });
  

3. 支付交互

• 用户点击支付时，前端调用wx.requestPayment（小程序）或跳转H5支付页面（公众号）。
  ​​小程序支付示例​​：

  javascript
  运行
  复制
  wx.requestPayment({
    timeStamp: '时间戳',
    nonceStr: '随机字符串',
    package: 'prepay_id=预支付ID',
    signType: 'RSA',
    paySign: '签名',
    success(res) { /* 支付成功 */ },
    fail(err) { /* 支付失败 */ }
  });
  

​​四、后端开发（核心逻辑）​​

1. 数据库设计

需设计以下核心表（根据业务扩展）：

• goods：存储商品信息（ID、名称、价格、库存、图片等）；
• orders：订单表（订单ID、用户openid、总金额、状态、创建时间等）；
• order_items：订单商品明细（关联订单ID和商品ID）；
• logistics：物流信息（订单ID、快递公司、运单号等）。

2. 异步通知处理

微信支付、订单状态变更等操作会通过​​异步通知​​告知商家（如支付成功通知）。需在后端：

1. 接收XML/JSON格式的通知数据；
2. 验证签名（确保数据来自微信）；
3. 处理业务逻辑（如更新订单状态、发货）；
4. 返回SUCCESS响应（否则微信会重复通知）。

​​支付通知验证示例（Python）​​：

python
运行
复制
import hashlib
import xml.etree.ElementTree as ET

def verify_signature(notify_data, api_key):
    # 解析XML数据
    root = ET.fromstring(notify_data)
    nonce_str = root.find('nonce_str').text
    sign = root.find('sign').text
    
    # 拼接签名参数（排除sign字段）
    params = {}
    for child in root:
        if child.tag != 'sign':
            params[child.tag] = child.text
    
    # 按字典序排序参数，拼接成字符串
    sorted_params = sorted(params.items())
    stringA = '&'.join([f"{k}={v}" for k, v in sorted_params])
    stringSignTemp = f"{stringA}&key={api_key}"
    
    # 计算MD5签名并转大写
    my_sign = hashlib.md5(stringSignTemp.encode()).hexdigest().upper()
    return my_sign == sign

3. 安全防护

• ​​防重放攻击​​：记录已处理的transaction_id或out_trade_no，避免重复处理；
• ​​数据加密​​：敏感信息（如用户手机号、地址）需加密存储；
• ​​接口限流​​：防止恶意请求（如通过Nginx或中间件限制频率）。

​​五、测试与上线​​

1. 沙箱环境测试

微信提供​​沙箱环境​​（支付接口）用于测试，避免影响生产数据。需在商户平台切换至沙箱模式，使用沙箱的APPID、mch_id和API Key调用接口。

2. 上线前检查

• 确认所有接口权限已开通（如商品发布、支付）；
• 测试极端场景（如库存不足、支付失败、退款）；
• 验证日志记录（接口调用日志、错误日志）是否完整；
• 关闭沙箱环境，切换至生产环境配置。

3. 提交审核（可选）

若小店涉及特殊类目（如食品、药品），需提交相关资质至微信审核，审核通过后方可上线。

​​六、官方资源与工具​​

• 微信小商店开放平台文档：接口说明；
• 微信支付商户平台：支付相关配置与对账；
• 开发者社区：问题答疑与经验分享；
• Postman模板：接口调试工具（含示例请求）。

​​总结​​：微信小店开发需结合官方API和业务需求，重点关注​​接口鉴权、支付流程、数据安全​​三大核心。建议先通过沙箱环境验证功能，再逐步上线生产环境。