# Update Ethoca enrollment status

> Withdraw an Ethoca application, request service disablement, or resubmit a failed enrollment.

```yaml
openapi: 3.1.0
info:
  title: Update Ethoca enrollment status
  version: 1.0.0
  description: Withdraw an Ethoca application, request service disablement, or
    resubmit a failed enrollment.
paths:
  /ethoca/agency-cw/enrollment/transition:
    post:
      summary: Update Ethoca enrollment status
      description: Withdraw an Ethoca application, request service disablement, or
        resubmit a failed enrollment.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantNo:
                  type: string
                  description: Merchant number assigned by Onerway. It limits the transition to
                    applications under one merchant account.
                id:
                  type: string
                  description: Enrollment application ID identifying the Ethoca service
                    application to transition.
                billDesc:
                  type: string
                  description: Merchant billing descriptor. Provide it when resubmitting or
                    supplementing application information.
                resellerSubMerchantId:
                  type: string
                  description: Sub-merchant identifier assigned by the agency operator.
                  x-onerway-condition:
                    - Provide this field when an agency operator transitions a
                      sub-merchant application.
                enrollmentStatus:
                  type: string
                  description: Target enrollment status to transition to. If omitted, Onerway
                    processes the transition according to `enrollmentEvent`.
                  enum:
                    - PENDING_SUBMISSION
                    - SUBMITTED_AND_PENDING_ENROLLMENT
                    - ENROLLING
                    - ENROLLED
                    - ENROLLMENT_FAILED
                    - SUBMITTED_AND_PENDING_DISENROLLMENT
                    - DISENROLLING
                    - DISENROLLED
                  x-enum-descriptions:
                    PENDING_SUBMISSION: Pending submission. The application has been created but has
                      not been submitted for review.
                    SUBMITTED_AND_PENDING_ENROLLMENT: Submitted and pending enrollment. The
                      application has been submitted and is waiting for review
                      and enrollment processing.
                    ENROLLING: Enrolling. The application passed review and alert-service enrollment
                      configuration is in progress.
                    ENROLLED: Enrolled. The service is active and the merchant can receive alerts.
                    ENROLLMENT_FAILED: Enrollment failed. Review failed or enrollment was blocked;
                      check comments before resubmitting.
                    SUBMITTED_AND_PENDING_DISENROLLMENT: Submitted and pending disenrollment. A
                      disable-service request has been submitted and is waiting
                      for processing.
                    DISENROLLING: Disenrolling. Service disablement is in progress.
                    DISENROLLED: Disenrolled. The service has been disabled and alerts are no longer
                      received.
                  x-onerway-constraints:
                    - kind: rule
                      text: Available transitions depend on the current enrollment status and are
                        controlled by the system.
                enrollmentEvent:
                  type: string
                  description: Enrollment status transition event, expressing the action requested
                    by this call.
                  enum:
                    - MERCHANT_WITHDRAW
                    - MERCHANT_RESUBMIT
                  x-enum-descriptions:
                    MERCHANT_WITHDRAW: Merchant withdraws or disables the service. Use it to
                      withdraw an application that is pending review, or to
                      request disabling an enrolled Ethoca service.
                    MERCHANT_RESUBMIT: Merchant resubmits the application after enrollment failed or
                      was rejected, usually after correcting issues described in
                      `comments`.
                notes:
                  type: string
                  description: Status transition note for the requested action, including
                    withdrawal reasons, resubmission explanations, or
                    supplementary material descriptions.
                sign:
                  type: string
                  description: Request signature string. See [Request
                    signing](/payments/get-started/request-signing) for how to
                    generate it.
              required:
                - merchantNo
                - id
                - enrollmentEvent
                - sign
            examples:
              update-ethoca-enrollment-status:
                summary: Update Ethoca enrollment status
                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` means the transition request was processed successfully.
                      Other values are error codes. See [Response
                      codes](/payments/api-reference/response-codes)."
                  respMsg:
                    type: string
                    description: Human-readable message for the response code.
                  data:
                    type: object
                    properties:
                      success:
                        type: boolean
                        description: Whether this status transition request was accepted and executed.
                          `true` means the transition action took effect, but it
                          does not represent the final Ethoca service enrollment
                          or disablement result. Confirm the latest status
                          through [Query Ethoca
                          enrollments](/payments/api-reference/endpoints/query-ethoca-enrollments)
                          or the [Ethoca enrollment status
                          webhook](/payments/api-reference/webhooks/ethoca-enrollment-changed).
                      sign:
                        type: string
                        description: Response signature string for verifying response integrity.
                    description: Business data object indicating whether this status transition
                      request was accepted and executed by the system.
```