Latest update time:2022.05.18 Release notes
After requesting funds-distribution, call the API to query the funds-distribution result. After requesting to unfreeze the remaining funds, call the API to query the result of unfreezing the remaining funds.
Request Url:https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/orders/{out_order_no}
Request method:GET
API rules: https://wechatpay-api.gitbook.io/wechatpay-api-v3
Applicable object:Common modeInstitutional mode
path parameter is a path parameter.
query parameter needs to be passed in the request URL.
body parameter needs to be passed in the request JSON.
Name | Variable Name | Type | Required | Description |
---|---|---|---|---|
Sub-merchant ID | sub_mchid | string[1, 32] | No | body Sub-merchant ID allocated by Weixin Pay. It needs to be consistent with the sub-merchant ID in the transaction of Weixin Pay. Note: Only forInstitutional mode Example:1900000109 |
Weixin Pay transaction ID | transaction_id | string[1, 32] | Yes | body Weixin Pay transaction ID Example:4208450740201411110007820472 |
Merchant order No. | out_order_no | string[1, 64] | Yes | path The order No. in the merchant system, which is unique. It can only include numbers, capital letters and lowercase letters _-. Note: This order No. is used to identify different requests of funds-distribution commands (including funds-distribution request API/Query funds-distribution result API) initiated from the merchant side. If the funds of one transaction is distributed multiple times, change the [merchant order No.] before requesting funds-distribution. Otherwise it will be considered as a repeated request. Example:P20150806125346 |
https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/orders/P20150806125346?sub_mchid=1900000109&transaction_id=4208450740201411110007820472
Name | Variable Name | Type | Required | Description |
---|---|---|---|---|
Sub-merchant ID | sub_mchid | string[1, 32] | No | Merchant ID allocated by Weixin Pay Example:1900000109 |
Weixin Pay order No. | transaction_id | string[1, 32] | Yes | Weixin Pay transaction ID Example:4208450740201411110007820472 |
Merchant order No. | out_order_no | string[1, 64] | Yes | Merchant order No., same as the request parameter. Example:P20150806125346 |
Weixin order ID | order_id | string[1, 64] | Yes | Weixin order ID, the unique identifier returned by Weixin system. Example:3008450740201411110007820472 |
Funds-distribution order state | state | string | Yes | Funds-distribution order state (see result field in receivers for funds-distribution results of each receiver). PROCESSING: Funds-distribution is processing, FINISHED: Funds-distribution is finished, Example:FINISHED |
+ Receiver list | receivers | array[1,50] | Yes | Receiver list When a merchant initiates a funds-distribution request or a unfreeze the remaining funds request, the same transaction funds can be distributed to multiple receivers (including unfreezing funds to the sponsor). The funds-distribution detail describes each funds-distribution state of each receiver. |
{
"order_id": "7100000751202203238026613597498",
"out_order_no": "MCH13SFDG234155321146",
"receivers": [
{
"account": "999952224", # Note: The account is the sponsor merchant ID
"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": "Distribute to xxx user-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": "Distribute to xxx merchant-10%",
"detail_id": "7200000751202203238026613597767",
"detail_type": "DISTRIBUTE_TO_OTHERS",
"result": "PENDING",
"type": "MERCHANT_ID"
}
],
"state": "PROCESSING",
"sub_mchid": "999968479",
"transaction_id": "4200000012202203235765130087"
}
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP证