Back to skills
extension
Category: OtherAPI key required

微信支付集成

微信支付商户平台接入最佳实践。涵盖JSAPI支付、小程序支付、APP支付、H5支付、Native支付、付款码支付等全场景产品选型与集成指导。

personAuthor: user_8509461ahubcommunity

微信支付集成

版权声明:本 Skill 内容来源于腾讯公司(微信支付)官方文档,版权归属腾讯公司所有。如有疑问可咨询微信支付客服:95017

Source: 微信支付商户文档中心 Copyright: Tencent Inc.


简介

微信支付商户平台接入最佳实践。涵盖 JSAPI支付、小程序支付、APP支付、H5支付、Native支付、付款码支付等全场景产品选型与集成指导。

适用场景:当用户提到"接入微信支付"、"集成微信支付"、"对接微信支付"、"微信收款"、"加个微信支付"、"微信下单"、"小程序支付"、"扫码支付"、"Native支付"、"H5支付"、"APP支付"、"付款码"、"Native支付"、"公众号支付"时使用此 Skill。

不适用场景:不用于支付宝支付、银联支付、微信转账、对账、红包等非收单场景。


支付产品一览

微信支付提供以下支付产品:

| 产品 | 场景 | 文档入口 | |------|------|----------| | JSAPI支付 | 微信客户端内浏览器网页支付 | 商户文档 | | 小程序支付 | 微信小程序内支付 | 商户文档 | | APP支付 | 原生iOS/Android App支付 | 商户文档 | | H5支付 | 手机浏览器H5支付 | 商户文档 | | Native支付 | 商家生成二维码,用户扫码支付 | 商户文档 | | 付款码支付 | 商家扫码用户付款码 | 商户文档 | | 刷脸支付 | 微信刷脸设备支付 | 商户文档 | | 医保支付 | 医保定点医药机构支付 | 商户文档 |


接入路由表

根据用户的业务场景,路由到对应的产品文档:

| 场景 | 推荐产品 | 接入方式 | 文档 | |------|----------|----------|------| | 微信内网页支付 | JSAPI支付 | 公众号/浏览器 | JSAPI文档 | | 微信小程序内支付 | 小程序支付 | 小程序 | 小程序文档 | | 原生App支付(iOS/Android) | APP支付 | App SDK | APP文档 | | 手机浏览器H5支付 | H5支付 | H5页面 | H5文档 | | 商家二维码用户扫码 | Native支付 | 二维码 | Native文档 | | 商家扫码用户付款码 | 付款码支付 | 扫码枪 | 付款码文档 | | 刷脸设备支付 | 刷脸支付 | 刷脸设备 | 刷脸文档 |


快速决策树

用户咨询微信支付接入
        |
        +-- 微信内支付?
        |       +-- 微信小程序内 --> 小程序支付
        |       +-- 微信浏览器内 --> JSAPI支付
        |
        +-- App支付?
        |       +-- 原生iOS/Android App --> APP支付
        |
        +-- H5支付?
        |       +-- 手机浏览器H5 --> H5支付
        |
        +-- 扫码支付?
        |       +-- 商家生成二维码,用户扫 --> Native支付
        |       +-- 商家扫用户付款码 --> 付款码支付
        |
        +-- 特殊场景?
                +-- 刷脸设备 --> 刷脸支付
                +-- 医保定点 --> 医保支付

场景关键词匹配

| 关键词 | 路由产品 | |--------|----------| | 微信支付、接入微信支付、集成微信支付、微信收款 | JSAPI/小程序支付 | | 小程序支付、小程序内支付、微盟小程序、有赞小程序 | 小程序支付 | | APP支付、iOS支付、Android支付、App内支付、原生App | APP支付 | | H5支付、WAP支付、手机网页支付、移动端网页 | H5支付 | | Native支付、二维码支付、扫码支付、商家二维码 | Native支付 | | 付款码、条码支付、扫码枪、被扫、线下门店 | 付款码支付 | | 刷脸支付、人脸支付、蜻蜓设备、青蛙设备 | 刷脸支付 | | 医保支付、医药支付、医保定点、药店支付 | 医保支付 |


核心API

JSAPI/小程序支付流程

// 1. 商户后端调用下单接口
const orderResult = await wechatPay.unifiedOrder({
  appid: 'wx2421b1c4370ec43b',
  mch_id: '1230000109',
  nonce_str: 'e61463f8efa94090b1f366cccfbbb444',
  body: '商品描述',
  out_trade_no: '20150806125346',
  total_fee: 88,
  spbill_create_ip: '123.12.12.123',
  notify_url: 'https://yourserver.com/notify',
  trade_type: 'JSAPI',
  openid: 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o'
});

// 2. 获取prepay_id
const prepay_id = orderResult.prepay_id;

// 3. 前端调起支付
WeixinJSBridge.invoke('getBrandWCPayRequest', {
  "appId": "wx2421b1c4370ec43b",
  "timeStamp": "1395712654",
  "nonceStr": "e61463f8efa94090b1f366cccfbbb444",
  "package": "prepay_id=wx21201855730335ac86f8c43d1889123400",
  "signType": "RSA",
  "paySign": "oR9d8PuhnIc+YZ8cBHFCwfgpaK9gd7vaRvk..."
}, function(res){
  if(res.err_msg == "get_brand_wcpay_request:ok"){
    // 支付成功
  }
});

澄清话术

当用户描述模糊时:

请确认您的业务场景:

1. 微信内支付
   - 微信小程序内支付 → 小程序支付
   - 微信浏览器内网页支付 → JSAPI支付

2. APP支付
   - 原生 iOS/Android App 内支付 → APP支付

3. H5支付
   - 手机浏览器 H5 页面支付 → H5支付

4. 扫码支付
   - 商家生成二维码,用户扫码 → Native支付
   - 商家扫码枪扫用户付款码 → 付款码支付

5. 特殊场景
   - 刷脸设备支付 → 刷脸支付
   - 医保定点机构 → 医保支付

请描述您的具体业务场景?

接入准备

1. 注册商户号

前往 微信支付商户平台 注册商户账号。

2. 获取必要参数

| 参数 | 说明 | 获取方式 | |------|------|----------| | appid | 公众号/小程序/应用ID | 微信开放平台 | | mch_id | 商户号 | 商户平台申请 | | api_key | API密钥 | 商户平台设置 | | apiclient_key | 商户私钥 | 商户平台上传 | | apiclient_cert | 商户证书 | 商户平台下载 |

3. 开发接入

# 微信支付SDK
# Java: https://github.com/WechatPay-Organization/wechatpay-java
# Node.js: https://github.com/WechatPay-Organization/wechatpay-node
# Python: https://github.com/WechatPay-Organization/wechatpay-python

文档资源

| 资源 | 链接 | |------|------| | 商户文档中心 | https://pay.weixin.qq.com | | 产品文档 | https://pay.weixin.qq.com/doc/v3/merchant/4012062524 | | API列表 | https://pay.weixin.qq.com/doc/v3/merchant/4012791857 | | 开发工具 | https://pay.weixin.qq.com/wiki/doc/apiv3/index.shtml | | 开发者社区 | https://developers.weixin.qq.com/community |


注意事项

  • 本 Skill 不支持商家分账/转账到零钱等产品,如需使用请查阅官方文档。
  • 业务咨询和接入问题请查阅 微信支付商户文档中心 或拨打客服热线。
  • 测试阶段建议开发者优先使用沙箱环境。
  • 本文档链接均指向微信支付在线文档,内容会动态更新,编写代码前务必阅读最新版本。

版权声明

本 Skill 的内容来源于 腾讯公司(微信支付) 官方商户文档中心。

  • 版权归属:腾讯公司
  • 客服热线:95017
  • 官方网站:https://www.wechatpay.com
  • 商户平台:https://pay.weixin.qq.com
  • 在线文档:https://pay.weixin.qq.com/doc/v3/merchant/4012062524

本整合版仅作技术学习交流使用,原始内容由微信支付官方维护和更新。如有任何疑问或需要商业支持,请直接联系微信支付官方客服。


更新日志

v1.0.0 (2026-04-04)

  • 整合微信支付商户文档中心内容
  • 适配 SkillHub 格式规范
  • 添加版权声明和客服信息