跳到主要内容

概述​

WeChat Pay 直连场景仅支持以下支付: PC 扫码支付、小程序支付和 APP 支付。商户应根据实际支付场景设置 methods 参数,并按场景处理接口返回结果。

如需接入 WeChat Pay 的全部支付场景,请参阅 WeChat Pay 接入文档。

流程图​

请求​

商户服务器调用直连模式提交必要参数:

场景说明支付方式 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' \

响应​

查看完整的响应参数。

<?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>
  1. 订单状态:当 payment_status = -1 时,表示订单处于待处理状态。商户需获取微信二维码参数 pay_barCode,并在付款页面将其生成二维码供用户扫码支付。
  2. 二维码生成示例
  • 使用前端 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>

付款状态​

查看详细的付款状态说明。

异步通知​

您还需要通过noticeUrl接收交易的异步通知。

签名​

查看详细的签名和验签功能。