01 / CAPABILITIES
开放功能
核心接口调用手册
2 个场景面向中国大陆普通商户,覆盖已有支付订单与退款单的只读查询。每个场景都有 Node.js 22 完整 RSA-SHA256 请求签名、原始响应验签、序列号与时间校验;不发起支付或退款。
多场景商户收款
根据业务场景接入微信内网页 JSAPI、小程序、APP、H5 或 Native 扫码支付,让用户在自己的产品中发起微信支付。
接入要求每种产品有独立准入条件。需合资格商户号、相应产品权限和已绑定的 AppID;例如 JSAPI 要求对应认证公众号及支付授权目录,不能用一种场景配置代替全部场景。
按商户订单号查单并验证响应站内调用手册 · 参数、代码与排错→订单退款与状态处理
对符合条件的已支付订单申请全额或部分原路退款,并结合退款结果通知和查询更新本地订单状态。
接入要求使用原支付订单及唯一商户退款单号,退款总额不能超过原订单;时间、次数和频控按退款接口规则。申请受理成功不等于已退款到账。
查询已有退款单并验证状态站内调用手册 · 参数、代码与排错→交易与资金账单对账
申请交易或资金账单的下载地址,下载文件后与本地订单、退款及资金记录核对,适合财务对账和差异排查。
接入要求账单按日期生成,不能把当日未生成账单当成无交易;下载链接有有效期,下载请求仍需签名,并核验官方返回的文件摘要。
异步结果通知与接口安全
接收支付、退款等异步通知,把支付服务的结果同步到自己的业务后台;验证签名并解密业务通知。
接入要求准备外网可访问的回调地址,按对应场景完成域名配置;使用正确公钥或证书验签、API v3 密钥解密,并实现重复通知处理及业务幂等。
02 / REQUIREMENTS
接入条件
- 适用主体
- 个体工商户开发者、企业商户技术团队、电商与 SaaS 开发者、支付系统集成开发者
- 接入方式
- 使用商户号及商户 API 证书对应私钥构造 API v3 请求签名 / 使用微信支付公钥或适用的平台证书验签,使用 API v3 密钥解密通知 / 调起前端支付时,使用与商户号绑定的 AppID 及对应签名参数
- 申请概况
- 需合资格商户主体;个人收款码不等于商户 API
- 中国大陆普通商户可申请主体包括个体工商户、企业、事业单位、政府机关和社会组织等,需按主体提交营业或登记、负责人身份及结算账户资料,并通过入驻审核和签约。
- 个人微信收款码不是开发者商户 API 凭证;无营业执照个人或小微经营者需核对是否适用特定服务商进件路线,不能默认获得普通商户的全部产品能力。
- 按实际场景申请 JSAPI、Native、APP 或其他支付权限;商户号须与适用 AppID 完成授权绑定,认证要求和应用类型随场景不同。
- 由商户超级管理员或获授权技术负责人准备商户号、AppID、商户私钥与证书序列号、API v3 密钥及微信支付验签材料;私钥和密钥保存在自己的服务端。
- 准备符合对应场景要求的域名、支付页面和回调地址。JSAPI 需配置支付授权目录;使用国内服务器的相关网站应按官方接入指引完成备案。
- 若为其他商户代接入,应走服务商或其他适用合作模式,由目标商户完成必要授权;境外主体应另查对应跨境路线,不能直接套用本文的大陆普通商户条件。
03 / GET STARTED
开通步骤
- 01
确认主体和支付场景
核对商户主体资料、结算账户及业务类目,选择 JSAPI、小程序、APP、H5 或 Native 支付。
- 02
完成商户入驻与授权
通过商户平台提交资料、完成验证与签约,申请所需产品权限,并在相关公众平台或开放平台确认 AppID 绑定。
- 03
配置证书、密钥和回调
由管理员授权技术负责人获取必要参数,配置支付页面及外网回调,完成请求签名、响应验签和通知解密。
- 04
先验证安全与完整流程
先使用官方签名验签测试能力验证安全实现,再依目标产品当前联调指引验证下单、结果通知、退款和对账;记录最终业务结果。
04 / COSTS & LIMITS
费用、边界与测试方式
费用概况收款交易按金额和商户类目费率计费,不能把免费申请理解成免费收款。
- 官方入驻指引说明申请接入不收取申请费用;这不包含其他平台账号认证、自己的部署或外部服务费用。
- 支付服务费以交易金额为基础,按商户经营类目、产品及签约费率结算,不将通用示例费率作为所有商户报价。
- 结算周期、优惠活动、退款时费用处理及分账、转账等独立产品的费用,应以该商户签约和对应产品规则核对;本条目不承诺统一退款退费政策。
使用范围与限制
- 商户入驻成功不代表所有支付产品、分账、商家转账或营销产品自动开通;产品资格和资金权限须逐项确认。
- 服务商、小微商户、普通商户和境外路线的接口、主体与产品权限不同,不能共用一套资格结论。
- 支付页面返回成功、用户截图或退款接口受理成功不能代替服务端业务结果,应结合可信通知、查单与对账确认。
- 退款受到原订单、可退金额、时间和频控等规则限制,失败重试必须保留正确的业务唯一标识。
- 商户私钥、API v3 密钥及证书相关材料不能放到网页前端或公开仓库;接入代码还需处理通知重试、幂等及本地订单一致性。
如何进行开发测试
- 安全联调:官方提供商户签名、验签、加密与解密测试接口,可验证凭证和安全处理;这不是一次真实交易收款结果。
- 业务联调:按目标支付产品当前文档选择验证方式。本次未核实适用于全部 API v3 收款产品的通用免资金沙盒,不沿用旧版沙盒规则。
- 正式环境:商户号、产品权限、AppID 与回调配置生效后,实际下单和退款会关联真实交易与资金,需核对最终业务状态。
接入前再确认
- 本条目聚焦中国大陆普通商户;实际主体资格、签约费率、结算与产品权限需以自己的后台和合同确认。
- 未登录商户平台、生成证书或调用下单、退款、账单接口。安全测试能力不代表交易资金流程已验证。
- 本次未核实适用于全部 API v3 支付产品的通用免资金沙盒,具体联调方式需按目标产品确认。
05 / OFFICIAL SOURCES
官方资料
以下资料用于核对本页内容。申请与使用时,请以对应接口的最新规则为准。
- 01
- 02
- 03
- 04
- 05
- 06
- 07
- 08
- 09
- 10
- 11
商户平台入口官方入口 · 细则待复核 · 2026-10-15
官方文档核对,未进行接口实测
最近核验 2026-10-15 · 查看核验说明