# Follow payment disputes

> See the chargebacks your customers have opened, how much is at stake and the date evidence is due.

Source: https://docs.coritan.com/organizations/billing/disputes/

In the dashboard:

- /dashboard/organizations/…/billing/disputes: https://www.coritan.com/dashboard/organizations

A dispute, or chargeback, is a customer asking their bank or payment provider to reverse a payment. The **Disputes** section of the **Billing** tab lists the disputes raised against payments from your customers, how much each one puts at stake and when evidence is due. Coritan prepares and submits the evidence, so this page is for following a case, not for answering it.

## Before you begin

You need the owner, admin or billing role.

## Follow a dispute

1. In the [dashboard](https://www.coritan.com/dashboard/organizations), open the organization, then **Billing**, then **Disputes**.
2. Each row shows the dispute's reference, its status, the customer, the **Amount**, the **Reason** and the date to **Respond by**.
3. Select a dispute to open it.

The dispute shows its **Status**, **Customer**, **Amount**, **Reason**, **Outcome**, the state of the **Evidence**, when it was **Submitted**, the **Invoice** it concerns and when it was **Opened**. When Coritan has drafted evidence, a box says whether the draft is strong or weak, and which facts it is missing.

A won dispute keeps the payment. A lost one reverses it, and a reversed payment comes off your next [payout](/organizations/billing/payouts/). With the **Own gateway** billing mode, your own PayNow store takes the chargeback.

## Help Coritan win a dispute

Evidence comes from what Coritan knows about the customer and the service, so a strong draft depends on the facts being there. Keep the customer's details correct on the [Customers](/organizations/customers/) tab, and answer the customer's conversations in the [support inbox](/organizations/staff-console/support-inbox/): a record that the customer used the service helps the case.

## Related

- [Organization billing](/organizations/billing/)
- [Manage customer invoices](/organizations/billing/invoices/)

## With the API

List disputes, newest first, with `limit` (up to 200) and `offset`:

```bash
curl https://api.coritan.com/api/v1/orgs/acme/disputes \
  -H "Authorization: Bearer $CORITAN_TOKEN"
```

The answer is `{"disputes": [...]}`. Each dispute has `id`, `gateway`, `gateway_dispute_id`, `amount`, `currency`, `status`, `reason`, `outcome`, `evidence_state`, `evidence_due_at`, `submitted_at`, `customer_id`, `org_invoice_id` and `created_at`. `GET /disputes/{dispute_id}` adds `evidence`, with the draft's `reason`, `is_strong`, `missing` and `generated_at`. The draft's contents stay with Coritan.

## API

- `GET /api/v1/orgs/{org_slug}/disputes`: Chargebacks raised against this org's customers (https://docs.coritan.com/api/reference/organizations/billing-payouts/disputes/#op-get-api-v1-orgs-org-slug-disputes)
- `GET /api/v1/orgs/{org_slug}/disputes/{dispute_id}`: Get org dispute (https://docs.coritan.com/api/reference/organizations/billing-payouts/disputes/#op-get-api-v1-orgs-org-slug-disputes-dispute-id)