# Update RDR enrollment status

> Submit, withdraw, or resubmit an RDR enrollment application.

```yaml
openapi: 3.1.0
info:
  title: Update RDR enrollment status
  version: 1.0.0
  description: Submit, withdraw, or resubmit an RDR enrollment application.
paths:
  /rdr/agency-cw/enrollment/transition:
    post:
      summary: Update RDR enrollment status
      description: Submit, withdraw, or resubmit an RDR enrollment application.
      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 RDR service application
                    to transition.
                bin:
                  type: string
                  description: Acquirer BIN (Bank Identification Number), identifying the
                    institution that provides acquiring services to the
                    merchant.
                  x-onerway-condition:
                    - You can provide this field when resubmitting or
                      supplementing application information.
                dba:
                  type: string
                  description: Merchant doing-business-as name.
                  x-onerway-condition:
                    - You can provide this field when resubmitting or
                      supplementing application information.
                caid:
                  type: string
                  description: Card Acceptor ID (CAID).
                  x-onerway-condition:
                    - You can provide this field when resubmitting or
                      supplementing application information.
                mcc:
                  type: string
                  description: Merchant Category Code (MCC).
                  x-onerway-condition:
                    - You can provide this field when resubmitting or
                      supplementing application information.
                arn:
                  type: string
                  description: Acquirer Reference Number (ARN).
                  x-onerway-condition:
                    - You can provide this field 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 service enrollment
                      configuration is in progress.
                    ENROLLED: Enrolled. The service is active.
                    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.
                  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_SUBMIT
                    - MERCHANT_WITHDRAW
                    - MERCHANT_RESUBMIT
                  x-enum-descriptions:
                    MERCHANT_SUBMIT: Merchant submits the application. Use it to submit an
                      application in pending-submission state for review.
                    MERCHANT_WITHDRAW: Merchant withdraws or disables the service. Use it to
                      withdraw an application that is pending review, or to
                      request disabling an enrolled RDR 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.
                comments:
                  type: string
                  description: Review comment field. Leave it empty for merchant-submitted
                    transitions; use `notes` for supplementary information.
                  x-onerway-constraints:
                    - kind: rule
                      text: Leave this field empty for merchant-submitted transitions. Use `notes` for
                        supplementary information.
                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-rdr-enrollment-status:
                summary: Update RDR enrollment status
                value:
                  enrollmentEvent: MERCHANT_RESUBMIT
                  id: replace_with_enrollment_id
                  merchantNo: replace_with_merchant_no
                  notes: Updated RDR application details
                  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 RDR service enrollment or
                          disablement result. Confirm the latest status through
                          [Query RDR
                          enrollments](/payments/api-reference/endpoints/query-rdr-enrollments)
                          or the [RDR enrollment status
                          webhook](/payments/api-reference/webhooks/rdr-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.
```
