# 拒付预警通知

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

```yaml
openapi: 3.1.0
info:
  title: 拒付预警通知
  version: 1.0.0
  description: 通知拒付预警及其关联交易信息。
webhooks:
  chargeback.alert.created:
    post:
      summary: 拒付预警通知
      description: 通知拒付预警及其关联交易信息。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                notifyType:
                  type: string
                  description: 通知类型，固定为 `PRE_DISPUTE`。
                  enum:
                    - PRE_DISPUTE
                  x-enum-descriptions:
                    PRE_DISPUTE: 拒付预警。
                  x-onerway-signature-participation: included
                transactionId:
                  type: string
                  description: Onerway 预警 ID，与 `predisputeId` 相同；不是原支付交易 ID。
                  x-onerway-signature-participation: included
                merchantNo:
                  type: string
                  description: Onerway 分配的商户号。
                  x-onerway-signature-participation: included
                predisputeId:
                  type: string
                  description: 拒付预警的唯一 ID，应答时在响应体中原样返回该值。
                  x-onerway-signature-participation: included
                timeZone:
                  type: string
                  description: 通知中的时区偏移；该字段可能不出现。
                  x-onerway-signature-participation: included
                service:
                  type: string
                  description: 预警服务。商户已开启服务名称展示且有对应值时返回，否则可能不出现。
                  x-onerway-signature-participation: included
                type:
                  type: string
                  description: 预警类型。商户已开启类型展示且有对应值时返回，否则可能不出现。
                  x-onerway-signature-participation: included
                createdTime:
                  type: string
                  description: 预警发起时间，格式为 `yyyy-MM-dd HH:mm:ss`。
                  x-onerway-signature-participation: included
                receivedTime:
                  type: string
                  description: 预警成功匹配交易的时间，格式为 `yyyy-MM-dd HH:mm:ss`；无匹配时间时可能不出现。
                  x-onerway-signature-participation: included
                amount:
                  type: string
                  description: 预警退款金额，币种见 `currency`，以两位小数的十进制字符串表示。优先使用剩余可退金额；无该值时使用预警金额。可能与
                    `orderAmount` 不同。
                  x-onerway-signature-participation: included
                currency:
                  type: string
                  description: "`amount` 的币种：有预警退款金额时使用其币种，否则使用预警币种。"
                  x-onerway-signature-participation: included
                source:
                  type: string
                  description: 预警发起方；无对应信息时可能不出现。
                  x-onerway-signature-participation: included
                reasonCode:
                  type: string
                  description: 预警原因码；无对应信息时可能不出现。
                  x-onerway-signature-participation: included
                txnId:
                  type: string
                  description: 原支付交易的 Onerway 交易 ID。未取得对应原交易信息时，该字段可能不出现。
                  x-onerway-signature-participation: included
                merchantTxnId:
                  type: string
                  description: 原支付交易的商户订单号。未取得对应原交易信息时，该字段可能不出现。
                  x-onerway-signature-participation: included
                txnTime:
                  type: string
                  description: 原交易创建时间，格式为 `yyyy-MM-dd HH:mm:ss`。未取得对应原交易信息时，该字段可能不出现。
                  x-onerway-signature-participation: included
                orderAmount:
                  type: string
                  description: 原订单金额，币种见 `orderCurrency`，以两位小数的十进制字符串表示。未取得对应原交易信息时，该字段可能不出现。
                  x-onerway-signature-participation: included
                orderCurrency:
                  type: string
                  description: 原订单金额的币种。未取得对应原交易信息时，该字段可能不出现。
                  x-onerway-signature-participation: included
                paymentMethod:
                  type: string
                  description: 原交易的支付方式或卡品牌。未取得对应原交易信息时，该字段可能不出现。
                  x-onerway-signature-participation: included
                eci:
                  type: string
                  description: 原交易的电子商务标识（ECI）。未取得对应原交易信息时，该字段可能不出现。
                  x-onerway-signature-participation: included
                website:
                  type: string
                  description: 持卡人发起原交易的网站。未取得对应原交易信息时，该字段可能不出现。
                  x-onerway-signature-participation: included
                email:
                  type: string
                  description: 原交易关联的邮箱地址。未取得对应原交易信息时，该字段可能不出现。
                  x-onerway-signature-participation: included
                chargebackStatus:
                  type: string
                  description: 匹配交易是否存在拒付；无对应信息时可能不出现，不表示拒付处理阶段。
                  enum:
                    - "0"
                    - "1"
                  x-enum-descriptions:
                    "0": 无拒付。
                    "1": 有拒付。
                  x-onerway-signature-participation: included
                refundStatus:
                  type: string
                  description: 匹配交易的退款状态；无对应信息时可能不出现。
                  enum:
                    - "0"
                    - "1"
                    - "2"
                  x-enum-descriptions:
                    "0": 未退款。
                    "1": 全部退款。
                    "2": 部分退款。
                  x-onerway-signature-participation: included
                sign:
                  type: string
                  description: 通知体中的签名值。该字段本身不参与签名计算。请按签名指南使用 `X-Rh-Signature` 请求头验签。
                  x-onerway-signature-participation: signature-field
            examples:
              pre_dispute_default:
                summary: 拒付预警
                value:
                  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
      responses:
        "200":
          description: 受理通知后，返回 HTTP 200，并在响应体中原样返回收到的 `predisputeId`。不要添加 JSON
            引号、空白或换行。空响应或其他 ID 均不符合应答要求。发送失败或应答不符合要求时，Onerway 每 30 分钟重试，最多重试 2
            次。
          content:
            text/plain:
              schema:
                type: string
              examples:
                return_predispute_id:
                  summary: 返回 predisputeId
                  description: 原样返回收到的 `predisputeId`。请勿固定返回示例值。
                  value: example_predispute
```