撤销认证 - 星惠付开放平台

功能说明

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

前置条件：该商户在该机构该渠道存在认证申请记录，且申请单状态为 REJECTED（审核驳回）；先通过认证结果查询确认状态；
机构差异：目前仅易宝支付支持撤销；易生支付、付临门返回 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)	支付机构编码，见支付机构列表

响应参数

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

示例

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

{
  "merchant_code": "801292371559190",
  "institution_code": "YEEPAY"
}

响应

{
  "cep_order_no": "20261018085608000001",
  "apply_status": "CANCELED",
  "channel_code": "WECHAT",
  "cancel_status": "CANCELED",
  "sub_merchant_code": "1900000101"
}

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

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

失败示例（机构不支持）

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

撤销仅作废本次认证申请单，不会改变已生效的微信/支付宝授权状态；授权状态的关闭/注销请以认证结果查询的 auth_status 为准。

​功能说明

​请求参数

​响应参数

​示例

功能说明

请求参数

响应参数

示例