微信支付境外文檔-委托代扣

返回上一層委托代扣 / 支付扣款A(yù)PI

支付扣款A(yù)PI

最新更新時間：2021.08.15 版本說明

可應(yīng)用于定期扣款或需事后扣款以期提高效率的場景。例如：水電煤繳費(fèi)、話費(fèi)、充電寶租借等場景。

注意：

? 扣費(fèi)請求按簽約協(xié)議中記錄的優(yōu)先支付方式扣費(fèi)，扣費(fèi)失敗后則依次輪詢用戶的其它支付方式

? 扣款接口同步返回扣款結(jié)果，有以下三種情況：
    1. 如果扣款成功，則返回訂單詳情。
    2. 扣款失敗，根據(jù)錯誤碼和對應(yīng)的建議處理方式處理。
    3. 扣款接口超時，超時后可通過調(diào)用查單接口獲取訂單狀態(tài)，也可等待回調(diào)通知來更新商戶側(cè)訂單狀態(tài)，但回調(diào)次數(shù)有限制，不保證商戶最終能收到通知。

接口說明

適用對象：直連模式機(jī)構(gòu)模式

接口URL：https://apihk.mch.weixin.qq.com/v3/global/papay/transactions

請求方式：POST

接口規(guī)則：https://wechatpay-api.gitbook.io/wechatpay-api-v3/

path 指該參數(shù)為路徑參數(shù)

query 指該參數(shù)為URL參數(shù)

body 指該參數(shù)需在請求JSON傳參

請求參數(shù)

參數(shù)名

變量

類型[長度限制]

必填

描述

應(yīng)用ID

appid

string[1,32]

是

body直連模式必填，商戶號綁定的appid
注意：僅適用于直連模式
示例值：wxcbda96de0b165486

子商戶號

sub_mchid

string[1,32]

是

body服務(wù)商模式必填，微信支付分配的子商戶號
注意：僅適用于機(jī)構(gòu)模式
示例值：10000097

服務(wù)商應(yīng)用ID

sp_appid

string[1,32]

是

body服務(wù)商模式必填，服務(wù)商綁定的appid
注意：僅適用于機(jī)構(gòu)模式
示例值：wxcbda96de0b165486

子商戶應(yīng)用ID

sub_appid

string[1,32]

否

body發(fā)起簽約的子商戶號綁定的appid
示例值：wxcbda96de0b165484

商品描述

description

string[1,128]

是

body商品或支付單簡要描述，格式要求：門店品牌名-城市分店名-實(shí)際商品名稱
示例值：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

商品標(biāo)記

goods_tag

string[1,32]

否

body商品標(biāo)記，代金券或立減優(yōu)惠功能的參數(shù)
示例值：實(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訂單金額信息

參數(shù)名	變量	類型[長度限制]	必填	描述
總金額	total	int	是	訂單總金額，幣種的最小單位，只能為整數(shù)，詳見交易金額示例值：888
貨幣類型	currency	string[1,16]	是	符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼示例值：CNY

+場景信息

scene_info

object

否

body場景信息對象

參數(shù)名	變量	類型[長度限制]	必填	描述
商戶端設(shè)備	device_id	string[1,32]	否	終端設(shè)備號(商戶自定義，如門店編號) 示例值：013467007045764
商戶端設(shè)備IP	device_ip	string[1,40]	否	商戶側(cè)設(shè)備IP，取公網(wǎng)出口IP，支持IPV6 示例值：128.0.0.1

請求示例


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"
	}
}


POST
https://apihk.mch.weixin.qq.com/v3/global/papay/transactions
{
	"sp_appid": "wxcbda96de0b165486",
	"sub_mchid": "10000097",
	"sub_appid": "wxcbda96de0b165484",
	"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ù)

參數(shù)名

變量

類型[長度限制]

必填

描述

商戶號

mchid

string[1,32]

是

微信支付分配的商戶號
注意：僅適用于直連模式
示例值：10000091

應(yīng)用ID

appid

string[1,32]

是

商戶號綁定的appid
注意：僅適用于直連模式
示例值：wxcbda96de0b165486

服務(wù)商商戶號

sp_mchid

string[1,32]

是

微信支付分配的機(jī)構(gòu)商戶號
注意：僅適用于機(jī)構(gòu)模式
示例值：10000098

子商戶號

sub_mchid

string[1,32]

是

微信支付分配的子商戶號
注意：僅適用于機(jī)構(gòu)模式
示例值：10000097

服務(wù)商應(yīng)用ID

sp_appid

string[1,32]

是

服務(wù)商綁定的appid
注意：僅適用于機(jī)構(gòu)模式
示例值：wxcbda96de0b165486

子商戶應(yīng)用ID

sub_appid

string[1,32]

否

發(fā)起簽約的子商戶號綁定的appid
注意：僅適用于機(jī)構(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]

是

對當(dāng)前訂單狀態(tài)的描述和下一步操作的指引
示例值：支付失敗，請重新下單支付

MCC碼

merchant_category_code

string[1,16]

是

商戶行業(yè)編碼
示例值：1011

+支付者

payer

object

否

成功時才返回。支付者信息，詳細(xì)說明見下文

參數(shù)名	變量	類型[長度限制]	必填	描述
用戶標(biāo)識（直連商戶）	openid	string[1,128]	是	用戶在商戶appid下的openid 注意：僅適用于直連模式示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6a
用戶標(biāo)識（服務(wù)商）	sp_openid	string[1,128]	是	用戶在商戶sp_appid對應(yīng)下的唯一標(biāo)識，需要傳sp_appid才有返回注意：僅適用于機(jī)構(gòu)模式示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
用戶標(biāo)識（特約商戶）	sub_openid	string[1,128]	否	用戶在收單行sub_appid下用戶唯一標(biāo)識，需要傳sub_appid才有返回注意：僅適用于機(jī)構(gòu)模式示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

+訂單金額

amount

object

否

成功時才返回。訂單金額信息，詳細(xì)說明見下文

參數(shù)名

變量

類型[長度限制]

必填

描述

訂單金額

total

int

是

訂單總金額，幣種的最小單位，只能為整數(shù)，詳見交易金額
示例值：888

用戶支付金額

payer_total

int

是

用戶實(shí)際支付金額，幣種的最小單位，只能為整數(shù)，詳見交易金額
示例值：888

訂單標(biāo)價幣種

currency

string[1,16]

是

符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼
示例值：CNY

用戶支付幣種

payer_currency

string[1,16]

否

符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼
示例值：HKD

+匯率信息

exchange_rate

object

否

匯率信息

參數(shù)名	變量	類型[長度限制]	必填	描述
匯率類型	type	string[1,32]	否	枚舉值： SETTLEMENT_RATE：標(biāo)價幣種和結(jié)算幣種的匯率類型 USERPAYMENT_RATE：標(biāo)價幣種和支付幣種的匯率類型示例值：SETTLEMENT_RATE
匯率值	rate	int	否	rate值是兌換比例乘以10的8次方。如果標(biāo)價幣種和結(jié)算幣種一致，兌換比例是1，則rate=100000000；如果標(biāo)價幣種和結(jié)算幣種不一致，例如美元兌換人民幣的比例為6.5，則rate=650000000 示例值：80000000

+優(yōu)惠功能

promotion_detail

array

否

成功時才返回。優(yōu)惠功能信息，詳細(xì)說明見下文

參數(shù)名

變量

類型[長度限制]

必填

描述

券ID

promotion_id

string[1,32]

是

券或者立減優(yōu)惠id
示例值：109519

優(yōu)惠名稱

name

string[1,64]

否

優(yōu)惠名稱
示例值：單品惠-6

優(yōu)惠范圍

scope

string[1,32]

否

GLOBAL：全場代金券
SINGLE：單品優(yōu)惠
示例值：SINGLE

優(yōu)惠類型

type

string[1,16]

否

COUPON：代金券，需要走結(jié)算資金的充值型代金券,（境外商戶券幣種與支付幣種一致）
DISCOUNT：優(yōu)惠券，不走結(jié)算資金的免充值型優(yōu)惠券，（境外商戶券幣種與標(biāo)價幣種一致
示例值：COUPON

優(yōu)惠券面額

amount

int

是

用戶享受優(yōu)惠的金額
示例值：5

優(yōu)惠幣種

currency

string[1,16]

是

符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼
示例值：HKD

活動ID

activity_id

string[1,32]

否

在微信商戶后臺配置的批次ID
示例值：931386

微信出資

wxpay_contribute_amount

int

否

特指由微信支付商戶平臺創(chuàng)建的優(yōu)惠，出資金額等于本項優(yōu)惠總金額
示例值：5

商戶出資

merchant_contribute_amount

int

否

特指商戶自己創(chuàng)建的優(yōu)惠，出資金額等于本項優(yōu)惠總金額
示例值：5

其他出資

other_contribute_amount

int

否

其他出資方出資金額
示例值：5

+單品列表

goods_detail

array

否

單品信息

參數(shù)名	變量	類型[長度限制]	必填	描述
商品編碼	goods_id	string[1,32]	是	由半角的大小寫字母、數(shù)字、中劃線、下劃線中的一種或幾種組成示例值：124512
商品備注	goods_remark	string[1,128]	否	goods_remark為備注字段，按照配置原樣返回，字段內(nèi)容在微信后臺配置券時進(jìn)行設(shè)置示例值：1001
商品優(yōu)惠金額	discount_amount	int	是	單品的總優(yōu)惠金額示例值：100
商品數(shù)量	quantity	int	是	用戶購買的數(shù)量示例值：1
商品價格	price	int	是	單位為：分。如果商戶有優(yōu)惠，需傳輸商戶優(yōu)惠后的單價示例值：528800

返回示例

正常示例


{
	"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"
}


http://2323weixin.qq.com

錯誤碼

狀態(tài)碼	錯誤碼	描述	解決方案
400	PARAM_ERROR	參數(shù)錯誤	請檢查參數(shù)格式是否符合協(xié)議規(guī)范
400	INVALID_REQUEST	參數(shù)不符合業(yè)務(wù)規(guī)則	重入請求時請保持參數(shù)前后一致
404	NO_AUTH	簽約協(xié)議不存在	請檢查簽約協(xié)議號是否正確,是否已解約
404	USER_NOT_EXIST	用戶賬戶注銷	請確認(rèn)扣款用戶的微信賬號是否注銷
400	ORDER_PAID	訂單已支付	請確認(rèn)該訂單號是否重復(fù)支付，如果是新單，請使用新訂單號提交
400	ORDER_CLOSED	訂單已關(guān)閉	商戶訂單號異常或者支付失敗，請重新下單支付
400	ALREADY_EXISTS	訂單已存在	商戶訂單號對應(yīng)的訂單已存在，請查單確認(rèn)訂單狀態(tài)
500	BANK_ERROR	支付銀行卡所在行渠道維護(hù)中	用戶銀行卡錯誤，建議換單重試
403	CONTRACT_ERROR	協(xié)議已過期	請檢查簽約協(xié)議號是否已過期
403	USER_ERROR	該筆交易存在風(fēng)險	請聯(lián)系用戶，明確微信號是否有違規(guī)操作，如有疑問可聯(lián)系微信客服接觸風(fēng)險控制
403	RULE_LIMIT	用戶賬戶支付已達(dá)上限	商戶側(cè)對用戶發(fā)起驗密支付
403	NOT_ENOUGH	余額不足	建議用戶補(bǔ)充資金或商戶發(fā)起墊資支付
500	SYSTEM_ERROR	系統(tǒng)錯誤	建議發(fā)起查單，獲取此次支付結(jié)果，如需換單重試，請先調(diào)用撤銷訂單接口再換單支付，避免重復(fù)支付

视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

委托代扣API

支付扣款A(yù)PI

注意：

接口說明

請求參數(shù)

請求示例

返回參數(shù)

返回示例

錯誤碼

版本說明