Onerway
POST

拒付状态变化通知

查看 Markdown
回调地址
接收 notifyType=CHARGEBACK 的拒付状态变化通知。需要查询记录时，请使用查询拒付记录。

验签范围

请求签名指南

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

回调报文字段

notifyTypestring
通知类型，固定为 CHARGEBACK。
可选值
CHARGEBACK
拒付状态变化。
merchantNostring
Onerway 分配的商户号。
transactionIdstring
Onerway 拒付交易 ID，标识本次拒付，不是原支付交易 ID。
originTransactionIdstring不参与验签
原支付交易的 Onerway 交易 ID，不参与签名计算。
originMerchantTxnIdstring不参与验签
原支付交易的商户订单号，不参与签名计算。
importTimestring
Onerway 记录本次拒付的时间，格式为 yyyy-MM-dd HH:mm:ss。
chargebackDatestring
发卡机构处理拒付的日期，格式为 yyyy-MM-dd。
chargebackAmountstring
拒付金额，以十进制字符串表示，币种见 chargebackCurrency。
chargebackCurrencystring
拒付金额的币种，通常与原交易币种一致。
chargebackStatusstring
本次通知报告的拒付状态。
可选值
NEW
新发起的拒付。
FA
首次拒付申诉进行中。
FAF
首次拒付申诉失败。
chargebackArnstring
拒付关联的收单参考号（ARN）。
chargebackCodestring
卡组织规定的拒付原因码。
chargebackReasonstring
拒付原因说明，为自由文本。
appealReasonstring
拒付申诉的审核意见；无审核意见时，该字段可能不出现。
appealDueTimestring
提交申诉资料的截止时间，格式为 yyyy-MM-dd HH:mm:ss。NEW 时为首次拒付申诉截止时间，FAF 时为仲裁阶段截止时间；其他状态或无截止时间时，该字段可能不出现。
signstring签名字段 · 不参与验签
通知体中的签名值。该字段本身不参与签名计算。请按签名指南使用 X-Rh-Signature 请求头验签。

回调示例

{
  "notifyType": "CHARGEBACK",
  "merchantNo": "example_merchant",
  "transactionId": "example_chargeback",
  "originTransactionId": "example_payment",
  "originMerchantTxnId": "example_order",
  "importTime": "2026-09-18 00:29:49",
  "chargebackDate": "2026-09-18",
  "chargebackAmount": "10.00",
  "chargebackCurrency": "USD",
  "chargebackStatus": "NEW",
  "chargebackArn": "example_arn",
  "chargebackCode": "13.1",
  "chargebackReason": "Merchandise/Services Not Received",
  "sign": "replace_with_signature",
  "appealDueTime": "2026-09-26 00:29:49"
}

应答说明

成功接收并受理拒付状态变化通知后返回 HTTP 200，并在响应体中原样返回收到的 transactionId。请勿固定返回示例值。Onerway 不重试此通知。

应答正文示例

HTTP 200
example_chargeback

拒付预警通知

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

响应码

对照 Onerway 支付响应中的英文 message，查看中文说明和建议排查动作。