Onerway
POST

退款审核拒绝通知

查看 Markdown
回调地址
仅在 Onerway 审核拒绝退款申请时，向原交易请求的 notifyUrl 发送通知。请勿根据示例判断字段是否始终返回或能否为 null。处理要求见 Webhook 通知，退款请求见申请或取消退款。

验签范围

请求签名指南

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

  • sign（兼容签名值）

回调报文字段

notifyTypestring
通知类别。
transactionIdstring
Onerway 退款交易号。应答通知时原样返回该值。
merchantNostring
Onerway 分配的商户号。
merchantTxnIdstring
本次退款的商户交易号；申请退款时未传入则由 Onerway 自动生成。
originMerchantTxnIdstring
原支付交易的商户交易号。
responseTimestring
Onerway 生成通知结果的时间，格式为 yyyy-MM-dd HH:mm:ss。
txnTimeZonestring
通知中交易时间使用的时区偏移。
orderAmountstring
通知中的交易金额，以十进制字符串表示。币种见 orderCurrency。
orderCurrencystring
orderAmount 对应的币种。
statusstring
审核拒绝的退款申请结果：F（失败）。
reasonstring
以 JSON 字符串表示的结果说明，包含 respCode 和 respMsg。验签时直接使用收到的字段值，不要解析或重新序列化其中的 JSON。
signstring签名字段 · 不参与验签
兼容保留的请求体签名，不参与签名计算。该签名仅使用第一个启用的密钥生成；请使用 X-Rh-Signature 请求头中的签名验证通知。

回调示例

{
  "notifyType": "REFUND_AUDIT",
  "transactionId": "demo_transactionId",
  "merchantNo": "demo_merchantNo",
  "merchantTxnId": "demo_merchantTxnId",
  "originMerchantTxnId": "demo_originMerchantTxnId",
  "responseTime": "2026-09-14 00:35:26",
  "txnTimeZone": "+08:00",
  "orderAmount": "593.30",
  "orderCurrency": "USD",
  "status": "F",
  "reason": "{\"respCode\": \"70002\", \"respMsg\": \"Unknown decline\"}",
  "sign": "replace_with_signature"
}

应答说明

成功接收并受理通知后，返回 HTTP 200，使用 Content-Type: text/plain，并在响应体中原样返回收到的 transactionId。未收到成功响应时，Onerway 每 30 分钟重试，最多 3 次。

应答正文示例

HTTP 200
demo_transactionId

退款结果通知

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

拒付预警通知

通知拒付预警及其关联交易信息。