微信支付集成
版权声明:本 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 格式规范
- 添加版权声明和客服信息
Scan to contact