Onerway
POST

RDR 报备状态通知

查看 Markdown
回调地址
通过商户后台配置的通知地址接收 RDR 报备状态变更通知。

验签范围

请求签名指南

除以下字段外，全部回调报文字段均参与验签：

回调报文字段

idnumber
申请单号。
约束
规则
该 JSON 数字可能超出 JavaScript 安全整数范围。解析 JSON 时须无损保留完整十进制值，用于验签和应答。
规则
同一申请的不同状态变化可携带相同 id，不要仅凭该字段对通知去重。
merchantNonumber
Onerway 分配的商户号，标识商户账户。
preDisputeServicestring
申请对应的服务类型，固定为 RDR。
可选值
RDR
RDR（快速争议解决）。
binstring
收单机构 BIN（Bank Identification Number），用于标识为商户提供收单服务的机构。
caidstring
报备申请中提供的商户受理标识（CAID，Card Acceptor ID）。
mccstring
报备申请中提供的商户类别代码（MCC，Merchant Category Code）。
dbastring
报备申请中提供的商户对外经营名称（DBA，Doing Business As）。
resellerSubMerchantIdstring
代理运营商的子商户标识。
arnstring
报备申请中提供的收单参考号（ARN，Acquirer Reference Number）。
fromEnrollmentStatusstring
本次变更前的申请状态。
可选值
PENDING_SUBMISSION
待提交。
SUBMITTED_AND_PENDING_ENROLLMENT
已提交，等待开通。
ENROLLING
开通中。
enrollmentStatusstring
本次变更后的申请状态。
可选值
PENDING_SUBMISSION
待提交。
SUBMITTED_AND_PENDING_ENROLLMENT
已提交，等待开通。
ENROLLING
开通中。
约束
规则
不要假定每种申请状态变化都会触发通知。
notesstring
申请或状态变更备注。
commentsstring
申请的审核意见。
createOprstring
创建申请记录的操作人。
createTimestring
申请记录创建时间。
约束
规则
格式为 yyyy-MM-dd HH:mm:ss。
updateOprstring
最近一次更新申请记录的操作人。
updateTimestring
申请记录更新时间。
约束
规则
格式为 yyyy-MM-dd HH:mm:ss。
signstring签名字段 · 不参与验签
通知签名。使用当前环境的 SECRET，按 Payments 签名算法验签。
约束
规则
计算签名时排除 sign 字段自身。

回调示例

{
  "id": 100002,
  "merchantNo": 100000,
  "preDisputeService": "RDR",
  "bin": "replace_with_bin",
  "caid": "demo_card_acceptor_id",
  "mcc": "5999",
  "dba": "EXAMPLE STORE",
  "resellerSubMerchantId": "demo_sub_merchant_001",
  "arn": "demo_acquirer_reference_number",
  "fromEnrollmentStatus": "SUBMITTED_AND_PENDING_ENROLLMENT",
  "enrollmentStatus": "ENROLLING",
  "notes": null,
  "comments": "Example review approved",
  "createOpr": "demo_creator",
  "createTime": "2026-09-01 10:00:00",
  "updateOpr": "demo_reviewer",
  "updateTime": "2026-09-01 10:10:00",
  "sign": "replace_with_sha256_signature"
}

应答说明

验签通过并受理通知后，返回 HTTP 200，Content-Type 为 text/plain。响应体须原样返回收到的 id 值，不得丢失精度。未收到成功响应时，Onerway 以 30 分钟间隔重试，最多 3 次。

应答正文示例

HTTP 200
100002

Ethoca 报备状态通知

Ethoca 报备状态变更通知的字段、验签和应答要求。

退款结果通知

退款结果（txnType=REFUND）发送到原交易请求的 notifyUrl。