> ## Documentation Index
> Fetch the complete documentation index at: https://opendocs.xft.xin/llms.txt
> Use this file to discover all available pages before exploring further.

# 撤销认证

## 功能说明

撤销商户在指定支付机构的微信/支付宝认证申请，将本次申请单作废。

* **前置条件**：该商户在该机构该渠道存在认证申请记录，且申请单状态为 `REJECTED`（审核驳回）；先通过[认证结果查询](https://opendocs.xft.xin/open/payment/auth/apply-query.md)确认状态；
* **机构差异**：目前仅易宝支付支持撤销；易生支付、付临门返回 400 `BUSINESS_ERROR`「支付机构\[机构名称]暂不支持此操作」；
* **状态约束**：申请单非 `REJECTED` 状态时返回 400 `BUSINESS_ERROR`「当前申请单状态为XX，不可撤销」；无认证申请记录时返回「未发起认证申请，无法撤销」；
* 撤销成功后本次申请单不再生效；当前版本不支持撤销后直接重新发起认证申请，如需重新认证请联系平台处理。

**支持商户**：全部已开通进件权限的渠道商（及其旗下品牌），仅可操作本主体录入的商户

**请求方式**：`POST`

**请求路径**：

| 渠道 | 请求路径 |
| - | - |
| 微信 | `POST /openapi/v1/merchant/auth/wechat/cancel` |
| 支付宝 | `POST /openapi/v1/merchant/auth/alipay/cancel` |

## 请求参数

| 字段 | 是否必填 | 字段类型 | 字段说明 |
| - | - | - | - |
| `merchant_code` | 是 | String(≤64) | 平台商户号 |
| `institution_code` | 是 | String(≤64) | 支付机构编码，见[支付机构列表](https://opendocs.xft.xin/open/payment/appendix/institutions.md) |

## 响应参数

| 字段 | 是否必填 | 字段类型 | 字段说明 |
| - | - | - | - |
| `cep_order_no` | 是 | String | 认证申请单号（撤销的申请单） |
| `apply_status` | 是 | String | 撤销后的申请单状态：撤销成功为 `CANCELED` |
| `channel_code` | 是 | String | 认证渠道：`WECHAT` / `ALIPAY` |
| `cancel_status` | 是 | String | 撤销结果：`CANCELED`=已撤销 / `FAILED`=撤销未成功 |
| `sub_merchant_code` | 否 | String | 微信/支付宝子商户号，机构未返回时为空 |

## 示例

**请求（撤销微信认证申请）**

```json theme={"system"}
{
  "merchant_code": "801292371559190",
  "institution_code": "YEEPAY"
}
```

**响应**

```json theme={"system"}
{
  "cep_order_no": "20261018085608000001",
  "apply_status": "CANCELED",
  "channel_code": "WECHAT",
  "cancel_status": "CANCELED",
  "sub_merchant_code": "1900000101"
}
```

**失败示例（状态不可撤销）**

```json theme={"system"}
{
  "code": 400,
  "reason": "BUSINESS_ERROR",
  "message": "当前申请单状态为审核中，不可撤销",
  "metadata": {}
}
```

**失败示例（机构不支持）**

```json theme={"system"}
{
  "code": 400,
  "reason": "BUSINESS_ERROR",
  "message": "支付机构[易生支付]暂不支持此操作",
  "metadata": {}
}
```

> [!NOTE]
>
> 撤销仅作废本次认证申请单，不会改变已生效的微信/支付宝授权状态；授权状态的关闭/注销请以[认证结果查询](https://opendocs.xft.xin/open/payment/auth/apply-query.md)的 `auth_status` 为准。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.