> For the complete documentation index, see [llms.txt](https://startbutton.gitbook.io/startbutton-product-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://startbutton.gitbook.io/startbutton-product-api/webhooks/dispute-events.md).

# Dispute Events

### Supported events for Disputes:

1. dispute.created
2. dispute.declined
3. dispute.processed

We support 2 dispute type:- full value and partial value

{% tabs %}
{% tab title="dispute.created" %}

```json
{
  "event": "dispute.created",
  "data": {
    "transactionReference": "4237ed5bxxxx",
    "disputeReference": "DSHC-WCUDS6RYDI",
    "currency": "UGX",
    "amount": 120000,
    "elapseTime": "24",
    "type": "full",
    "customerEmail": "johndoe@startbutton.africa",
    "createdAt": "2025-10-17T10:48:45.131Z",
    "status": "initiated",
    "reason": "chargeback"
  }
}
```

{% endtab %}

{% tab title="dispute.processed" %}

```json
{
  "event": "dispute.processed",
  "data": {
    "transactionReference": "4237ed5bxxxx",
    "disputeReference": "DSHC-WCUDS6RYDI",
    "currency": "UGX",
    "amount": 120000,
    "type": "full",
    "customerEmail": "johndoe@startbutton.africa",
    "createdAt": "2025-10-17T10:56:51.767Z",
    "status": "processed",
    "reason": "chargeback"
  }
}
```

{% endtab %}

{% tab title="dispute.declined" %}

```json
{
  "event": "dispute.declined",
  "data": {
    "transactionReference": "4237ed5bxxxx",
    "disputeReference": "DSHC-WCUDS6RYDI",
    "currency": "UGX",
    "amount": 120000,
    "type": "full",
    "customerEmail": "johndoe@startbutton.africa",
    "createdAt": "2025-10-17T10:56:51.767Z",
    "status": "declined",
    "reason": "chargeback"
  }
}
```

{% endtab %}
{% endtabs %}