概述
WeChat Pay 直连场景仅支持以下支付: PC 扫码支付、小程序支付和 APP 支付。商户应根据实际支付场景设置 methods 参数,并按场景处理接口返回结果。
如需接入 WeChat Pay 的全部支付场景,请参阅 WeChat Pay 接入文档。
流程图
请求
商户服务器调用直连模式提交必要参数:
- PC 扫码支付
- 小程序
- APP
| 场景 | 说明 | 支付方式 methods传值 |
|---|---|---|
| PC 扫码支付(直连) | 用于 PC 端浏览器打开,商家生成二维码给用户扫码完成支付 | WeChatPay_Web |
cURL -X POST 'https://test-secure.oceanpayment.com/gateway/directservice/pay'
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'account=995149' \
-d 'terminal=99514901' \
-d 'signValue=6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b' \
-d 'backUrl=https://www.abc.com/back.php' \
-d 'noticeUrl=https://www.abc.com/notice.php' \
-d 'order_number=NO12345678' \
-d 'order_currency=HKD' \
-d 'order_amount=0.01' \
-d 'methods=WeChatPay_Web' \
-d 'order_notes=' \
-d 'billing_firstName=test' \
-d 'billing_lastName=test' \
-d 'billing_email=test@gmail.com' \
-d 'billing_phone=13800138000' \
-d 'billing_country=HK' \
-d 'billing_state=HK' \
-d 'billing_city=Washington D.C.' \
-d 'billing_address=705A big Road' \
-d 'billing_zip=529012' \
-d 'billing_ip=127.0.0.1' \
-d 'productNum=1' \
-d 'productName=Red Dress' \
-d 'productSku=#001' \
-d 'productPrice=0.01' \
| 场景 | 说明 | 支付方式 methods传值 |
|---|---|---|
| 小程序 | 用于微信小程序打开,完成支付 | WeChatPay_MPro |
cURL -X POST 'https://test-secure.oceanpayment.com/gateway/directservice/pay'
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'account=995149' \
-d 'terminal=99514901' \
-d 'signValue=6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b' \
-d 'backUrl=https://www.abc.com/back.php' \
-d 'noticeUrl=https://www.abc.com/notice.php' \
-d 'order_number=NO12345678' \
-d 'order_currency=HKD' \
-d 'order_amount=0.01' \
-d 'methods=WeChatPay_Mpro' \
-d 'order_notes=' \
-d 'billing_firstName=test' \
-d 'billing_lastName=test' \
-d 'billing_email=test@gmail.com' \
-d 'billing_phone=13800138000' \
-d 'billing_country=HK' \
-d 'billing_state=HK' \
-d 'billing_city=Washington D.C.' \
-d 'billing_address=705A big Road' \
-d 'billing_zip=529012' \
-d 'billing_ip=127.0.0.1' \
-d 'productNum=1' \
-d 'productName=Red Dress' \
-d 'productSku=#001' \
-d 'productPrice=0.01' \
| 场景 | 说明 | 支付方式 methods传值 |
|---|---|---|
| APP | 用于 APP 内打开,完成支付 | WeChatPay_APP |
cURL -X POST 'https://test-secure.oceanpayment.com/gateway/directservice/pay'
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'account=995149' \
-d 'terminal=99514901' \
-d 'signValue=6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b' \
-d 'backUrl=https://www.abc.com/back.php' \
-d 'noticeUrl=https://www.abc.com/notice.php' \
-d 'order_number=NO12345678' \
-d 'order_currency=HKD' \
-d 'order_amount=0.01' \
-d 'methods=WeChatPay_APP' \
-d 'order_notes=' \
-d 'billing_firstName=test' \
-d 'billing_lastName=test' \
-d 'billing_email=test@gmail.com' \
-d 'billing_phone=13800138000' \
-d 'billing_country=HK' \
-d 'billing_state=HK' \
-d 'billing_city=Washington D.C.' \
-d 'billing_address=705A big Road' \
-d 'billing_zip=529012' \
-d 'billing_ip=127.0.0.1' \
-d 'productNum=1' \
-d 'productName=Red Dress' \
-d 'productSku=#001' \
-d 'productPrice=0.01' \
响应
查看完整的响应参数。
- PC 扫码支付
- 小程序
- APP
<?xml version="1.0" encoding="UTF-8"?>
<response>
<notice_type>transaction</notice_type>
<push_dateTime>2026-11-12 07:25:57</push_dateTime>
<account>995149</account>
<terminal>99514901</terminal>
<signValue>41FE077BA389DB90DEF5EEC70AB2C401D7027D6940F1203700FBAE3CB116BB42</signValue>
<methods>WeChatPay_Web</methods>
<order_number>NO12345678</order_number>
<card_country></card_country>
<order_currency>HKD</order_currency>
<order_amount>0.01</order_amount>
<order_notes></order_notes>
<card_number></card_number>
<card_type></card_type>
<payment_country>HK</payment_country>
<payment_id>231219095247018026021</payment_id>
<payment_authType>0</payment_authType>
<payment_status>-1</payment_status>
<payment_details>80700:Transaction was not finished</payment_details>
<payment_solutions></payment_solutions>
<payment_risk></payment_risk>
<payment_amount></payment_amount>
<payment_exchangeRate></payment_exchangeRate>
<pay_barCode>weixin://wxpay/bizpayurl?pr=158DR2T159DS2F1U</pay_barCode>
<pay_userId></pay_userId>
<payment_transactionNetworkId></payment_transactionNetworkId>
<payment_transactionLinkId></payment_transactionLinkId>
</response>
- 订单状态:当
payment_status= -1 时,表示订单处于待处理状态。商户需获取微信二维码参数pay_barCode,并在付款页面将其生成二维码供用户扫码支付。 - 二维码生成示例
- 使用前端 qrcode 包生成二维码
npm install qrcode
- 请直接将其完整
pay_barCode值传给二维码生成工具。生成后可用微信扫码验证。
import QRCode from 'qrcode';
const payUrl = 'weixin://wxpay/bizpayurl?pr=158DR2T159DS2F1U';
QRCode.toCanvas(document.getElementById('qrcode'), payUrl, (error) => {
if (error) console.error('二维码生成失败', error);
});
- 页面中放置:
<canvas id="qrcode"></canvas>
<?xml version="1.0" encoding="UTF-8"?>
<response>
<notice_type>transaction</notice_type>
<push_dateTime>2026-11-12 16:18:07</push_dateTime>
<response_type>1</response_type>
<account>995149</account>
<terminal>99514901</terminal>
<signValue>37439C92DCB47DE826AE32A7388B038F017D8709DB4D2750658C9AF937F0FFB4</signValue>
<methods>WeChatPay_MPro</methods>
<order_number>NO12345678</order_number>
<card_country></card_country>
<order_currency>HKD</order_currency>
<order_amount>0.01</order_amount>
<order_notes></order_notes>
<card_number></card_number>
<card_type></card_type>
<payment_country>HK</payment_country>
<payment_id>231219095247018026022</payment_id>
<payment_authType>0</payment_authType>
<payment_status>-1</payment_status>
<payment_details>80700:Transaction was not finished</payment_details>
<payment_solutions></payment_solutions>
<payment_risk></payment_risk>
<payment_amount></payment_amount>
<payment_exchangeRate></payment_exchangeRate>
<pay_barCode></pay_barCode>
<pay_userId></pay_userId>
<payment_transactionNetworkId></payment_transactionNetworkId>
<payment_transactionLinkId></payment_transactionLinkId>
<payment_bankInfo>{"timeStamp":"1794367610","package":"prepay_id=wx03975974041111c34277632432","paySign":"5440562B4A1D1B0A0F69DC3321D75","signType":"MD5","nonceStr":"3231317676"}</payment_bankInfo>
</response>
- 订单状态:商户发起支付请求后,订单状态同步返回
payment_status= -1,表示待处理。用户完成支付后,系统将实时返回支付结果。 - 支付参数:
payment_bankInfo中包含调用微信小程序wx.requestPayment所需的参数。小程序端取出这些参数后,可直接传入wx.requestPayment,无需重新计算paySign。具体调用方式请参阅微信支付官方文档。
- 小程序唤起支付示例
// 假设服务端返回 payment_bankInfo
// { payment_bankInfo: "{\"timeStamp\":\"...\",\"package\":\"...\", ...}" }
function invokeWechatPay(paymentBankInfo) {
const params = typeof paymentBankInfo === 'string' ?
JSON.parse(paymentBankInfo) : paymentBankInfo;
wx.requestPayment({
timeStamp: String(params.timeStamp),
nonceStr: params.nonceStr,
package: params.package,
signType: params.signType,
paySign: params.paySign,
success(res) {
console.log('微信支付调用成功', res);
},
fail(err) {
console.error('微信支付调用失败', err);
}
});
}
<?xml version="1.0" encoding="UTF-8"?>
<response>
<notice_type>transaction</notice_type>
<push_dateTime>2026-11-12 16:18:07</push_dateTime>
<response_type>1</response_type>
<account>995149</account>
<terminal>99514901</terminal>
<signValue>37439C92DCB47DE826AE32A7388B038F017D8709DB4D2750658C9AF937F0FFB4</signValue>
<methods>WeChatPay_APP</methods>
<order_number>NO12345678</order_number>
<card_country></card_country>
<order_currency>HKD</order_currency>
<order_amount>0.01</order_amount>
<order_notes></order_notes>
<card_number></card_number>
<card_type></card_type>
<payment_country>HK</payment_country>
<payment_id>231219095247018026022</payment_id>
<payment_authType>0</payment_authType>
<payment_status>-1</payment_status>
<payment_details>80700:Transaction was not finished</payment_details>
<payment_solutions></payment_solutions>
<payment_risk></payment_risk>
<payment_amount></payment_amount>
<payment_exchangeRate></payment_exchangeRate>
<pay_barCode></pay_barCode>
<pay_userId></pay_userId>
<payment_transactionNetworkId></payment_transactionNetworkId>
<payment_transactionLinkId></payment_transactionLinkId>
<payment_bankInfo>MkU4NzQxQjU5NDZDRUVCMjgwQTJDNUU3N0Y3MkY0Njk6NjE0NzAxMjQ3Ond4YzNmOWI3ZWMzOTEy
NDhkNDpTaWduPVdYUGF5OjE3OTQ0Njc1Nzc6RjlDNEU2MzREQ0ZFNjQ4OEU1OTk4QTVDRTVBMEVB
QjQ6d3g3ODc1MDA1MjIxMjExMTI4NDUwMDAwMDU1NTIwMjYzMDAw</payment_bankInfo>
</response>
- 订单状态:商户发起支付请求后,订单状态同步返回
payment_status= -1,表示待处理。用户完成支付后,系统将实时返回支付结果。 - 支付返回
payment_bankInfo是 Base64 编码字符串。商户需先进行 Base64 解码,再按字段顺序组装微信 OpenSDK 的PayReq对象并调用 SDK 唤起微信支付。具体调用方式请参阅微信支付官方文档。
注意
Base64 只是编码,不是加密。请通过 HTTPS 传输参数,并避免将完整的 payment_bankInfo 或解码后的支付参数写入日志。字段顺序应以 Oceanpayment 返回参数定义为准。
- 获取并解码
payment_bankInfo,字段的顺序如下:
nonceStr:partnerId:appId:package:timeStamp:sign:prepayId
- Android 解码并调用 OpenSDK
//java
import android.util.Base64;
import com.tencent.mm.opensdk.modelpay.PayReq;
String encoded = paymentBankInfo; // payment_bankInfo 中的 Base64 字符串
String decoded = new String(
Base64.decode(encoded, Base64.DEFAULT),
java.nio.charset.StandardCharsets.UTF_8
);
String[] fields = decoded.split(":", -1);
if (fields.length != 7) {
throw new IllegalArgumentException("payment_bankInfo 格式不正确");
}
PayReq request = new PayReq();
request.nonceStr = fields[0];
request.partnerId = fields[1];
request.appId = fields[2];
request.packageValue = fields[3];
request.timeStamp = fields[4];
request.sign = fields[5];
request.prepayId = fields[6];
// api 为已初始化并注册商户 AppID 的 IWXAPI 实例
api.sendReq(request);
- iOS 解码并调用 OpenSDK
//objective-c
#import <CommonCrypto/CommonCrypto.h>
#import "WXApi.h"
#import "PayReq.h"
NSData *decodedData = [[NSData alloc]
initWithBase64EncodedString:paymentBankInfo
options:0];
NSString *decoded = [[NSString alloc]
initWithData:decodedData
encoding:NSUTF8StringEncoding];
NSArray<NSString *> *fields = [decoded componentsSeparatedByString:@":"];
if (fields.count != 7) {
// payment_bankInfo 格式不正确
return;
}
PayReq *request = [[PayReq alloc] init];
request.nonceStr = fields[0];
request.partnerId = fields[1];
request.appId = fields[2];
request.package = fields[3];
request.timeStamp = fields[4];
request.sign = fields[5];
request.prepayId = fields[6];
[WXApi sendReq:request];
付款状态
查看详细的付款状态说明。
异步通知
您还需要通过noticeUrl接收交易的异步通知。
签名
查看详细的签名和验签功能。