# 变更 Ethoca 申请状态

> 撤回 Ethoca 申请、申请关闭服务，或重新提交开通失败的申请。

```yaml
openapi: 3.1.0
info:
  title: 变更 Ethoca 申请状态
  version: 1.0.0
  description: 撤回 Ethoca 申请、申请关闭服务，或重新提交开通失败的申请。
paths:
  /ethoca/agency-cw/enrollment/transition:
    post:
      summary: 变更 Ethoca 申请状态
      description: 撤回 Ethoca 申请、申请关闭服务，或重新提交开通失败的申请。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantNo:
                  type: string
                  description: Onerway 分配的商户号；用于限定要变更的申请所属商户账户。
                id:
                  type: string
                  description: 申请单号，用于指定要变更状态的 Ethoca 服务申请记录。
                billDesc:
                  type: string
                  description: 商户账单描述，将显示在持卡人银行账单上；重新提交或补充申请信息时可提供。
                resellerSubMerchantId:
                  type: string
                  description: 代理运营商的子商户标识。
                  x-onerway-condition:
                    - 代理运营商变更其子商户申请状态时提供。
                enrollmentStatus:
                  type: string
                  description: 指定要流转到的下一个申请状态；如果不填写，系统将根据 `enrollmentEvent` 自动处理状态流转。
                  enum:
                    - PENDING_SUBMISSION
                    - SUBMITTED_AND_PENDING_ENROLLMENT
                    - ENROLLING
                    - ENROLLED
                    - ENROLLMENT_FAILED
                    - SUBMITTED_AND_PENDING_DISENROLLMENT
                    - DISENROLLING
                    - DISENROLLED
                  x-enum-descriptions:
                    PENDING_SUBMISSION: 待提交：申请已创建，尚未提交审核。
                    SUBMITTED_AND_PENDING_ENROLLMENT: 已提交，等待开通：申请已提交，正在排队等待审核与开通处理。
                    ENROLLING: 开通中：审核通过，正在执行预警服务开通配置。
                    ENROLLED: 已开通：服务已生效，商户开始接收预警。
                    ENROLLMENT_FAILED: 开通失败：审核未通过或开通受阻，申请未能完成开通；重新提交前应查看审核意见。
                    SUBMITTED_AND_PENDING_DISENROLLMENT: 已提交，等待关闭服务：停用请求已提交，正在等待处理。
                    DISENROLLING: 关闭中：正在执行服务停用。
                    DISENROLLED: 已关闭：服务已停用，不再接收预警。
                  x-onerway-constraints:
                    - kind: rule
                      text: 不同当前状态下可执行的状态变更由系统控制。
                enrollmentEvent:
                  type: string
                  description: 申请状态变更事件，用于表达本次变更动作。
                  enum:
                    - MERCHANT_WITHDRAW
                    - MERCHANT_RESUBMIT
                  x-enum-descriptions:
                    MERCHANT_WITHDRAW: 商户撤回或停用：待审核状态下撤回尚未开通的申请；已开通状态下申请关闭、停用 Ethoca 服务。
                    MERCHANT_RESUBMIT: 商户重新提交：开通失败或被拒后，参考 `comments` 修正问题后重新发起申请。
                notes:
                  type: string
                  description: 状态变更说明，用于填写撤回原因、重新提交说明或补充材料说明。
                sign:
                  type: string
                  description: 请求签名字符串；生成方式详见[请求签名](/zh/payments/get-started/request-signing)。
              required:
                - merchantNo
                - id
                - enrollmentEvent
                - sign
            examples:
              update-ethoca-enrollment-status:
                summary: 变更 Ethoca 申请状态
                value:
                  billDesc: EXAMPLE STORE US
                  enrollmentEvent: MERCHANT_RESUBMIT
                  id: replace_with_enrollment_id
                  merchantNo: replace_with_merchant_no
                  notes: Updated billing descriptor
                  sign: "{{SIGN}}"
      responses:
        "200":
          description: Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  respCode:
                    type: string
                    description: 响应码；`20000`
                      表示请求处理成功，其余为错误码。完整码表见[响应码](/zh/payments/api-reference/response-codes)。
                  respMsg:
                    type: string
                    description: 响应码对应的可读说明。
                  data:
                    type: object
                    properties:
                      success:
                        type: boolean
                        description: 本次状态变更请求是否被系统受理并执行；`true` 表示变更动作已生效，但不等同于服务最终开通 /
                          关闭结果，最新申请状态仍需通过[查询 Ethoca
                          申请状态接口](/zh/payments/api-reference/endpoints/query-ethoca-enrollments)或
                          [Ethoca
                          报备状态通知](/zh/payments/api-reference/webhooks/ethoca-enrollment-changed)确认。
                      sign:
                        type: string
                        description: 响应签名字符串，可用于校验响应数据完整性。
                    description: 业务数据对象，包含本次状态变更是否被系统受理 / 处理成功。
```