文档

# 微信支付

QQ 小程序微信支付功基于微信 H5 支付，QQ小程序后台仅对统一下单和支付回调两种接口进行透明转发。 其它接口（查询订单，关闭订单，申请退款，查询退款等）需开发者直接请求微信支付后台。

# 接入步骤

  1. 在微信支付商户平台开通具备 H5 支付能力的微信支付商户号
  • 开通路径：微信支付商户平台 - 产品中心 - 我的产品 - H5支付
  • 微信支付商户号绑定微信 AppID，绑定路径：微信支付商户平台 – 产品中心 – AppID账号管理
  1. 在QQ小程序管理端开通微信支付能力并绑定微信支付商户号
  • 开通路径：QQ小程序开发者管理端 - 支付接入 - 微信支付
  • 绑定微信支付商户号，设置接收微信支付结果通知的回调地址

  1. 调用 QQ 小程序微信 H5 支付统一下单代理接口获取 H5 支付跳转连接

  2. QQ小程序内使用 qq.requestWxPayment 呼起微信支付

# 允许接入的服务类目

目前微信支付按类目开放给包含以下一个或多个类目的小程序：电商平台、教育、生活服务、工具、旅游、餐饮、商家自营、商业服务、体育、汽车、社交红包。 只有允许开通的类目才可以在开发者管理端看到开通入口。

# 版本选择

微信 H5 支付有 V2 版和 V3 版，两种版本的区别参见微信支付官网。官方文档

# 已支持的 API 列表

# 微信H5支付V2版

# 微信H5支付V3版

# QQ小程序代理微信支付流程

  • 在QQ小程序中使用微信支付，必须经过QQ小程序后台的代理转发，否则即使下单成功也无法在手Q中呼起微信支付。
  • 在QQ小程序中使用微信支付，支付回调必须经过QQ小程序后台代理转发，否则QQ小程序后台拒绝代理下单请求。
  • 在QQ小程序中使用的微信支付商户号必须先在QQ小程序开发者管理端绑定，否则QQ小程序后台拒绝代理下单请求。
    • 直连模式：绑定普通商户号
    • 服务商模式：绑定服务商商户号
    • 合单下单：绑定合单商户号

QQ小程序代理微信支付流程图如下： QQ小程序微信支付代理流程图

# V2 版 H5支付统一下单

# V2版 H5 支付

微信支付原统一下单 API 为：

https://api.mch.weixin.qq.com/pay/unifiedorder

QQ 小程序后台对应的代理下单 API 为：

https://api.q.qq.com/wxpay/unifiedorder?appid=YourQQAppID&access_token=YourAccessToken&&real_notify_url=UrlEncodedNotifyUrl

# V3 版 H5支付下单API

# H5下单API（直连模式）

微信支付原统一下单 API 为：

https://api.mch.weixin.qq.com/v3/pay/transactions/h5

QQ 小程序后台对应的代理下单 API 为：

https://api.q.qq.com/wxpay/v3/pay/transactions/h5?appid=YourQQAppID&access_token=YourAccessToken&&real_notify_url=UrlEncodedNotifyUrl

# H5下单API（服务商模式)

微信支付原统一下单 API 为：

https://api.mch.weixin.qq.com/v3/pay/partner/transactions/h5

QQ 小程序后台对应的代理下单 API 为：

https://api.q.qq.com/wxpay/v3/pay/partner/transactions/h5?appid=YourQQAppID&access_token=YourAccessToken&&real_notify_url=UrlEncodedNotifyUrl

# 合单支付API

微信支付原统一下单 API 为：

https://api.mch.weixin.qq.com/v3/combine-transactions/h5

QQ 小程序后台对应的代理下单 API 为：

https://api.q.qq.com/wxpay/v3/combine-transactions/h5?appid=YourQQAppID&access_token=YourAccessToken&&real_notify_url=UrlEncodedNotifyUrl

# 请求参数填写说明

# 参数类型

  • path 指该参数需在请求URL传参
  • query 指该参数需在请求URL的query传参
  • body 指该参数需在请求Body传参

# 请求参数

参数 是否必须 参数类型 填写说明
appid 是 query 填写 QQ 小程序 appid, 区别于 body 中的 appid，body 中填写的是微信的 APPID
access_token 是 query QQ 小程序后台接口调用凭证，通过getAccessToken 获得
real_notify_url 否 query 填写直接调用微信支付下单接口时的 notify_url 参数，接收微信支付异步通知回调地址，通知url必须为直接可访问的url，不能携带参数。可选参数，若不填写，则取QQ小程序开发者管理端绑定的回调地址。
request body 是 body 和直接请求微信支付后台的统一下单接口一样，但 notify_url 参数必须填写 QQ 小程序平台支付回调代理地址
# notify_url 参数填写说明
API 版本 参数名称 参数类型 值 说明
V2 notify_url body https://api.q.qq.com/wxpay/notify QQ 小程序平台 V2 版 支付回调代理地址
V3 notify_url body https://api.q.qq.com/wxpay/v3/notify/MCH_ID/OUT_TRADE_NO QQ 小程序平台 V3 版 支付回调代理地址, 其中 MCH_ID 和 OUT_TRADE_NO 分别为下单时的商户号和订单号。直连模式填普通商户号和订单号;服务商模式填服务商商户号和订单号；合单下单填合单商户号和订单号。
# 注意事项
  • 微信支付 V3 版 API 的签名信息包含了 URL，这里签名时应使用微信支付原版 URL。不要携带 appid, access_token, real_notify_url 这些参数。
    • 如H5下单API（直连模式) 下，参与签名的 URL 应为 /v3/pay/transactions/h5
  • QQ小程序后台仅对统一下单和支付回调两种接口进行透明转发。建议先直接请求微信支付后台调试接口，待接口调试成功后再转到QQ小程序后台代理接口。

# 错误码

错误码 含义 解决方法
9030 商户号没绑定 去 QQ 小程序开发者管理端绑定使用的商户号
9031 notify_url 设置错误 按照上面 notify_url 参数填写说明检查参数
9032 没有开通微信支付 去 QQ 小程序开发者管理端开通微信支付接入权限
9034 请求 body 解析失败 检查请求 body

# QQ小程序内呼起微信支付

下单成功后开发者会拿到用于呼起微信支付的跳转链接, 在 QQ 小程序中不允许直接呼起微信支付，需通过调用qq.requestWxPayment接口呼起

# 支付体验

  • 扫码体验

QQ小程序微信支付扫码体验

← 内容安全 →