电商与支付 / Weixin Pay Merchant APIs

微信支付

为符合条件的商户提供支付下单、退款、账单和支付结果通知等接口。本文聚焦中国大陆普通商户的 API v3 收款闭环,接入前需完成商户入驻,并按支付场景开通权限与绑定应用。

微信收款小程序支付网站支付订单退款交易对账支付回调
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

开通步骤

  1. 01

    确认主体和支付场景

    核对商户主体资料、结算账户及业务类目,选择 JSAPI、小程序、APP、H5 或 Native 支付。

  2. 02

    完成商户入驻与授权

    通过商户平台提交资料、完成验证与签约,申请所需产品权限,并在相关公众平台或开放平台确认 AppID 绑定。

  3. 03

    配置证书、密钥和回调

    由管理员授权技术负责人获取必要参数,配置支付页面及外网回调,完成请求签名、响应验签和通知解密。

  4. 04

    先验证安全与完整流程

    先使用官方签名验签测试能力验证安全实现,再依目标产品当前联调指引验证下单、结果通知、退款和对账;记录最终业务结果。

04 / COSTS & LIMITS

费用、边界与测试方式

费用概况

收款交易按金额和商户类目费率计费,不能把免费申请理解成免费收款。

  • 官方入驻指引说明申请接入不收取申请费用;这不包含其他平台账号认证、自己的部署或外部服务费用。
  • 支付服务费以交易金额为基础,按商户经营类目、产品及签约费率结算,不将通用示例费率作为所有商户报价。
  • 结算周期、优惠活动、退款时费用处理及分账、转账等独立产品的费用,应以该商户签约和对应产品规则核对;本条目不承诺统一退款退费政策。

使用范围与限制

  • 商户入驻成功不代表所有支付产品、分账、商家转账或营销产品自动开通;产品资格和资金权限须逐项确认。
  • 服务商、小微商户、普通商户和境外路线的接口、主体与产品权限不同,不能共用一套资格结论。
  • 支付页面返回成功、用户截图或退款接口受理成功不能代替服务端业务结果,应结合可信通知、查单与对账确认。
  • 退款受到原订单、可退金额、时间和频控等规则限制,失败重试必须保留正确的业务唯一标识。
  • 商户私钥、API v3 密钥及证书相关材料不能放到网页前端或公开仓库;接入代码还需处理通知重试、幂等及本地订单一致性。

如何进行开发测试

  • 安全联调:官方提供商户签名、验签、加密与解密测试接口,可验证凭证和安全处理;这不是一次真实交易收款结果。
  • 业务联调:按目标支付产品当前文档选择验证方式。本次未核实适用于全部 API v3 收款产品的通用免资金沙盒,不沿用旧版沙盒规则。
  • 正式环境:商户号、产品权限、AppID 与回调配置生效后,实际下单和退款会关联真实交易与资金,需核对最终业务状态。

接入前再确认

  • 本条目聚焦中国大陆普通商户;实际主体资格、签约费率、结算与产品权限需以自己的后台和合同确认。
  • 未登录商户平台、生成证书或调用下单、退款、账单接口。安全测试能力不代表交易资金流程已验证。
  • 本次未核实适用于全部 API v3 支付产品的通用免资金沙盒,具体联调方式需按目标产品确认。
05 / OFFICIAL SOURCES

官方资料

以下资料用于核对本页内容。申请与使用时,请以对应接口的最新规则为准。

  1. 01
    JSAPI 产品介绍与商户产品导航已核对官方资料 · 2026-10-15
  2. 02
  3. 03
    Native 支付开发接入准备已核对官方资料 · 2026-10-15
  4. 04
    JSAPI 支付开发接入准备已核对官方资料 · 2026-10-15
  5. 05
    普通商户模式开发必要参数说明已核对官方资料 · 2026-10-15
  6. 06
    API v3 如何签名和验签已核对官方资料 · 2026-10-15
  7. 07
    订单退款:申请退款已核对官方资料 · 2026-10-15
  8. 08
    下载账单开发指引已核对官方资料 · 2026-10-15
  9. 09
    商户签名验签与加解密测试已核对官方资料 · 2026-10-15
  10. 10
    合作伙伴特约商户进件:提交申请单已核对官方资料 · 2026-10-15
  11. 11
    商户平台入口官方入口 · 细则待复核 · 2026-10-15
官方文档核对,未进行接口实测
最近核验 2026-10-15 · 查看核验说明