# Query RDR enrollments

> Query RDR service enrollment records and their current lifecycle status.

```yaml
openapi: 3.1.0
info:
  title: Query RDR enrollments
  version: 1.0.0
  description: Query RDR service enrollment records and their current lifecycle status.
paths:
  /rdr/agency-cw/enrollment/page:
    post:
      summary: Query RDR enrollments
      description: Query RDR service enrollment records and their current lifecycle status.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantNo:
                  type: string
                  description: Merchant number assigned by Onerway. It limits the query to one
                    merchant account.
                id:
                  type: string
                  description: Enrollment application ID. Submit it to query one application
                    record precisely.
                preDisputeService:
                  type: string
                  description: Service associated with the enrollment application.
                  enum:
                    - RDR
                  x-enum-descriptions:
                    RDR: Visa Rapid Dispute Resolution service.
                  x-onerway-constraints:
                    - kind: values
                      text: Submit `RDR` when querying RDR enrollments.
                bin:
                  type: string
                  description: Acquirer BIN (Bank Identification Number), identifying the
                    institution that provides acquiring services to the
                    merchant.
                  x-onerway-condition:
                    - Provide this field when filtering enrollment records by
                      acquirer BIN.
                dba:
                  type: string
                  description: Merchant doing-business-as name.
                  x-onerway-condition:
                    - Provide this field when filtering enrollment records by
                      merchant trading name.
                caid:
                  type: string
                  description: Card Acceptor ID (CAID).
                  x-onerway-condition:
                    - Provide this field when filtering enrollment records by
                      Card Acceptor ID.
                resellerSubMerchantId:
                  type: string
                  description: Sub-merchant identifier assigned by the agency operator.
                  x-onerway-condition:
                    - Provide this field when an agency operator queries
                      sub-merchant application records.
                enrollmentStatusList:
                  type: string
                  description: Filter enrollment applications by status.
                  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: Specify one or more enrollment statuses. Separate multiple values with
                        commas.
                createTimeStart:
                  type: string
                  description: Start of the application creation time range, in `yyyy-MM-dd
                    HH:mm:ss` format.
                  x-onerway-condition:
                    - Provide this field when filtering by application creation
                      time range.
                createTimeEnd:
                  type: string
                  description: End of the application creation time range, in `yyyy-MM-dd
                    HH:mm:ss` format.
                  x-onerway-condition:
                    - Provide this field when filtering by application creation
                      time range.
                updateTimeStart:
                  type: string
                  description: Start of the application update time range, in `yyyy-MM-dd
                    HH:mm:ss` format.
                  x-onerway-condition:
                    - Provide this field when filtering by update time range.
                updateTimeEnd:
                  type: string
                  description: End of the application update time range, in `yyyy-MM-dd HH:mm:ss`
                    format.
                  x-onerway-condition:
                    - Provide this field when filtering by update time range.
                current:
                  type: string
                  description: Query page number, starting from `1`.
                sign:
                  type: string
                  description: Request signature string. See [Request
                    signing](/payments/get-started/request-signing) for how to
                    generate it.
              required:
                - merchantNo
                - current
                - sign
            examples:
              query-rdr-enrollments:
                summary: Query RDR enrollments
                value:
                  current: "1"
                  enrollmentStatusList: ENROLLED,DISENROLLED
                  merchantNo: replace_with_merchant_no
                  preDisputeService: RDR
                  sign: "{{SIGN}}"
      responses:
        "200":
          description: Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  respCode:
                    type: string
                    description: "`20000` means the query 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:
                      content:
                        type: array
                        description: RDR enrollment records matching the query conditions.
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              description: Enrollment application ID.
                            merchantNo:
                              type: string
                              description: Merchant number assigned by Onerway, identifying the merchant
                                account.
                            preDisputeService:
                              type: string
                              description: Service associated with the enrollment application.
                              enum:
                                - RDR
                              x-enum-descriptions:
                                RDR: Visa Rapid Dispute Resolution service.
                            bin:
                              type: string
                              description: Acquirer BIN (Bank Identification Number), identifying the
                                institution that provides acquiring services to
                                the merchant.
                            caid:
                              type: string
                              description: Card Acceptor ID (CAID).
                            mcc:
                              type: string
                              description: Merchant Category Code (MCC).
                            dba:
                              type: string
                              description: Merchant doing-business-as name.
                            resellerSubMerchantId:
                              type:
                                - string
                                - "null"
                              description: Sub-merchant identifier assigned by the agency operator.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value for agency sub-merchant enrollment records. Regular merchant
                                    records can return an empty value.
                                  zh: 代理运营商子商户申请记录中有值；普通商户申请记录可能为空。
                            arn:
                              type: string
                              description: Acquirer Reference Number (ARN).
                            enrollmentStatus:
                              type: string
                              description: Current enrollment status across the application lifecycle.
                                `ENROLLED` means the RDR service is active and
                                eligible Visa disputes can be processed
                                automatically according to configured rules.
                                `ENROLLMENT_FAILED` means the merchant should
                                check `comments`, correct the issue, and
                                resubmit.
                              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.
                            notes:
                              type:
                                - string
                                - "null"
                              description: Application or status transition note.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when an application or transition note was provided; returns
                                    `null` when omitted.
                                  zh: 申请或变更时填写备注后有值；未填写备注时为 `null`。
                            comments:
                              type:
                                - string
                                - "null"
                              description: Review comments for the enrollment application. When enrollment
                                fails or is rejected, Onerway uses this field to
                                explain the reason so the merchant can correct
                                the issue and resubmit with `MERCHANT_RESUBMIT`.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when review comments exist; may be empty before comments are
                                    produced.
                                  zh: 已有审核意见时有值；尚未产生审核意见时可能为空。
                            createTime:
                              type: string
                              description: Application record creation time in `yyyy-MM-dd HH:mm:ss` format.
                            updateTime:
                              type: string
                              description: Application record update time in `yyyy-MM-dd HH:mm:ss` format.
                            sign:
                              type:
                                - string
                                - "null"
                              description: Record-level signature string.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: The record-level signature can return `null`.
                                  zh: 该字段可能返回 `null`。
                      current:
                        type: string
                        description: Current returned page number, using 1-based numbering.
                      size:
                        type: number
                        description: Number of records in the current page. The current page size is
                          fixed at 10 records.
                      totalPages:
                        type: number
                        description: Total number of pages based on the current page size.
                      totalElements:
                        type: number
                        description: Total number of enrollment records matching the query conditions.
                    description: Business data object containing RDR enrollment records and
                      pagination information.
```
