Onerway
POST

拒付预警通知

查看 Markdown
回调地址
在配置的拒付预警通知地址接收预警；应答时原样返回收到的 predisputeId。

验签范围

请求签名指南

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

  • sign（兼容签名值）

回调报文字段

notifyTypestring
通知类型，固定为 PRE_DISPUTE。
可选值
PRE_DISPUTE
拒付预警。
transactionIdstring
Onerway 预警 ID，与 predisputeId 相同；不是原支付交易 ID。
merchantNostring
Onerway 分配的商户号。
predisputeIdstring
拒付预警的唯一 ID，应答时在响应体中原样返回该值。
timeZonestring
通知中的时区偏移；该字段可能不出现。
servicestring
预警服务。商户已开启服务名称展示且有对应值时返回，否则可能不出现。
typestring
预警类型。商户已开启类型展示且有对应值时返回，否则可能不出现。
createdTimestring
预警发起时间，格式为 yyyy-MM-dd HH:mm:ss。
receivedTimestring
预警成功匹配交易的时间，格式为 yyyy-MM-dd HH:mm:ss；无匹配时间时可能不出现。
amountstring
预警退款金额，币种见 currency，以两位小数的十进制字符串表示。优先使用剩余可退金额；无该值时使用预警金额。可能与 orderAmount 不同。
currencystring
amount 的币种：有预警退款金额时使用其币种，否则使用预警币种。
sourcestring
预警发起方；无对应信息时可能不出现。
reasonCodestring
预警原因码；无对应信息时可能不出现。
txnIdstring
原支付交易的 Onerway 交易 ID。未取得对应原交易信息时，该字段可能不出现。
merchantTxnIdstring
原支付交易的商户订单号。未取得对应原交易信息时，该字段可能不出现。
txnTimestring
原交易创建时间，格式为 yyyy-MM-dd HH:mm:ss。未取得对应原交易信息时，该字段可能不出现。
orderAmountstring
原订单金额，币种见 orderCurrency，以两位小数的十进制字符串表示。未取得对应原交易信息时，该字段可能不出现。
orderCurrencystring
原订单金额的币种。未取得对应原交易信息时，该字段可能不出现。
paymentMethodstring
原交易的支付方式或卡品牌。未取得对应原交易信息时，该字段可能不出现。
ecistring
原交易的电子商务标识（ECI）。未取得对应原交易信息时，该字段可能不出现。
websitestring
持卡人发起原交易的网站。未取得对应原交易信息时，该字段可能不出现。
emailstring
原交易关联的邮箱地址。未取得对应原交易信息时，该字段可能不出现。
chargebackStatusstring
匹配交易是否存在拒付；无对应信息时可能不出现，不表示拒付处理阶段。
可选值
0
无拒付。
1
有拒付。
refundStatusstring
匹配交易的退款状态；无对应信息时可能不出现。
可选值
0
未退款。
1
全部退款。
2
部分退款。
signstring签名字段 · 不参与验签
通知体中的签名值。该字段本身不参与签名计算。请按签名指南使用 X-Rh-Signature 请求头验签。

回调示例

{
  "notifyType": "PRE_DISPUTE",
  "transactionId": "example_predispute",
  "merchantNo": "example_merchant",
  "predisputeId": "example_predispute",
  "type": "customerdispute_alert",
  "createdTime": "2026-09-17 22:59:37",
  "receivedTime": "2026-09-17 22:59:40",
  "amount": "10.00",
  "currency": "USD",
  "txnId": "example_payment",
  "merchantTxnId": "example_order",
  "txnTime": "2026-07-27 18:10:59",
  "orderAmount": "11.00",
  "orderCurrency": "USD",
  "paymentMethod": "VISA",
  "chargebackStatus": "0",
  "refundStatus": "2",
  "eci": "5",
  "website": "example.com",
  "email": "buyer@example.com",
  "sign": "replace_with_signature"
}

应答说明

受理通知后，返回 HTTP 200，并在响应体中原样返回收到的 predisputeId。不要添加 JSON 引号、空白或换行。空响应或其他 ID 均不符合应答要求。发送失败或应答不符合要求时，Onerway 每 30 分钟重试，最多重试 2 次。

应答正文示例

HTTP 200
原样返回收到的 predisputeId。请勿固定返回示例值。
example_predispute

退款审核拒绝通知

仅在 Onerway 审核拒绝退款申请时，向原交易请求的 notifyUrl 发送通知（notifyType=REFUND_AUDIT）。

拒付状态变化通知

通知拒付状态变化，不进行重试。