Disputes

Track alerts, chargebacks, and dispute outcomes.

Read-only access to disputes: pre-chargeback alerts (Ethoca, CDRN, Visa RDR), chargebacks, TC40 fraud reports, ACH returns, and reversals. Disputes are sandbox-aware. Acting on a dispute — refunding an alert, fighting a chargeback with evidence, accepting — happens in the Paysio dashboard. The dispute.created, dispute.updated, dispute.evidence_submitted, dispute.won, and dispute.lost events track the lifecycle in real time — see Webhooks.

List disputes

List disputes, sorted by most recent.

GEThttps://paysio.com/api/v1/disputes

Authorizations

Authorizationstringheaderrequired

Any API key. Prepend your key with Bearer, e.g. Bearer sk_test_your_secret_key.

Query parameters

limitinteger

1-100, default 10

starting_afterstring

Cursor for pagination

statusstring

Filter by status: new, matched, unmatched, refunded, accepted, fighting, response_submitted, won, lost, expired. Comma-separate for multiple values.

kindstring

Filter by kind: alert_ethoca, alert_cdrn, alert_rdr, chargeback, tc40, ach_return, reversal. Comma-separate for multiple values.

transaction_idstring

Disputes raised against one transaction

Example request — cURL

curl -X GET https://paysio.com/api/v1/disputes \
  -H "Authorization: Bearer sk_test_your_secret_key"

Example request — JavaScript

const res = await fetch("https://paysio.com/api/v1/disputes", {
  method: "GET",
  headers: {
    "Authorization": "Bearer sk_test_your_secret_key"
  },
})
const data = await res.json()

Example response (200)

{
  "data": [
    {
    "id": "dsp_9c2f4b1e-7a3d-4e88-b2c1-5f6a7d8e9b0c",
    "object": "dispute",
    "kind": "chargeback",
    "status": "fighting",
    "transaction_id": "txn_6b1e0d3a-9f7c-4d21-8a54-2c3b1e0f9a8d",
    "network": "visa",
    "reason": "Fraud — card absent environment",
    "reason_code": "10.4",
    "amount": 2999,
    "currency": "USD",
    "card_bin": "424242",
    "card_last4": "4242",
    "due_at": "2026-02-01T00:00:00.000Z",
    "alerted_at": "2026-01-18T09:14:03.120Z",
    "response_submitted": false,
    "sandbox": false,
    "created_at": "2026-01-18T09:14:03.120Z",
    "updated_at": "2026-01-21T16:40:12.512Z"
  }
  ],
  "has_more": false
}

Example response (400)

{
  "error": "Invalid request parameters",
  "type": "invalid_request_error",
  "code": "parameter_invalid"
}

Example response (401)

{
  "error": "Invalid API key provided",
  "type": "authentication_error",
  "code": "api_key_invalid"
}

Example response (429)

{
  "error": "Too many requests",
  "type": "rate_limit_error",
  "code": "rate_limited"
}

Retrieve a dispute

Retrieve a single dispute. The dispute object is returned at the top level (no data wrapper) with an extra events array — the case timeline, newest first. Event types include created, matched, refunded, outcome_sent, accepted, fight_started, evidence_submitted, represented, won, and lost.

GEThttps://paysio.com/api/v1/disputes/:id