分账回退
此功能需要接收方在商户平台-交易中心-分账-分账接收设置下,开启同意分账回退后,才能使用。分账回退的时限是180天。
请求参数 | 类型 | 描述 |
---|---|---|
security | true | 声明加载商户API证书 |
xml | object | 声明请求的XML 数据结构 |
mch_id | string | 商户号 |
sub_mch_id | string | 子商户号 |
appid | string | 公众账号ID |
sub_appid | string | 子商户公众账号ID |
sign_type | string | 签名类型HMAC-SHA256 枚举值 |
order_id | string | 微信分账单号 |
out_order_no | string | 商户分账单号 |
out_return_no | string | 商户回退单号 |
return_account_type | string | 回退方类型MERCHANT_ID 枚举值 |
return_account | string | 回退方账号 |
return_amount | integer | 回退金额 |
description | string | 回退描述 |
php
$instance->v2->secapi->pay->profitsharingreturn->postAsync([
'security' => true,
'xml' => [
'mch_id' => '1900000100',
'sub_mch_id' => '1900000109',
'appid' => 'wx8888888888888888',
'sub_appid' => 'wx8888888888888888',
'sign_type' => 'HMAC-SHA256',
'order_id' => '3008450740201411110007820472',
'out_order_no' => 'P20150806125346',
'out_return_no' => 'R20190516001',
'return_account_type' => 'MERCHANT_ID',
'return_account' => '86693852',
'return_amount' => '888',
'description' => '用户退款',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));
})
->wait();
php
$instance->chain('v2/secapi/pay/profitsharingreturn')->postAsync([
'security' => true,
'xml' => [
'mch_id' => '1900000100',
'sub_mch_id' => '1900000109',
'appid' => 'wx8888888888888888',
'sub_appid' => 'wx8888888888888888',
'sign_type' => 'HMAC-SHA256',
'order_id' => '3008450740201411110007820472',
'out_order_no' => 'P20150806125346',
'out_return_no' => 'R20190516001',
'return_account_type' => 'MERCHANT_ID',
'return_account' => '86693852',
'return_amount' => '888',
'description' => '用户退款',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));
})
->wait();
php
$instance['v2/secapi/pay/profitsharingreturn']->postAsync([
'security' => true,
'xml' => [
'mch_id' => '1900000100',
'sub_mch_id' => '1900000109',
'appid' => 'wx8888888888888888',
'sub_appid' => 'wx8888888888888888',
'sign_type' => 'HMAC-SHA256',
'order_id' => '3008450740201411110007820472',
'out_order_no' => 'P20150806125346',
'out_return_no' => 'R20190516001',
'return_account_type' => 'MERCHANT_ID',
'return_account' => '86693852',
'return_amount' => '888',
'description' => '用户退款',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));
})
->wait();
php
$response = $instance->v2->secapi->pay->profitsharingreturn->post([
'security' => true,
'xml' => [
'mch_id' => '1900000100',
'sub_mch_id' => '1900000109',
'appid' => 'wx8888888888888888',
'sub_appid' => 'wx8888888888888888',
'sign_type' => 'HMAC-SHA256',
'order_id' => '3008450740201411110007820472',
'out_order_no' => 'P20150806125346',
'out_return_no' => 'R20190516001',
'return_account_type' => 'MERCHANT_ID',
'return_account' => '86693852',
'return_amount' => '888',
'description' => '用户退款',
],
]);
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));
php
$response = $instance->chain('v2/secapi/pay/profitsharingreturn')->post([
'security' => true,
'xml' => [
'mch_id' => '1900000100',
'sub_mch_id' => '1900000109',
'appid' => 'wx8888888888888888',
'sub_appid' => 'wx8888888888888888',
'sign_type' => 'HMAC-SHA256',
'order_id' => '3008450740201411110007820472',
'out_order_no' => 'P20150806125346',
'out_return_no' => 'R20190516001',
'return_account_type' => 'MERCHANT_ID',
'return_account' => '86693852',
'return_amount' => '888',
'description' => '用户退款',
],
]);
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));
php
$response = $instance['v2/secapi/pay/profitsharingreturn']->post([
'security' => true,
'xml' => [
'mch_id' => '1900000100',
'sub_mch_id' => '1900000109',
'appid' => 'wx8888888888888888',
'sub_appid' => 'wx8888888888888888',
'sign_type' => 'HMAC-SHA256',
'order_id' => '3008450740201411110007820472',
'out_order_no' => 'P20150806125346',
'out_return_no' => 'R20190516001',
'return_account_type' => 'MERCHANT_ID',
'return_account' => '86693852',
'return_amount' => '888',
'description' => '用户退款',
],
]);
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));
返回字典 | 类型 | 描述 |
---|---|---|
return_code | string | 返回状态码SUCCESS | FAIL 枚举值之一 |
return_msg | string | 返回信息 |
appid | string | 公众账号ID |
mch_id | string | 商户号 |
nonce_str | string | 随机字符串 |
sign | string | 签名 |
result_code | string | 业务结果SUCCESS | FAIL 枚举值之一 |
err_code | string | 错误代码 |
err_code_des | string | 错误代码描述 |
sub_mch_id | string | 子商户号 |
sub_appid | string | 子商户公众账号ID |
sign_type | string | 签名类型HMAC-SHA256 枚举值 |
order_id | string | 微信分账单号 |
out_order_no | string | 商户分账单号 |
out_return_no | string | 商户回退单号 |
return_no | string | 微信回退单号 |
return_account_type | string | 回退方类型MERCHANT_ID 枚举值 |
return_account | string | 回退方账号 |
return_amount | integer | 回退金额 |
description | string | 回退描述 |
result | string | 回退结果SUCCESS | PROCESSING | FAILED 枚举值之一 |
fail_reason | string | 失败原因ACCOUNT_ABNORMAL | TIME_OUT_CLOSED | PAYER_ACCOUNT_ABNORMAL | INVALID_REQUEST 枚举值之一 |
finish_time | string | 完成时间 |