Onerway
POST

Ethoca 报备状态通知

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

验签范围

请求签名指南

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

回调报文字段

idnumber
申请单号。
约束
规则
该 JSON 数字可能超出 JavaScript 安全整数范围。解析 JSON 时须无损保留完整十进制值，用于验签和应答。
规则
同一申请的不同状态变化可携带相同 id，不要仅凭该字段对通知去重。
merchantNonumber
Onerway 分配的商户号，标识商户账户。
preDisputeServicestring
申请对应的服务类型，固定为 ETHOCA_ALERT。
可选值
ETHOCA_ALERT
Ethoca 拒付预警服务。
billDescstring
申请中登记的商户账单描述，即持卡人账单上显示的商户描述。
resellerSubMerchantIdstring
代理运营商的子商户标识。
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": 100001,
  "merchantNo": 100000,
  "preDisputeService": "ETHOCA_ALERT",
  "billDesc": "EXAMPLE STORE US",
  "resellerSubMerchantId": "demo_sub_merchant_001",
  "fromEnrollmentStatus": "SUBMITTED_AND_PENDING_ENROLLMENT",
  "enrollmentStatus": "ENROLLING",
  "notes": "Example enrollment request",
  "comments": "Example review approved",
  "createOpr": "demo_operator",
  "createTime": "2026-09-01 10:00:00",
  "updateOpr": "demo_reviewer",
  "updateTime": "2026-09-01 10:01:00",
  "sign": "replace_with_sha256_signature"
}

应答说明

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

应答正文示例

HTTP 200
100001

保存支付方式结果通知

接收保存支付方式（绑卡）交易的最终结果回调报文，覆盖纯绑卡与订阅并绑卡场景。

RDR 报备状态通知

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