Skip to content
Coritan Docs

Follow payment disputes

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

View as Markdown

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.

You need the owner, admin or billing role.

  1. In the dashboard, 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. With the Own gateway billing mode, your own PayNow store takes the chargeback.

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 tab, and answer the customer's conversations in the support inbox: a record that the customer used the service helps the case.

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

Shell
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 operations on this page

MethodPathWhat it does
GET/api/v1/orgs/{org_slug}/disputesChargebacks raised against this org's customers
GET/api/v1/orgs/{org_slug}/disputes/{dispute_id}Get org dispute