Onerway
POST

退款结果通知

查看 Markdown
回调地址
通过原交易请求的 notifyUrl 接收退款结果。请勿根据示例判断字段是否始终返回或能否为 null。处理要求见 Webhook 通知，退款请求见申请或取消退款。

验签范围

请求签名指南

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

回调报文字段

notifyTypestring
通知类别。
transactionIdstring
Onerway 退款交易号。应答通知时原样返回该值。
paymentIdstring
本次退款关联的支付意图 ID。
txnTypestring
交易操作类型；REFUND 表示退款结果。
merchantNostring
Onerway 分配的商户号。
merchantTxnIdstring
本次退款的商户交易号；申请退款时未传入则由 Onerway 自动生成。
originMerchantTxnIdstring
原支付交易的商户交易号。
responseTimestring
Onerway 生成通知结果的时间，格式为 yyyy-MM-dd HH:mm:ss。
txnTimestring
通知中的交易时间，格式为 yyyy-MM-dd HH:mm:ss。
txnTimeZonestring
通知中交易时间使用的时区偏移。
orderAmountstring
通知中的交易金额，以十进制字符串表示。币种见 orderCurrency。
orderCurrencystring
orderAmount 对应的币种。
statusstring
退款处理结果；S 表示成功，F 表示失败。
cardBinCountrystring
卡 BIN 所属国家或地区。
reasonstring
以 JSON 字符串表示的结果说明，包含 respCode 和 respMsg。验签时直接使用收到的字段值，不要解析或重新序列化其中的 JSON。
signstring签名字段 · 不参与验签
兼容保留的请求体签名，不参与签名计算。该签名仅使用第一个启用的密钥生成；请使用 X-Rh-Signature 请求头中的签名验证通知。
paymentMethodstring不参与验签
通知中的支付方式或卡品牌；该字段不参与签名计算。
walletTypeNamestring不参与验签
通知中的钱包类型；该字段不参与签名计算。
channelRequestIdstring
支付渠道的请求标识。
paymentMethodDetailsstring
以 JSON 字符串表示的支付方式详情。验签时直接使用收到的字段值，不要解析或重新序列化其中的 JSON。

回调示例

{
  "notifyType": "TXN",
  "transactionId": "demo_transactionId",
  "paymentId": "demo_paymentId",
  "txnType": "REFUND",
  "merchantNo": "demo_merchantNo",
  "merchantTxnId": "demo_merchantTxnId",
  "originMerchantTxnId": "demo_originMerchantTxnId",
  "responseTime": "2026-09-14 00:05:29",
  "txnTime": "2026-09-14 00:05:28",
  "txnTimeZone": "+08:00",
  "orderAmount": "13.36",
  "orderCurrency": "USD",
  "status": "S",
  "cardBinCountry": "US",
  "reason": "{\"respCode\": \"20000\", \"respMsg\": \"Success\"}",
  "sign": "replace_with_signature",
  "paymentMethod": "VISA",
  "walletTypeName": "ApplePay",
  "channelRequestId": "demo_channelRequestId",
  "paymentMethodDetails": "{\"card\": {\"checks\": null, \"holderName\": null, \"year\": null, \"month\": null, \"cardType\": \"ApplePay\", \"productCategory\": null, \"issuer\": null, \"cardBinCountry\": \"US\", \"authorizationCode\": null, \"cardNumber\": \"[REDACTED]\"}}"
}

应答说明

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

应答正文示例

HTTP 200
demo_transactionId

RDR 报备状态通知

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

退款审核拒绝通知

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