---
title: "Issuing Dispute Updated Webhook"
source_url: https://docs.rapyd.net/en/issuing-dispute-updated-webhook.html
lang: en
---

# Issuing Dispute Updated Webhook

The **ISSUING_DISPUTE_UPDATED** webhook is sent when the status of a dispute changes on a card issued through Rapyd.

> **Note:**
>
> The endpoint for webhooks is unique for each client. To set up a webhook endpoint, see [Defining a Webhook Endpoint](https://docs.rapyd.net/en/defining-a-webhook-endpoint.md "Defining a Webhook Endpoint").

### Parameters

### Webhook Header Parameters

- - Content-Type
  - Indicates that the data appears in JSON format. Set to **application/json**.
- - salt
  - Random string.
- - signature
  - Signature calculated for each webhook individually.

    See [Webhook Authentication](https://docs.rapyd.net/en/webhook-authentication.md "Webhook Authentication").
- - timestamp
  - Timestamp for the webhook, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time") (seconds).

### Webhook Root Parameters

- - created_at
  - Time that the webhook was created, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time").

    > **Note:**
    >
    > Inside the `data` object, some webhooks have another `created_at` field that refers to a different event.
- - data
  - Contains the actual data of the webhook.

    For details, see below.
- - extended_timestamp
  - Time in milliseconds that the webhook was created, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time").
- - id
  - ID of the webhook. String starting with **wh_**.
- - status
  - Status of the webhook. One of the following:

    - **NEW**
    - **CLO** - Closed.
    - **ERR** - Error.
    - **RET** - Re-sent.

    > **Note:**
    >
    > Inside the `data` object, some webhooks have another `status` field that refers to a different event.
- - trigger_operation_id
  - ID of the operation that triggered the webhook. UUID.
- - type
  - Name of the webhook type.

    > **Note:**
    >
    > The name in the Client Portal is different.

### Webhook Data Parameters

- - token
  - ID of the dispute. String starting with **dispute_**.
- - amount
  - Amount that Rapyd deducted from the merchant due to the dispute.
- - arn
  - Acquirer Reference Number (ARN). A unique identifier assigned to the transaction as it moves through the card network. Returns `null` when not available.
- - central_processing_date
  - The date the transaction was processed by the card network.
- - created_at
  - Time of creation of the dispute, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time").
- - currency
  - Three-letter ISO 4217 code for the currency used in the `amount` field.
- - dispute_category
  - The category of dispute that was provided by the card network.
- - dispute_reason_description
  - A short description of the reason for the dispute.
- - due_date
  - The latest date for the dispute to be contested, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time").
- - evidence
  - Reserved.
- - evidence_reason_code
  - Reserved.
- - ewallet_id
  - ID of the wallet that the money is paid into. String starting with **ewallet_**. Relevant when the request includes a single wallet.
- - id
  - Reserved.
- - original_dispute_amount
  - Amount of the dispute, as reported to Rapyd. For issuing disputes, this value is mapped to the same value as `amount`.
- - original_dispute_currency
  - Currency of the disputed payment. Three-letter ISO 4217 code. For issuing disputes, this value is mapped to the same value as `currency`.
- - original_transaction_amount
  - Amount of the original payment.
- - original_transaction_currency
  - Currency of the `original_transaction_amount`. Three-letter ISO 4217 code.
- - original_transaction_id
  - ID of the card authorization that the dispute is charged against. String starting with **cardauth_**.
- - rate
  - FX rate. Relevant to FX payments.
- - status
  - Indicates the status of the dispute operation. One of the following values:

    - **ACT** (Active) - The dispute was initiated and is awaiting action by the merchant.
    - **RVW** (Review) - Rapyd is reviewing the merchant's evidence contesting the dispute.
    - **PRA** (Pre-Arbitration) - The card issuer challenged a previously contested dispute. The dispute is being reviewed.
    - **ARB** (Arbitration) - The merchant rejected a pre-arbitration outcome. Rapyd is awaiting a ruling by an arbitration committee of the card schemes.
    - **LOS** (Loss) - The merchant lost the dispute. Funds were deducted from the merchant wallet.
    - **WIN** (Win) - The merchant won the dispute. Funds were credited to the merchant wallet.
    - **REV** (Reverse) - The card issuer reversed the dispute. Funds were credited to the merchant wallet. Final status.
- - updated_at
  - Time that the dispute was last updated, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time").

- ISSUING_DISPUTE_UPDATED Webhook
- ```json
  {
      "id": "wh_6c28f89408ea91d710ee8954ddac31fb",
      "data": {
          "id": "5ea10461-9eaa-4134-8d97-8d6ad0301954",
          "arn": null,
          "rate": 1,
          "token": "dispute_ed8e5cde9f5843a0009eb38336f1873c",
          "amount": 15,
          "status": "ACT",
          "currency": "USD",
          "due_date": 1694917992,
          "evidence": null,
          "created_at": 1691461992,
          "ewallet_id": "ewallet_d8c1d858c3a7d5dfab1cf4a422555fcc",
          "updated_at": 1691461992,
          "dispute_category": "Authorization",
          "evidence_reason_code": null,
          "central_processing_date": null,
          "original_dispute_amount": 15,
          "original_transaction_id": "cardauth_a509d6808e1a961da1da0053cfd6d21a",
          "original_dispute_currency": "USD",
          "dispute_reason_description": "",
          "original_transaction_amount": 20,
          "original_transaction_currency": "USD"
      },
      "type": "ISSUING_DISPUTE_UPDATED",
      "status": "NEW",
      "created_at": 1691461992,
      "extended_timestamp": 1691461992394,
      "trigger_operation_id": "d092d957-c3cb-4071-bc72-0d1626ba0323"
  }
  ```
