---
title: "Transaction disputes update"
method: POST
path: "transaction-disputes#update"
tags: ["webhook-event", "disputes"]
---

# Transaction disputes update

`POST transaction-disputes#update` (webhook)

Triggered every time a transaction dispute is submitted or updated.

You may receive update events even when there are no apparent changes in the dispute `status` or `subStatus`, as certain underlying modifications might not directly impact these visible indicators.

* Event type: `transaction-disputes#update`
* Profile level subscriptions: Not Supported
* Application level subscriptions: Supported

Events may not be delivered in the order they occurred. Use `data.occurred_at` to reconcile the order.
See the [Event ordering guide](/guides/developer/webhooks/event-ordering) for details.

See the [Webhooks guide](/guides/developer/webhooks) for setup instructions, signature verification, and best practices.

## Headers

- `X-Signature-SHA256` string
- `X-Delivery-Id` string, uuid
- `X-Test-Notification` boolean

## Payload

- union
  - V40026
    - `schema_version` '4.0.0' — Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook).
    - `subscription_id` string, uuid — ID of the webhook subscription that triggered this event.
    - `event_type` string — Event type identifier
    - `sent_at` string, date-time — Timestamp when the event was sent.
    - `data` object
      - `resource` object
        - `id` string — Unique ID of the dispute.
        - `profile_id` integer — ID of the profile that owns the card.
        - `transaction_id` integer — ID of the card transaction.
        - `type` string — Resource type (always `transaction-dispute`).
      - `reason` string — Dispute reason. See [dispute reason](/api-reference/disputes/disputereasonsget) for all possible values.
      - `status` 'ACTIVE' | 'CLOSED' — Dispute overall status
      - `sub_status` string — Dispute detailed status. See [dispute sub-status](/api-reference/disputes#dispute-sub-status) for all possible values.
      - `status_message` string — Explanation for `subStatus`.
      - `created_at` string, date-time — Time when the dispute was created.
      - `created_by` string — Creator of the dispute. Currently set to the user id.
      - `can_withdraw` boolean — Whether the dispute can be withdrawn.
      - `occurred_at` string, date-time — When the dispute updates occurred.
  - V20023
    - `schema_version` '2.0.0' — Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook).
    - `subscription_id` string, uuid — ID of the webhook subscription that triggered this event
    - `event_type` string — Event type identifier
    - `sent_at` string, date-time — Timestamp when the event was sent
    - `data` object
      - `resource` object
        - `id` string — Unique ID of the dispute
        - `profile_id` integer — ID of the profile that owns the card
        - `transaction_id` integer — ID of the card transaction
        - `type` string — Resource type (always `transaction-dispute`)
      - `reason` string — Dispute reason, you can find all the possible values [here](/api-reference/disputes/disputereasonsget)
      - `status` 'ACTIVE' | 'CLOSED' — Dispute overall status
      - `sub_status` string — Dispute detailed status, you can find all the possible values [here](/api-reference/disputes#dispute-sub-status)
      - `status_message` string — Explanation for subStatus
      - `created_at` string, date-time — Time when the dispute was created
      - `created_by` string — Creator of the dispute, it is currently set to the user id
      - `can_withdraw` boolean — Whether the dispute can be withdrawn
      - `occurred_at` string, date-time — When the dispute updates occurred

## Acknowledgement `200`

Return any `2xx` status to acknowledge receipt of the event.

- object
  - `status` string

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/4907a1d269ab/schema)