查询控制单
根据外部单号查询管控单、解管单。管控单:未解管时支持长期查询,解管后支持1年查询。解管单:支持1年查询。限频:200/分钟
| 请求参数 | 类型 | 描述 |
|---|---|---|
| out_request_no | string | 微众管控/解管单号 |
| query | object | 声明请求的查询参数 |
| control_type | string | 控制单类型PUNISH | RECOVER 枚举值之一 |
| mchid | string | 微信支付商户号 |
| headers | object | 声明请求的头参数 |
| Wechatpay-Serial | string | 微信支付公钥ID/平台证书序列号 |
php
$instance->v3->aggracctBc->wbChannel->controlOrders->_out_request_no_->getAsync([
'out_request_no' => 'out_request_no_example',
'query' => [
'control_type' => 'PUNISH',
'mchid' => '1900016681',
],
'headers' => [
'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(json_decode((string) $response->getBody(), true));
})
->wait();php
$instance->chain('v3/aggracct-bc/wb-channel/control-orders/{out_request_no}')->getAsync([
'out_request_no' => 'out_request_no_example',
'query' => [
'control_type' => 'PUNISH',
'mchid' => '1900016681',
],
'headers' => [
'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(json_decode((string) $response->getBody(), true));
})
->wait();php
$instance['v3/aggracct-bc/wb-channel/control-orders/{out_request_no}']->getAsync([
'out_request_no' => 'out_request_no_example',
'query' => [
'control_type' => 'PUNISH',
'mchid' => '1900016681',
],
'headers' => [
'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(json_decode((string) $response->getBody(), true));
})
->wait();php
$response = $instance->v3->aggracctBc->wbChannel->controlOrders->_out_request_no_->get([
'out_request_no' => 'out_request_no_example',
'query' => [
'control_type' => 'PUNISH',
'mchid' => '1900016681',
],
'headers' => [
'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
],
]);
print_r(json_decode((string) $response->getBody(), true));php
$response = $instance->chain('v3/aggracct-bc/wb-channel/control-orders/{out_request_no}')->get([
'out_request_no' => 'out_request_no_example',
'query' => [
'control_type' => 'PUNISH',
'mchid' => '1900016681',
],
'headers' => [
'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
],
]);
print_r(json_decode((string) $response->getBody(), true));php
$response = $instance['v3/aggracct-bc/wb-channel/control-orders/{out_request_no}']->get([
'out_request_no' => 'out_request_no_example',
'query' => [
'control_type' => 'PUNISH',
'mchid' => '1900016681',
],
'headers' => [
'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
],
]);
print_r(json_decode((string) $response->getBody(), true));| 返回字典 | 类型 | 描述 |
|---|---|---|
| control_scene | string | 控制场景PUNISH | RECOVER 枚举值之一 |
| punish_order | object | 管控单 |
| wxpay_punish_no | string | 微信管控单号 |
| out_request_no | string | 微众管控单号 |
| mchid | string | 目标下管商户号 |
| punish_scene | integer | 管控场景 |
| punish_rule_version | integer | 管控场景规则版本号 |
| punish_reason | string | 管控原因 |
| punish_start_time | string | 管控开始时间 |
| punish_end_time | string | 管控结束时间 |
| punish_accept_time | string | 管控受理时间 |
| punish_finish_time | string | 管控执行完成时间 |
| punish_state | string | 管控状态EXECUTING | SUCCESS | FAILED 枚举值之一 |
| effect_state | string | 生效状态ACTIVE | RECOVERED 枚举值之一 |
| control_action | string[] | 管控方案DISABLE_RECEIVE | DISABLE_WITHDRAWAL | DISABLE_PAY | DISABLE_REFUND | DISABLE_CLOSE_MERCHANT 枚举值之一 |
| error_message | string | 执行失败错误信息 |
| error_code | string | 执行失败错误码 |
| recover_order | object | 解管单 |
| wxpay_recover_no | string | 微信支付解管单号 |
| out_request_no | string | 微众解管单号 |
| related_wxpay_punish_no | string | 关联微信支付管控单号 |
| mchid | string | 目标解管商户号 |
| punish_scene | string | 管控场景 |
| punish_rule_version | string | 管控场景规则版本号 |
| recover_accept_time | string | 解管受理时间 |
| recover_finish_time | string | 解管执行完成时间 |
| recover_state | string | 解管状态EXECUTING | SUCCESS | FAILED 枚举值之一 |
| recover_reason | string | 解管原因描述 |
| error_message | string | 执行失败错误信息 |
| error_code | string | 执行失败错误码 |
参阅 官方文档