• RDR 申请状态变更
  • 功能说明
    • 状态流转说明
  • 接口定义
  • 请求参数
  • 响应参数
    • data
  • 请求及响应示例
  • 状态流转流程
  • 注意事项

RDR 申请状态变更

本文档介绍如何变更 RDR 预警服务申请的状态。通过该接口，您可以对申请进行状态流转，如提交申请、撤回申请等操作。

功能说明

申请状态变更接口允许商户：

• 提交新的申请
• 撤回处理中的申请
• 更新申请的基本信息
• 补充申请所需的材料

状态流转说明

可进行的状态变更操作：

• MERCHANT_SUBMIT - 商户提交申请
• MERCHANT_WITHDRAW - 撤回申请
• MERCHANT_RESUBMIT - 重新提交申请
• 其他状态变更将由系统自动处理

接口定义

POST

请求参数

名称	类型	长度	必填	签名	描述
merchantNo	String	20	Yes	Yes	商户编号
id	String	64	Yes	Yes	申请单号
bin	String	32	No	Yes	BIN 码
dba	String	128	No	Yes	Doing Business As: 商户实际经营名称
caid	String	32	No	Yes	CAID: 持卡人账户标识符
mcc	String	32	No	Yes	MCC: 商户类别代码
arn	String	32	No	Yes	ARN: 收单参考号
resellerSubMerchantId	String	20	No	Yes	代理运营商的子商户标识
enrollmentStatus	String	32	No	Yes	指定流转的下一个状态。如果不填写，系统将根据 enrollmentEvent 自动进行状态流转
enrollmentEvent	String	32	Yes	Yes	状态变更事件： MERCHANT_SUBMIT - 提交申请 MERCHANT_WITHDRAW - 撤回申请 MERCHANT_RESUBMIT - 重新提交
notes	String	256	No	Yes	变更说明，如撤回原因、重新提交说明等
comments	String	256	No	Yes	审批意见
sign	String	/	Yes	No	签名字符串，请参阅签名接口

响应参数

名称	类型	描述
respCode	String	来自 Onerway 的响应码
respMsg	String	来自 Onerway 的响应信息
data	Object	响应数据。 请参阅对象 data

data

名称	签名	类型	描述
success	Yes	Boolean	状态变更是否成功
sign	No	String	签名字符串，请参阅签名接口

请求及响应示例

POST

请求参数

{
  "arn": "",
  "bin": "453760",
  "caid": "",
  "comments": "",
  "dba": "",
  "enrollmentEvent": "MERCHANT_SUBMIT",
  "enrollmentStatus": "",
  "id": "1906542421689634816",
  "mcc": "",
  "merchantNo": "800209",
  "notes": null,
  "resellerSubMerchantId": "",
  "sign": "422f1df47e153a5abf54d2c5cba57143f8a371d3dec3347d2c9fc9d73ff8fb34"
}

响应示例

{
    "respCode": "20000",
    "respMsg": "Success",
    "data": {
        "success": true,
        "sign": "899988f6f4fff6e522eedbadd8aa4bdad15c96c283d8ef86af5f5cc7bb9d0963"
    }
}

状态流转流程

注意事项

注意事项

1. 状态变更的合法性由系统自动控制
2. 不同状态下可执行的变更操作不同：
   • 待提交状态可以提交申请
   • 处理中状态可以撤回申请
   • 已拒绝状态可以重新提交申请
3. 如果不指定 enrollmentStatus，系统将自动处理状态流转
4. 每次状态变更都需要提供合理的变更说明

最佳实践

1. 在撤回申请前，请确认是否真的需要这样做
2. 重新提交时，建议在 notes 中详细说明已修正的问题
3. 变更后及时查询申请的最新状态
4. 保存好申请单号(id)，便于后续操作
5. 如需更新申请信息，可在状态变更时一并提交