> For the complete documentation index, see [llms.txt](https://squadinc.gitbook.io/squad-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://squadinc.gitbook.io/squad-api-documentation/disputes-and-chargebacks.md).

# Disputes & Chargebacks

{% hint style="danger" %}
**This documentation site has been deprecated as of September 8, 2025, and will no longer receive updates. Please refer to the new documentation site at** [**https://docs.squadco.com**](https://docs.squadco.com)**.**
{% endhint %}

\
You have the option to either accept or reject a chargeback

### Accepting a chargeback:  

This means you received the customer’s payment but did not provide the service or product the customer requested for some reasons. When you accept a chargeback, you allow for the funds to be deducted from your payouts and reversed to the customer’s bank account.<br>

### Rejecting a chargeback:&#x20;

This means you received the customer’s payment and have provided the service or delivered the product to the customer.  To justify your claim you are required to provide an evidence to show that value has been given for payment made by the customer. If the evidence is not sufficient, we will automatically accept the chargeback.

{% hint style="warning" %}
**Authorization** Any request made without the authorization key (private/secret key) will fail with a **`401`**` ``(Unauthorized)` response code.
{% endhint %}

{% hint style="info" %}
**The authorization key is sent via the request header as Bearer Token Authorization**
{% endhint %}

**Example:**\
Authorizatio&#x6E;**:** Bearer sandbox\_sk\_94f2b798466408ef4d19e848ee1a4d1a3e93f104046f<br>

## GET ALL DISPUTES

This API is used to get all disputes on your transactions raised by your customers.

## All you need to do is  make a get request with your private/secret key

<mark style="color:blue;">`GET`</mark> `https://sandbox-api-d.squadco.com/dispute`

{% tabs %}
{% tab title="200: OK Success" %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="401: Unauthorized No API key" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

## Get Upload URL

This API is used to get a unique URL to upload an evidence(file) which is a proof or reason to reject a dispute. This is only necessary when we want to reject a dispute.

## All you need to do is  make a get request with your private/secret key

<mark style="color:blue;">`GET`</mark> `https://sandbox-api-d.squadco.com/dispute/upload-url/:ticket_id/:file_name`

#### Path Parameters

| Name                                         | Type   | Description |
| -------------------------------------------- | ------ | ----------- |
| ticket\_id<mark style="color:red;">\*</mark> | String |             |
| file\_name<mark style="color:red;">\*</mark> | String |             |

## Resolve Disputes

This API is used to resolve a dispute by either accepting or rejecting it.<br>

## This API is used to resolve a dispute by either accepting or rejecting it.&#x20;

<mark style="color:blue;">`GET`</mark> `https://sandbox-api-d.squadco.com/dispute/:ticked_id/resolve`

#### Path Parameters

| Name                                         | Type   | Description                                                          |
| -------------------------------------------- | ------ | -------------------------------------------------------------------- |
| ticket\_id<mark style="color:red;">\*</mark> | String | A unique ID that identifies the dispute you want to reject or accept |

#### Request Body

| Name                                     | Type   | Description                                                                                                                    |
| ---------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| file\_name                               | String | The name of the file uploaded                                                                                                  |
| action<mark style="color:red;">\*</mark> | String | This is the action you want to be taken on the raised dispute. The value of this action can be either "rejected" or "accepted" |

### GO LIVE - Production

To Use this API on production:

1. &#x20;Kindly change the base URL of the endpoint from sandbox-api-d.squadco.com to api-d.squadco.com
2. Get production keys from your production environment on dashboard.squadco.com and replace as authorization keys.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://squadinc.gitbook.io/squad-api-documentation/disputes-and-chargebacks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.