# RDR 服务开通申请

> 为商户或代理子商户提交 Visa 快速争议解决服务开通申请。

```yaml
openapi: 3.1.0
info:
  title: RDR 服务开通申请
  version: 1.0.0
  description: 为商户或代理子商户提交 Visa 快速争议解决服务开通申请。
paths:
  /rdr/agency-cw/enrollment/submit:
    post:
      summary: RDR 服务开通申请
      description: 为商户或代理子商户提交 Visa 快速争议解决服务开通申请。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantNo:
                  type: string
                  description: Onerway 分配的商户号；代理运营商为子商户申请时，使用代理运营商自己的商户号发起请求。
                preDisputeService:
                  type: string
                  description: 要开通的服务类型。RDR（快速争议解决）是 Visa 面向 Visa
                    卡交易的拒付预防服务；商户预先配置处理规则后，符合条件的争议可在升级为正式拒付前按规则自动处理。
                  enum:
                    - RDR
                  x-enum-descriptions:
                    RDR: Visa 快速争议解决（拒付预防）服务。
                  x-onerway-constraints:
                    - kind: values
                      text: 本接口固定传 `RDR`。
                bin:
                  type: string
                  description: 收单机构 BIN（Bank Identification Number），用于标识为商户提供收单服务的机构。
                dba:
                  type: string
                  description: 商户对外经营名称（DBA，Doing Business As），即显示在持卡人账单 /
                    交易中的商户名称；代理运营商为子商户申请时，填子商户的实际经营名称。
                caid:
                  type: string
                  description: 商户受理标识（CAID，Card Acceptor ID），收单机构分配给商户、用于在卡组织侧定位该商户及其交易的标识。
                mcc:
                  type: string
                  description: 商户类别代码（MCC，Merchant Category Code），卡组织定义的四位数字代码，标识商户经营类别。
                arn:
                  type: string
                  description: 收单参考号（ARN，Acquirer Reference
                    Number），交易在收单机构与卡组织间流转时的唯一追踪号，用于定位具体交易。
                resellerSubMerchantId:
                  type: string
                  description: 代理运营商的子商户标识。
                  x-onerway-condition:
                    - 代理运营商为其管理的子商户申请服务时提供。
                  x-onerway-constraints:
                    - kind: consistency
                      text: 同一个代理运营商（`merchantNo`）可为多个子商户分别申请开通 RDR 服务；代理商应为每个子商户分配唯一
                        `resellerSubMerchantId`，各子商户申请互不影响。
                notes:
                  type: string
                  description: 申请备注，可填写特殊需求或补充说明。
                comments:
                  type: string
                  description: 审核意见字段。商户提交申请时留空；补充说明请使用 `notes`。
                  x-onerway-constraints:
                    - kind: rule
                      text: 商户提交申请时请留空；如需补充说明请使用 `notes`。
                sign:
                  type: string
                  description: 请求签名字符串；生成方式详见[请求签名](/zh/payments/get-started/request-signing)。
              required:
                - merchantNo
                - preDisputeService
                - bin
                - dba
                - caid
                - mcc
                - arn
                - sign
            examples:
              submit-rdr-enrollment:
                summary: 提交 RDR 开通申请
                value:
                  arn: replace_with_acquirer_reference_number
                  bin: replace_with_bin
                  caid: replace_with_card_acceptor_id
                  dba: EXAMPLE STORE US
                  mcc: "5999"
                  merchantNo: replace_with_merchant_no
                  notes: Open RDR service
                  preDisputeService: RDR
                  resellerSubMerchantId: demo_sub_merchant_001
                  sign: "{{SIGN}}"
      responses:
        "200":
          description: Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  respCode:
                    type: string
                    description: 响应码；`20000` 表示开通申请已成功提交受理，并不代表 RDR 服务已开通。服务需经审核并进入 `ENROLLED`
                      状态后才生效，最终结果以[查询 RDR
                      申请状态接口](/zh/payments/api-reference/endpoints/query-rdr-enrollments)或
                      [RDR
                      报备状态通知](/zh/payments/api-reference/webhooks/rdr-enrollment-changed)为准；其余为错误码。完整码表见[响应码](/zh/payments/api-reference/response-codes)。
                  respMsg:
                    type: string
                    description: 响应码对应的可读说明。
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        description: 申请单号，用于后续查询申请状态或发起状态变更。
                      sign:
                        type: string
                        description: 响应签名字符串，可用于校验响应数据完整性。
                    description: 业务数据对象，包含本次服务开通申请的申请单号。
```