可應用于定期扣款或需事后扣款以期提高效率的場景。例如：水電煤繳費、話費、充電寶租借等場景。
注意： ? 扣費請求按簽約協(xié)議中記錄的優(yōu)先支付方式扣費，扣費失敗后則依次輪詢用戶的其它支付方式
? 扣款接口同步返回扣款結(jié)果，有以下三種情況：
1. 如果扣款成功，則返回訂單詳情。
2. 扣款失敗，根據(jù)錯誤碼和對應的建議處理方式處理。
3. 扣款接口超時，超時后可通過調(diào)用查單接口獲取訂單狀態(tài)，也可等待回調(diào)通知來更新商戶側(cè)訂單狀態(tài)，但回調(diào)次數(shù)有限制，不保證商戶最終能收到通知。
適用對象： 直連模式 機構(gòu)模式
請求URL：https://apihk.mch.weixin.qq.com/v3/global/papay/transactions
請求方式：POST
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 應用ID | appid | string[1,32] | 是 | Body直連模式必填，商戶號綁定的appid 注意：僅適用于直連模式 示例值：wxcbda96de0b165486 |
| 子商戶號 | sub_mchid | string[1,32] | 是 | Body服務商模式必填，微信支付分配的子商戶號 注意：僅適用于機構(gòu)模式 示例值：10000097 |
| 服務商應用ID | sp_appid | string[1,32] | 是 | Body服務商模式必填，服務商綁定的appid 注意：僅適用于機構(gòu)模式 示例值：wxcbda96de0b165486 |
| 子商戶應用ID | sub_appid | string[1,32] | 否 | Body發(fā)起簽約的子商戶號綁定的appid 示例值：wxcbda96de0b165484 |
| 商品描述 | description | string[1,128] | 是 | Body商品或支付單簡要描述，格式要求：門店品牌名-城市分店名-實際商品名稱 示例值：image形象店-深圳騰大- QQ公仔 |
| 商戶數(shù)據(jù) | attach | string[1,127] | 否 | Body附加數(shù)據(jù)，在查詢API和支付通知中原樣返回，該字段主要用于商戶攜帶訂單的自定義數(shù)據(jù) 示例值：自定義數(shù)據(jù) |
| 通知地址 | notify_url | string[1,256] | 是 | Body異步接收微信支付結(jié)果通知的回調(diào)地址，通知url必須為外網(wǎng)可訪問的url，不能攜帶參數(shù)。請使用https協(xié)議鏈接 示例值：https://www.weixin.qq.com/wxpay/pay.php |
| 商戶訂單號 | out_trade_no | string[1,32] | 是 | Body商戶系統(tǒng)內(nèi)部的訂單號 示例值：1217752501201407033233368018 |
| 商品標記 | goods_tag | string[1,32] | 否 | Body商品標記，代金券或立減優(yōu)惠功能的參數(shù) 示例值：實例值 |
| MCC碼 | merchant_category_code | string[1,16] | 是 | Body商戶行業(yè)編碼，可參見商戶行業(yè)編碼表 示例值：1011 |
| 委托代扣協(xié)議id | contract_id | string[1,64] | 是 | Body簽約成功后，微信返回的委托代扣協(xié)議id 示例值：Wx15463511252015071056489715 |
| 訂單金額 | amount | object | 是 | Body訂單金額信息 |
| 場景信息 | scene_info | object | 否 | Body場景信息對象 |
POST
https://apihk.mch.weixin.qq.com/v3/global/papay/transactions
{
"appid": "wxcbda96de0b165486",
"description": "PAPAuto-debit支付測試",
"attach": "支付測試",
"notify_url": "https://wxpay.wxutil.com/pub_v2/pay/notify.v2.php",
"out_trade_no": "1217752501201407033233368018",
"goods_tag": "WXG",
"merchant_category_code": "1011",
"contract_id": "Wx15463511252015071056489715",
"amount": {
"total": 10000,
"currency": "HKD"
},
"scene_info": {
"device_ip": "59.37.125.32",
"device_id": "013467007045764"
}
}
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商戶號 | mchid | string[1,32] | 是 | 微信支付分配的商戶號 注意：僅適用于直連模式 示例值：10000091 |
| 應用ID | appid | string[1,32] | 是 | 商戶號綁定的appid 注意：僅適用于直連模式 示例值：wxcbda96de0b165486 |
| 服務商商戶號 | sp_mchid | string[1,32] | 是 | 微信支付分配的機構(gòu)商戶號 注意：僅適用于機構(gòu)模式 示例值：10000098 |
| 子商戶號 | sub_mchid | string[1,32] | 是 | 微信支付分配的子商戶號 注意：僅適用于機構(gòu)模式 示例值：10000097 |
| 服務商應用ID | sp_appid | string[1,32] | 是 | 服務商綁定的appid 注意：僅適用于機構(gòu)模式 示例值：wxcbda96de0b165486 |
| 子商戶應用ID | sub_appid | string[1,32] | 否 | 發(fā)起簽約的子商戶號綁定的appid 注意：僅適用于機構(gòu)模式 示例值：wxcbda96de0b165484 |
| 商戶訂單號 | out_trade_no | string[1,32] | 是 | 返回的商戶訂單號 示例值：1217752501201407033233368018 |
| 微信支付訂單號 | transaction_id | string[1,32] | 是 | 微信支付訂單號 示例值：1217752501201407033233368018 |
| 商戶數(shù)據(jù) | attach | string[1,127] | 否 | 附加數(shù)據(jù)，在查詢API和支付通知中原樣返回，該字段主要用于商戶攜帶訂單的自定義數(shù)據(jù) 示例值：自定義數(shù)據(jù) |
| 交易類型 | trade_type | string[1,16] | 是 | 代扣支付 示例值：AUTH |
| 付款銀行 | bank_type | string[1,32] | 否 | 銀行類型 示例值：WPHK：香港錢包支付 |
| 支付完成時間 | success_time | string[1,64] | 否 | 支付完成時間，格式為rfc3339格式，如2018-06-08T10:34:56+08:00 代表北京時間2018年06月08日10時34分56秒 示例值：2018-06-08T10:34:56+08:00 |
| 交易狀態(tài) | trade_state | string[1,16] | 是 | 枚舉值： SUCCESS：支付成功 REFUND：轉(zhuǎn)入退款 NOTPAY：未支付 CLOSED：已關(guān)閉 PAYERROR：支付失敗 USERPAYING：用戶支付中 示例值：SUCCESS |
| 交易狀態(tài)描述 | trade_state_desc | string[1,256] | 是 | 對當前訂單狀態(tài)的描述和下一步操作的指引 示例值：支付失敗，請重新下單支付 |
| MCC碼 | merchant_category_code | string[1,16] | 是 | 商戶行業(yè)編碼 示例值：1011 |
| 支付者 | payer | object | 否 | Body成功時才返回。支付者信息，詳細說明見下文 |
| 訂單金額 | amount | object | 是 | Body成功時才返回。訂單金額信息，詳細說明見下文 |
| 優(yōu)惠功能 | promotion_detail | array | 否 | Body成功時才返回。優(yōu)惠功能信息，詳細說明見下文 |
{
"amount": {
"currency": "HKD",
"payer_currency": "CNY",
"payer_total": 8,
"total": 10
},
"appid": "wx7bc98d929da735fe",
"attach": "testruoyu",
"bank_type": "CFT",
"mchid": "132012662",
"merchant_category_code": "0",
"out_trade_no": "autotest_20210608201410_9263565",
"payer": {
"openid": "of8YZ6A_ySrPYzjX7joXo_h2CI44"
},
"promotion_detail": [{
"promotion_id": "109519",
"name": "單品惠-6",
"scope": "SINGLE",
"type": "COUPON",
"amount": 5,
"currency": "HKD",
"activity_id": "931386",
"wxpay_contribute_amount": 100,
"merchant_contribute_amount": 100,
"other_contribute_amount": 5,
"goods_detail": {
"goods_id": "124512",
"goods_remark": "1001",
"discount_amount": 100,
"quantity": 1,
"price": 528800
}
}]
"success_time": "2021-12-09T10:56:27+08:00",
"trade_state": "SUCCESS",
"trade_state_desc": "支付成功",
"trade_type": "AUTH",
"transaction_id": "4200001136202112092809736426"
}
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 參數(shù)錯誤 | 請檢查參數(shù)格式是否符合協(xié)議規(guī)范 |
| 400 | INVALID_REQUEST | 參數(shù)不符合業(yè)務規(guī)則 | 重入請求時請保持參數(shù)前后一致 |
| 404 | NO_AUTH | 簽約協(xié)議不存在 | 請檢查簽約協(xié)議號是否正確,是否已解約 |
| 404 | USER_NOT_EXIST | 用戶賬戶注銷 | 請確認扣款用戶的微信賬號是否注銷 |
| 400 | ORDER_PAID | 訂單已支付 | 請確認該訂單號是否重復支付，如果是新單，請使用新訂單號提交 |
| 400 | ORDER_CLOSED | 訂單已關(guān)閉 | 商戶訂單號異常或者支付失敗，請重新下單支付 |
| 400 | ALREADY_EXISTS | 訂單已存在 | 商戶訂單號對應的訂單已存在，請查單確認訂單狀態(tài) |
| 500 | BANK_ERROR | 支付銀行卡所在行渠道維護中 | 用戶銀行卡錯誤，建議換單重試 |
| 403 | CONTRACT_ERROR | 協(xié)議已過期 | 請檢查簽約協(xié)議號是否已過期 |
| 403 | USER_ERROR | 該筆交易存在風險 | 請聯(lián)系用戶，明確微信號是否有違規(guī)操作，如有疑問可聯(lián)系微信客服接觸風險控制 |
| 403 | RULE_LIMIT | 用戶賬戶支付已達上限 | 商戶側(cè)對用戶發(fā)起驗密支付 |
| 403 | NOT_ENOUGH | 余額不足 | 建議用戶補充資金或商戶發(fā)起墊資支付 |
| 500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 建議發(fā)起查單，獲取此次支付結(jié)果，如需換單重試，請先調(diào)用撤銷訂單接口再換單支付，避免重復支付 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證
