微信支付-分賬

返回上一層文檔首頁 / 解凍剩余資金API

解凍剩余資金API

最新更新時(shí)間：2022.02.14 版本說明

不需要進(jìn)行分賬的訂單，可直接調(diào)用本接口將訂單的金額全部解凍給本商戶

注意：

? 調(diào)用分賬接口后，需要解凍剩余資金時(shí)，調(diào)用本接口將剩余的分賬金額全部解凍給本商戶

? 此接口采用異步處理模式，即在接收到商戶請(qǐng)求后，優(yōu)先受理請(qǐng)求再異步處理，最終的分賬結(jié)果可以通過查詢分賬接口獲取

接口說明

適用對(duì)象：直連商戶

請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/profitsharing/orders/unfreeze

請(qǐng)求方式：POST

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

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

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

請(qǐng)求參數(shù)

參數(shù)名	變量	類型[長度限制]	必填	描述
微信訂單號(hào)	transaction_id	string[1, 32]	是	body微信支付訂單號(hào) 示例值：4208450740201411110007820472
商戶分賬單號(hào)	out_order_no	string[1,64]	是	body商戶系統(tǒng)內(nèi)部的分賬單號(hào)，在商戶系統(tǒng)內(nèi)部唯一，同一分賬單號(hào)多次請(qǐng)求等同一次。只能是數(shù)字、大小寫字母_-\|*@ 示例值：P20150806125346
分賬描述	description	string[1, 80]	是	body分賬的原因描述，分賬賬單中需要體現(xiàn) 示例值：解凍全部剩余資金

請(qǐng)求示例

JSON


{
  "transaction_id": "4208450740201411110007820472",
  "out_order_no": "P20150806125346",
  "description": "解凍全部剩余資金"
}


｛
JAVA示例代碼
｝

返回參數(shù)

參數(shù)名

變量

類型[長度限制]

必填

描述

微信訂單號(hào)

transaction_id

string[1, 32]

是

微信支付訂單號(hào)
示例值：4208450740201411110007820472

商戶分賬單號(hào)

out_order_no

string[1, 64]

是

商戶系統(tǒng)內(nèi)部的分賬單號(hào)，在商戶系統(tǒng)內(nèi)部唯一，同一分賬單號(hào)多次請(qǐng)求等同一次。只能是數(shù)字、大小寫字母_-|*@
示例值：P20150806125346

微信分賬單號(hào)

order_id

string[1, 64]

是

微信分賬單號(hào)，微信支付系統(tǒng)返回的唯一標(biāo)識(shí)
示例值：3008450740201411110007820472

分賬單狀態(tài)

state

string[1, 32]

是

分賬單狀態(tài)（每個(gè)接收方的分賬結(jié)果請(qǐng)查看receivers中的result字段），枚舉值：
1、PROCESSING：處理中
2、FINISHED：分賬完成
示例值：FINISHED

+分賬接收方列表

receivers

array

否

分賬接收方列表

參數(shù)名	變量	類型[長度限制]	必填	描述
分賬金額	amount	int	是	分賬金額，單位為分，只能為整數(shù)，不能超過原訂單支付金額及最大分賬比例金額示例值：100
分賬描述	description	string[1, 80]	是	分賬的原因描述，分賬賬單中需要體現(xiàn) 示例值：分給商戶1900000110
分賬接收方類型	type	string[1, 32]	是	1、MERCHANT_ID：商戶號(hào) 2、PERSONAL_OPENID：個(gè)人openid（由父商戶APPID轉(zhuǎn)換得到）示例值：MERCHANT_ID
分賬接收方賬號(hào)	account	string[1, 64]	是	1、分賬接收方類型為MERCHANT_ID時(shí)，分賬接收方賬號(hào)為商戶號(hào) 2、分賬接收方類型為PERSONAL_OPENID時(shí)，分賬接收方賬號(hào)為個(gè)人openid 示例值：1900000109
分賬結(jié)果	result	string[1, 32]	是	枚舉值： 1、PENDING：待分賬 2、SUCCESS：分賬成功 3、CLOSED：已關(guān)閉示例值：SUCCESS
分賬失敗原因	fail_reason	string[1, 64]	是	分賬失敗原因，當(dāng)分賬結(jié)果result為CLOSED（已關(guān)閉）時(shí)，返回該字段枚舉值： 1、ACCOUNT_ABNORMAL : 分賬接收賬戶異常 2、NO_RELATION : 分賬關(guān)系已解除 3、RECEIVER_HIGH_RISK : 高風(fēng)險(xiǎn)接收方 4、RECEIVER_REAL_NAME_NOT_VERIFIED : 接收方未實(shí)名 5、NO_AUTH : 分賬權(quán)限已解除 6、RECEIVER_RECEIPT_LIMIT : 接收方已達(dá)收款限額示例值：ACCOUNT_ABNORMAL
分賬創(chuàng)建時(shí)間	create_time	string[1, 64]	是	分賬創(chuàng)建時(shí)間，遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時(shí)分秒，TIMEZONE表示時(shí)區(qū)（+08:00表示東八區(qū)時(shí)間，領(lǐng)先UTC 8小時(shí)，即北京時(shí)間）。例如：2015-05-20T13:29:35+08:00表示，北京時(shí)間2015年5月20日 13點(diǎn)29分35秒。示例值：2015-05-20T13:29:35+08:00
分賬完成時(shí)間	finish_time	string[1, 64]	是	分賬完成時(shí)間，遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時(shí)分秒，TIMEZONE表示時(shí)區(qū)（+08:00表示東八區(qū)時(shí)間，領(lǐng)先UTC 8小時(shí)，即北京時(shí)間）。例如：2015-05-20T13:29:35+08:00表示，北京時(shí)間2015年5月20日 13點(diǎn)29分35秒。示例值：2015-05-20T13:29:35+08:00
分賬明細(xì)單號(hào)	detail_id	string[1,64]	是	微信分賬明細(xì)單號(hào)，每筆分賬業(yè)務(wù)執(zhí)行的明細(xì)單號(hào)，可與資金賬單對(duì)賬使用示例值：36011111111111111111111

返回示例

正常示例


{
  "transaction_id": "4208450740201411110007820472",
  "out_order_no": "P20150806125346",
  "order_id": "3008450740201411110007820472",
  "state": "FINISHED",
  "receivers": [
    {
      "amount": 100,
      "description": "分給商戶1900000110",
      "type": "MERCHANT_ID",
      "account": "1900000109",
      "detail_id": "36011111111111111111111",
      "result": "SUCCESS",
      "fail_reason": "ACCOUNT_ABNORMAL",
      "create_time": "2015-05-20T13:29:35+08:00",
      "finish_time": "2015-05-20T13:29:35+08:00"
    }
  ]
}


http://2323weixin.qq.com

錯(cuò)誤碼公共錯(cuò)誤碼

狀態(tài)碼	錯(cuò)誤碼	描述	解決方案
500	SYSTEM_ERROR	系統(tǒng)錯(cuò)誤	系統(tǒng)異常，請(qǐng)使用相同參數(shù)稍后重新調(diào)用
400	PARAM_ERROR	訂單號(hào)格式不正確	請(qǐng)使用正確的參數(shù)重新調(diào)用
400	INVALID_REQUEST	非分賬訂單不支持完結(jié)分賬	請(qǐng)根據(jù)返回的錯(cuò)誤信息確認(rèn)違反的業(yè)務(wù)規(guī)則
429	RATELIMIT_EXCEED	對(duì)同筆訂單分賬頻率過高	請(qǐng)降低頻率后重試
403	NOT_ENOUGH	分賬金額為0	分賬已完成，無需再請(qǐng)求解凍剩余資金
403	NO_AUTH	商戶無權(quán)限	請(qǐng)開通商戶號(hào)分賬權(quán)限

技術(shù)咨詢

文檔反饋

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

微信支付商戶平臺(tái)