API字典 / 分賬 / 分賬標(biāo)記API

請求分賬API

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

微信訂單支付成功后，商戶發(fā)起分賬請求，將結(jié)算后的資金分到分賬接收方。

注意：

? 對同一筆訂單最多能發(fā)起50次分賬請求，每次請求最多分給50個接收方；

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

? 此接口支持商戶對同一筆訂單發(fā)起多次分賬，請仔細閱讀請求參數(shù)中的unfreeze_unsplit字段描述，執(zhí)行相應(yīng)操作（可參考文檔后補充的調(diào)用樣例）；

? 通過本接口解凍給出資方執(zhí)行出境的金額，將和非分賬訂單金額一起參與軋差結(jié)算，與商戶的結(jié)算合同中的結(jié)算周期、起結(jié)點等提現(xiàn)規(guī)則保持一致；

? 出資方指和微信支付發(fā)生實際結(jié)算、資金入賬的商戶；在境外機構(gòu)商模式下為機構(gòu)商戶、在服務(wù)商模式下為二級商戶。

? 商戶上送敏感信息時使用微信支付平臺公鑰加密，證書序列號包含在請求HTTP頭部的Wechatpay-Serial，詳見接口規(guī)則

1. 接口說明

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

請求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/orders

請求方式：post

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

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

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

2. 請求參數(shù)

參數(shù)名

變量

類型[長度限制]

必填

描述

二級商戶號

sub_mchid

string[1, 32]

否

Body微信支付分配的商戶號，請與微信支付訂單的二級商戶號保持一致。（直連商戶不需要，服務(wù)商/機構(gòu)模式下必填）
示例值：1900000109

公眾賬號ID

appid

string[1, 32]

否

Body微信分配的商戶公眾賬號ID，分賬接收方類型包含PERSONAL_OPENID時必填。
示例值：wx8888888888888888

二級商戶公眾賬號ID

sub_appid

string[1, 32]

否

Body微信分配的二級商戶公眾賬號ID，分賬接收方類型包含PERSONAL_SUB_OPENID時必填。
示例值：wx8888888888888889

微信支付訂單號

transaction_id

string[1, 32]

是

Body微信支付訂單號
示例值：4208450740201411110007820472

商戶分賬單號

out_order_no

string[1，64]

是

Body商戶系統(tǒng)內(nèi)部的分賬單號，在商戶系統(tǒng)內(nèi)部唯一。只能是數(shù)字、大小寫字母_-。
注：該單號用于標(biāo)識商戶側(cè)發(fā)起的不同分賬指令請求（包括請求分賬API/解凍剩余資金API）。
若需要對同一筆微信支付訂單進行多次資金分發(fā)處理，請注意更換【商戶分賬單號】后再發(fā)起調(diào)用，否則會被微信支付服務(wù)視為同一請求重入。
示例值：P20150806125346

分賬接收方列表

receivers

array[1，50]

否

Body分賬接收方列表，若unfreeze_unsplit=false，則可以設(shè)置出資商戶作為分賬接受方，否則會拒絕分賬請求。最多可有50個分賬接收方。

參數(shù)名	變量	類型[長度限制]	必填	描述
分賬幣種	currency	string[3, 3]	是	分賬幣種，符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼，目前只支持人民幣，"CNY"。示例值：CNY
分賬接收方類型	type	string[1, 32]	是	分賬接收方類型。 MERCHANT_ID：商戶號， PERSONAL_OPENID：個人OpenID，由商戶APPID轉(zhuǎn)換得到 PERSONAL_SUB_OPENID：是個人Sub_OpenID，由二級商戶APPID轉(zhuǎn)換得到示例值：MERCHANT_ID
分賬接收方賬號	account	string[1, 64]	是	1、類型是MERCHANT_ID時，是商戶號 2、類型是PERSONAL_OPENID時，是個人OpenID 3、類型是PERSONAL_SUB_OPENID時，是是個人Sub_OpenID。注意：當(dāng)前不支持添加個人用戶為接收方示例值：86693852
分賬個人接收方姓名	name	string[1, 1024]	否	可選項，在接收方類型為個人的時可選填。若有值，會檢查 name 是否與微信用戶實名相匹配，不匹配會拒絕分賬請求分賬接收方類型是PERSONAL_OPENID或PERSONAL_SUB_OPENID時，是個人姓名的密文（選傳，傳則校驗），此字段需要加密，加密方法詳見文檔開頭的：敏感信息加密說明示例值：hu89ohu89ohu89o
是否已經(jīng)獲取用戶實名信息授權(quán)	authorized	boolean	否	商戶向微信支付傳輸用戶姓名及賬戶信息，微信支付后臺將協(xié)助校驗用戶信息一致性，降低分賬接收方填寫錯誤的風(fēng)險。該字段為商戶確認(rèn)傳輸?shù)挠脩粜畔⒌氖跈?quán)狀態(tài)： 1）false代表未獲取用戶授權(quán)，微信支付將拒絕接收數(shù)據(jù) 2）true代表已獲取用戶授權(quán)，微信支付將正常接收數(shù)據(jù) 注意，在分賬個人接收方姓名字段(即name字段)被設(shè)置時，該字段為必填項示例值：true
分賬金額	amount	int	是	分賬金額，單位為分；只能為整數(shù)，不能超過原訂單支付金額；且在分給其他接收方的場景，還會校驗分出金額是否超過最大分賬比例金額。示例值：888
分賬描述	description	string[1, 80]	是	分賬的原因描述，分賬賬單中需要體現(xiàn) 示例值：分給商戶A

收起

是否解凍剩余未分賬資金

unfreeze_unsplit

boolean

是

Body1、如果為true，該筆訂單剩余未分賬的金額會解凍回分賬出資方商戶，并發(fā)起購匯出境；
2、如果為false，該筆訂單剩余未分賬的金額不會解凍回分賬出資方商戶，可以對該筆訂單再次進行分賬。
示例值：true

請求示例

場景一場景二

商戶只需調(diào)用一次請求分賬接口，即可完成對微信支付訂單資金的分發(fā)
一筆支付訂單金額10元，結(jié)算扣除手續(xù)費后剩余待分賬金額為9.95元，此時商戶可通過【分賬請求API】發(fā)起分賬請求
a. 指定分給合作商戶(2480248971)0.99元
b. 分給合作用戶(of8YZ9LPmjDmYAddobIvtTdQQjR8)0.99元
c. 同時通過設(shè)置unfreeze_unsplit為true，將剩余金額解凍給出資方執(zhí)行購匯出境。來完成對本次訂單的資金分發(fā)。

場景一：JSON 場景二：JSON


{
    "appid": "wx7bc98d929da735fe",
    "out_order_no": "MCH13SFDG234155321146",
    "receivers": [
      {
        "account": "2480248971",
        "amount": 99,
        "currency": "CNY",
        "description": "分給xxx商戶-10%",
        "type": "MERCHANT_ID"
      },
      {
        "account": "of8YZ6LPmjDmYAqdobIvwTdQQjR8",
        "amount": 99,
        "currency": "CNY",
        "description": "分給xxx用戶-10%",
        "type": "PERSONAL_OPENID"
      }
    ],
    "sub_mchid": "999968479",
    "transaction_id": "4200000012202203235765130087",
    "unfreeze_unsplit": true
  }


{
    "appid": "wx7bc98d929da735fe",
    "out_order_no": "MCH1349FG041421146",
    "receivers": [
      {
        "account": "2480248971",
        "amount": 1000,
        "currency": "CNY",
        "description": "子單一：分給xxx商戶",
        "type": "MERCHANT_ID"
      },
      {
        "account": "of8YZ6LPmjDmYAqdobIvwTdQQjR8",
        "amount": 1000,
        "currency": "CNY",
        "description": "子單一：分給xxx用戶",
        "type": "PERSONAL_OPENID"
      },
      {
        "account": "999952224", # 注：這里填出資方商戶號
        "amount": 8000,
        "currency": "CNY",
        "description": "子單一：解凍出境",
        "type": "MERCHANT_ID"
      }
    ],
    "sub_mchid": "999968479",
    "transaction_id": "4200000028202203236604547485",
    "unfreeze_unsplit": false
  }

3. 返回參數(shù)

參數(shù)名

變量

類型[長度限制]

必填

描述

二級商戶號

sub_mchid

string[1, 32]

否

微信支付分配的商戶號
示例值：1900000109

微信支付訂單號

transaction_id

string[1, 32]

是

微信支付訂單號
示例值：4208450740201411110007820472

商戶分賬單號

out_order_no

string[1, 64]

是

商戶分賬單號，同請求入?yún)ⅰ?br/> 示例值：P20150806125346

微信分賬單號

order_id

string[1, 64]

是

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

分賬單狀態(tài)

state

string

是

分賬單狀態(tài)（每個接收方的分賬結(jié)果請查看receivers中的result字段）。
PROCESSING：處理中，
FINISHED：分賬完成，
示例值：FINISHED

分賬接收方列表

receivers

array[1,50]

是

分賬接收方列表
商戶在發(fā)起分賬請求或解凍剩余資金請求時，對同一筆訂單可分給多個接收方（包括解凍給出資方），分賬明細描述了每筆分給一個接收方的資金的狀態(tài)。

參數(shù)名	變量	類型[長度限制]	必填	描述
分賬幣種	currency	string[3, 3]	是	分賬幣種，同請求入?yún)ⅰ?br/> 示例值：CNY
分賬金額	amount	int	是	分賬金額，同請求入?yún)ⅰ?br/> 示例值：100
分賬描述	description	string[1, 80]	是	商戶傳入的分賬描述，同請求入?yún)ⅰ?br/> 示例值：分給商戶1900000110
接收方類型	type	string[1, 32]	是	接收方類型，同請求入?yún)ⅰ? MERCHANT_ID：商戶號， PERSONAL_OPENID：個人OpenID，由商戶APPID轉(zhuǎn)換得到 PERSONAL_SUB_OPENID：是個人Sub_OpenID，由二級商戶APPID轉(zhuǎn)換得到示例值：MERCHANT_ID
接收方賬號	account	string[1, 64]	是	接收方賬號，同請求入?yún)ⅰ?br/> 示例值：1900000109
分賬明細結(jié)果	result	string[1, 32]	是	每一筆分賬明細轉(zhuǎn)賬的結(jié)果。 PENDING：待分賬， SUCCESS：分賬成功， CLOSED：已關(guān)閉，示例值：SUCCESS
分賬明細失敗原因	fail_reason	string[1, 64]	否	分賬明細失敗原因。在分賬明細結(jié)果為"CLOSED"時才會被設(shè)置。 NO_RELATION：分賬關(guān)系已解除， SUB_MERCHANT_FRONEN：二級商戶被凍結(jié)， MCH_CONTRACT_SETTLE_OFF：商戶結(jié)算合同為關(guān)閉結(jié)算狀態(tài)， MCH_CONTRACT_FROZEN：商戶結(jié)算合同被凍結(jié)， ACCOUNT_ABNORMAL：分賬接收賬戶異常， RECEIVER_HIGH_RISK：高風(fēng)險接收方， RECEIVER_REAL_NAME_NOT_VERIFIED：接收方未實名， NO_AUTH：分賬權(quán)限已解除， DEFAULT_ERROR：默認(rèn)錯誤，示例值：ACCOUNT_ABNORMAL
分賬明細創(chuàng)建時間	create_time	string[1, 64]	是	分賬明細創(chuàng)建時間，遵循RFC3339標(biāo)準(zhǔn)格式示例值：2015-05-20T13:29:35.120+08:00
分賬明細完成時間	finish_time	string[1, 64]	否	分賬明細完成時間，遵循RFC3339標(biāo)準(zhǔn)格式。在分賬明細結(jié)果為"SUCCESS"或"CLOSED"時才會被設(shè)置。示例值：2015-05-20T13:29:35.120+08:00
分賬明細單號	detail_id	string[1, 64]	是	微信分賬明細單號，每筆分賬業(yè)務(wù)執(zhí)行的明細單號。示例值：36011111111111111111111
分賬明細類型	detail_type	string[1, 32]	是	分賬明細分為兩類，包括分出給其他接收方和解凍給出資方。可由該字段來區(qū)分，若明細類型為UNFREEZE_TO_SPONSOR(解凍給出資方)時，分賬明細中還會返回出資方結(jié)算幣種、結(jié)算金額、匯率值等信息。 DISTRIBUTE_TO_OTHERS：分出給其他接收方， UNFREEZE_TO_SPONSOR：解凍給出資方出境，示例值：DISTRIBUTE_TO_OTHERS
出資方結(jié)算幣種	settlement_currency	string[3, 3]	否	出資方的結(jié)算幣種，明細類型為UNFREEZE_TO_SPONSOR(解凍給出資方)時該字段才會被設(shè)置。示例值：HKD
出資方結(jié)算金額	settlement_amount	int	否	該筆明細通過換匯后最終結(jié)算給出資方的金額，采用最小幣種單位。示例值：110
匯率值	rate	int	否	分賬幣種與結(jié)算幣種的兌換比例乘以10的8次方即為此值。若分賬幣種與結(jié)算幣種均為人民幣，則兌換比值為1，匯率值為100,000,000; 若結(jié)算幣種為美元，假設(shè)美元兌換人民幣的比例為6.5，則匯率值為650,000,000。示例值：81000000

收起

返回示例

場景一返回結(jié)果場景二返回結(jié)果


{
    "order_id": "7100000751202203238026613597498",
    "out_order_no": "MCH13SFDG234155321146",
    "receivers": [
      {
        "account": "999952224",  # 注：該賬戶為出資方商戶號
        "amount": 797,
        "create_time": "2022-03-23T17:10:13+08:00",
        "currency": "CNY",
        "description": "Unfreeze the remaining funds to sponsor",
        "detail_id": "7200000751202203238026613597602",
        "detail_type": "UNFREEZE_TO_SPONSOR",
        "rate_value": 83640300,
        "result": "PENDING",
        "settlement_amount": 952,
        "settlement_currency": "HKD",
        "type": "MERCHANT_ID"
      },
      {
        "account": "of8YZ6LPmjDmYAqdobIvwTdQQjR8",
        "amount": 99,
        "create_time": "2022-03-23T17:10:13+08:00",
        "currency": "CNY",
        "description": "分給xxx用戶-10%",
        "detail_id": "7200000751202203238026613597699",
        "detail_type": "DISTRIBUTE_TO_OTHERS",
        "result": "PENDING",
        "type": "PERSONAL_OPENID"
      },
      {
        "account": "2480248971",
        "amount": 99,
        "create_time": "2022-03-23T17:10:13+08:00",
        "currency": "CNY",
        "description": "分給xxx商戶-10%",
        "detail_id": "7200000751202203238026613597767",
        "detail_type": "DISTRIBUTE_TO_OTHERS",
        "result": "PENDING",
        "type": "MERCHANT_ID"
      }
    ],
    "state": "PROCESSING",
    "sub_mchid": "999968479",
    "transaction_id": "4200000012202203235765130087"
  }


{
    "order_id": "7100000749202203238028118660977",
    "out_order_no": "MCH1349FG041421146",
    "receivers": [
      {
        "account": "999952224",
        "amount": 8000,
        "create_time": "2022-03-23T17:35:18+08:00",
        "currency": "CNY",
        "description": "子單一：解凍出境",
        "detail_id": "7200000749202203238028118661068",
        "detail_type": "UNFREEZE_TO_SPONSOR",
        "rate_value": 83640300,
        "result": "PENDING",
        "settlement_amount": 9564,
        "settlement_currency": "HKD",
        "type": "MERCHANT_ID"
      },
      {
        "account": "of8YZ6LPmjDmYAqdobIvwTdQQjR8",
        "amount": 1000,
        "create_time": "2022-03-23T17:35:18+08:00",
        "currency": "CNY",
        "description": "子單一：分給xxx用戶",
        "detail_id": "7200000749202203238028118661146",
        "detail_type": "DISTRIBUTE_TO_OTHERS",
        "result": "PENDING",
        "type": "PERSONAL_OPENID"
      },
      {
        "account": "2480248971",
        "amount": 1000,
        "create_time": "2022-03-23T17:35:18+08:00",
        "currency": "CNY",
        "description": "子單一：分給xxx商戶",
        "detail_id": "7200000749202203238028118661205",
        "detail_type": "DISTRIBUTE_TO_OTHERS",
        "result": "PENDING",
        "type": "MERCHANT_ID"
      }
    ],
    "state": "PROCESSING",
    "sub_mchid": "999968479",
    "transaction_id": "4200000028202203236604547485"
  }

4. 錯誤碼

狀態(tài)碼	錯誤碼	描述	解決方案
400	INVALID_REQUEST	用戶類型為PERSONAL_OPENID，參數(shù)appid未設(shè)置	用戶類型為PERSONAL_OPENID，請設(shè)置appid字段
400	INVALID_REQUEST	用戶類型為PERSONAL_SUB_OPENID，參數(shù)sub_appid未設(shè)置	用戶類型為PERSONAL_SUB_OPENID，請設(shè)置sub_appid字段
400	INVALID_REQUEST	用戶OpenID和傳入的AppID不匹配	請校驗OpenID是在哪個商戶的授權(quán)場景下所獲取，并參照API文檔中的分賬接收方類型字段說明，設(shè)置相應(yīng)AppID字段
400	INVALID_REQUEST	請求分賬時，分賬接收方列表中有重復(fù)賬戶	請檢查分賬接收方列表，去除同一次分賬請求中的重復(fù)賬戶后再執(zhí)行請求
400	INVALID_REQUEST	個人接收方選擇傳入姓名字段但未確認(rèn)用戶授權(quán)狀態(tài)	若選擇傳入個人接收方姓名以執(zhí)行用戶實名信息一致性校驗，需要商戶先獲取用戶授權(quán)，并設(shè)置authorized字段為true
400	INVALID_REQUEST	請求分賬時，個人接收方在微信側(cè)的實名信息與傳入的姓名字段值不一致	請和接收方用戶確認(rèn)實名信息無誤后，再執(zhí)行請求
400	INVALID_REQUEST	目前分賬幣種只支持CNY	請檢查分賬接收方列表，將分賬幣種調(diào)整為CNY之后再執(zhí)行請求
400	INVALID_REQUEST	該訂單已經(jīng)超過最大可分賬時間期限	請重新檢查訂單支付時間，超過最大可分賬時間期限的訂單不允許再發(fā)起分賬（已經(jīng)由系統(tǒng)發(fā)起解凍購匯出境）
400	INVALID_REQUEST	該訂單不支持分賬	請檢查微信支付訂單號是否填錯，并確認(rèn)在調(diào)用下單API之前執(zhí)行調(diào)用分賬標(biāo)記API成功
400	INVALID_REQUEST	請求的商戶信息與原支付訂單商戶信息不一致	請仔細檢查訂單號是否填錯、二級子商戶是否未填或填錯
400	INVALID_REQUEST	若選擇解凍剩余未分金額(即在分賬請求中設(shè)置unfreeze_unsplit為true)，不能添加出資方為接收方	若選擇解凍剩余金額(即在分賬請求中設(shè)置unfreeze_unsplit為true)，請移除分賬接收方列表中的出資方賬戶后再執(zhí)行請求
400	INVALID_REQUEST	若選擇部分解凍時，解凍資金對應(yīng)的賬戶填寫錯誤（應(yīng)設(shè)置為實際出資方）	請將出資方設(shè)置為真正出賬的微信賬戶，機構(gòu)商請?zhí)顚憴C構(gòu)商戶號，服務(wù)商請?zhí)顚懽由虘籼?/td>
400	INVALID_REQUEST	請求分賬時校驗到分賬接收關(guān)系不存在，請檢查所有接收方是否已添加	請檢查所有接收方是否已添加
400	INVALID_REQUEST	請求分賬時校驗到分賬接收關(guān)系未生效或已解除，請檢查所有接收方狀態(tài)是否為生效中	請檢查所有接收方狀態(tài)是否為生效中
403	USER_ERROR	接收方列表中存在某接收方用戶未實名認(rèn)證，其微信零錢賬戶無法接受入金請求	請檢查分賬接收方列表，確認(rèn)接收方用戶均已通過微信實名認(rèn)證后再發(fā)起請求
403	USER_ERROR	接收方列表中存在某接收方用戶賬戶被限制收款，其零錢賬戶累計收款額度+本次收款金額已超過限制	若出現(xiàn)用戶入賬限額場景，被限額的用戶會收到微信推送消息，請引導(dǎo)接收方用戶根據(jù)指引完成升級后再發(fā)起分賬
403	USER_ERROR	接收方列表中存在某接收方用戶賬戶命中微信側(cè)風(fēng)險攔截策略，其零錢賬戶被限制收款	被平臺側(cè)提示風(fēng)險攔截的用戶，被全場景限制收款，請?zhí)蕹鄳?yīng)風(fēng)險接收方后再發(fā)起分賬請求
403	NO_AUTH	商戶未簽約境外分賬產(chǎn)品能力	請參考產(chǎn)品流程和接入準(zhǔn)備，確認(rèn)商戶具有分賬權(quán)限后再發(fā)起請求
403	NO_AUTH	商戶已開通分賬產(chǎn)品能力，等待生效中(一般為第二天才生效)	開通分賬產(chǎn)品能力當(dāng)天不能發(fā)起分賬，請等待第二天后發(fā)起請求
403	NO_AUTH	分賬接收方境外權(quán)限被處罰	請確認(rèn)分賬接收方均合法合規(guī)后，請發(fā)起分賬請求
403	NO_AUTH	商戶父子關(guān)系不存在，請使用正確的二級商戶號發(fā)起請求	請檢查二級商戶號(sub_mchid)是否填寫正確
400	INVALID_REQUEST	商戶請求分賬時指令(out_order_no)已存在，且接收方與現(xiàn)有分賬指令不一致	若為同一分賬請求，請校驗接收方信息是否一致；若為不同分賬請求，請更換外部指令單號(out_order_no)再發(fā)起分賬請求
400	INVALID_REQUEST	商戶請求分賬時指令(out_order_no)已存在，且分賬金額與現(xiàn)有指令不一致	若為同一分賬請求，請校驗接收方列表中的分賬金額是否一致；若為不同分賬請求，請更換外部指令單號(out_order_no)再發(fā)起分賬請求
400	INVALID_REQUEST	商戶請求分賬時指令(out_order_no)已存在，但轉(zhuǎn)賬明細數(shù)量不一致	若為同一分賬請求，請校驗接收方列表是否一致；若為不同分賬請求，請更換外部指令單號(out_order_no)再發(fā)起分賬請求
400	INVALID_REQUEST	商戶解凍剩余資金時指令(out_order_no)已存在，且明細內(nèi)容不符合預(yù)期	若為不同分賬請求，請更換外部指令單號(out_order_no)再發(fā)起分賬請求
400	INVALID_REQUEST	請求分賬解凍出境時外幣結(jié)算金額不能為0	請適當(dāng)調(diào)整對應(yīng)的解凍人民幣金額，使得兌換成外幣后的外幣金額大于0
400	INVALID_REQUEST	請求分賬時分出金額超過最大比例	請調(diào)整分出金額至分出比例上限以內(nèi)后再發(fā)起分賬請求
400	INVALID_REQUEST	該訂單已經(jīng)超過最大分賬次數(shù)限制，不能再發(fā)起分賬	請直接調(diào)用【解凍剩余金額API】執(zhí)行解凍
403	NOT_ENOUGH	請求分賬時校驗到可分金額不足	可通過【查詢剩余待分金額API】來獲取訂單當(dāng)前的可分金額
500	SYSYTEM_ERROR	商戶發(fā)起分賬請求指定的微信支付訂單資金凍結(jié)流程還未完成，請稍后重試	用戶支付完成后即會觸發(fā)對該筆分賬支付單的資金凍結(jié)流程，建議商戶可在3~5min后重試

頁面導(dǎo)航

語言

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付產(chǎn)品

資金類產(chǎn)品

其他產(chǎn)品

請求分賬API

1. 接口說明

2. 請求參數(shù)

請求示例

3. 返回參數(shù)

返回示例

4. 錯誤碼