简体中文

English

简体中文

English

主题

RDR 申请状态查询 ​

本文档介绍如何查询 RDR 预警服务的申请状态。通过该接口，您可以随时了解您提交的 RDR 服务申请的审核进度和结果。

功能介绍 ​

申请状态查询接口允许商户：

  • 分页查询 RDR 预警服务申请的处理状态
  • 根据多种条件筛选申请记录
  • 查看申请的详细信息，包括申请时间、审核状态等
  • 跟踪申请从提交到最终开通的全流程状态

申请状态类型 ​

申请状态主要分为以下几种：

  • PENDING_SUBMISSION - 待提交
  • SUBMITTED_AND_PENDING_ENROLLMENT - 已提交待开通
  • ENROLLING - 开通中
  • ENROLLED - 已开通
  • ENROLLMENT_FAILED - 开通失败
  • SUBMITTED_AND_PENDING_DISENROLLMENT - 已提交待关闭
  • DISENROLLING - 关闭中
  • DISENROLLED - 已关闭

接口定义 ​

GET

请求参数 ​

名称类型长度必填签名描述
merchantNoString20YesYes商户编号
idString64NoYes申请单号
preDisputeServiceString32NoYes预警服务，固定值：RDR
binString32NoYesBIN 码
dbaString128NoYes商户实际经营名称
caidString32NoYesCAID：持卡人账户标识符
resellerSubMerchantIdString20NoYes代理运营商的子商户标识
enrollmentStatusListString32NoYes报备状态，见申请状态类型
createTimeStartString32NoYes创建时间起点，格式：yyyy-MM-dd HH:mm:ss
createTimeEndString32NoYes创建时间终点，格式：yyyy-MM-dd HH:mm:ss
updateTimeStartString32NoYes更新时间起点，格式：yyyy-MM-dd HH:mm:ss
updateTimeEndString32NoYes更新时间终点，格式：yyyy-MM-dd HH:mm:ss
currentString8YesYes查询页码，从1开始
signString/YesNo签名字符串，请参阅签名接口

响应参数 ​

名称类型描述
respCodeString来自 Onerway 的响应码
respMsgString来自 Onerway 的响应信息
dataObject响应数据。 请参阅对象 data

data ​

名称签名类型描述
contentYesArray申请记录列表
currentYesString当前页码
sizeYesNumber每页记录数
totalPagesYesNumber总页数
totalElementsYesNumber总记录数

content 中的对象 ​

名称签名类型描述
idYesString申请单号
merchantNoYesString商户编号
preDisputeServiceYesString预警服务类型
binYesStringBIN 码
caidYesStringCAID：持卡人账户标识符
mccYesStringMCC：商户类别代码
dbaYesStringDoing Business As：商户实际经营名称
resellerSubMerchantIdYesString代理子商户编号
arnYesStringARN：收单参考号
enrollmentStatusYesString申请状态，见申请状态类型
notesYesString备注信息
commentsYesString审核意见
createTimeYesString创建时间，格式：yyyy-MM-dd HH:mm:ss
updateTimeYesString更新时间，格式：yyyy-MM-dd HH:mm:ss
signNoString签名字符串

请求及响应示例 ​

GET
json
{
    "bin": "",
    "caid": "",
    "createTimeEnd": "2025-03-31 13:29:07",
    "createTimeStart": "2025-01-31 13:29:07",
    "current": "1",
    "dba": "",
    "enrollmentStatusList": "",
    "id": "",
    "merchantNo": "800209",
    "preDisputeService": "RDR",
    "resellerSubMerchantId": "",
    "sign": "81f09d0c0edb05e9a40aff2b47a177bf42ab622145a324fc0c6956197ab46e8b",
    "updateTimeEnd": null,
    "updateTimeStart": null
}
json
{
    "respCode": "20000",
    "respMsg": "Success",
    "data": {
        "content": [
            {
                "id": "1906576189242609664",
                "merchantNo": "800209",
                "preDisputeService": "RDR",
                "bin": "453760",
                "caid": "171000000014798",
                "mcc": "6211",
                "dba": "ONERWAY",
                "resellerSubMerchantId": "578757",
                "arn": "071090861290651041",
                "enrollmentStatus": "SUBMITTED_AND_PENDING_ENROLLMENT",
                "notes": null,
                "comments": "pass",
                "createTime": "2025-03-31 13:16:01",
                "updateTime": "2025-03-31 13:16:01",
                "sign": null
            },
            {
                "id": "1906542421689634816",
                "merchantNo": "800209",
                "preDisputeService": "RDR",
                "bin": "453760",
                "caid": "171000000068907",
                "mcc": "6211",
                "dba": "ONERWAY",
                "resellerSubMerchantId": "038790",
                "arn": "343029710464324627",
                "enrollmentStatus": "SUBMITTED_AND_PENDING_ENROLLMENT",
                "notes": null,
                "comments": "decline",
                "createTime": "2025-03-31 11:01:50",
                "updateTime": "2025-03-31 11:03:02",
                "sign": null
            }
        ],
        "current": "1",
        "size": 10,
        "totalPages": 1,
        "totalElements": 5
    }
}

状态查询流程 ​

注意事项 ​

注意事项

  1. 申请状态查询接口支持分页查询，可通过current参数指定页码
  2. 可通过日期范围、状态等条件筛选申请记录
  3. 建议定期查询申请状态，以便及时了解申请进度
  4. 当状态变为ENROLLED后，服务已成功开通
  5. 如果状态为ENROLLMENT_FAILED，请根据comments中的审核意见修正问题后重新申请

最佳实践

  1. 设置合理的查询时间范围，避免返回过多数据
  2. 优先使用申请单号(id)进行精确查询
  3. 对于代理商，可使用resellerSubMerchantId查询特定子商户的申请状态
  4. 记录每次申请的id，以便后续跟踪
  5. 关注comments字段中的审核意见，及时处理反馈