Disputes

Retrieves one payment dispute with its timeline. Requires the Scale plan.

get/v1/shops/{shopId}/disputes/{disputeId}

Request

Response

Example response

{
  "dispute": {
    "id": 1,
    "shop_id": 1,
    "invoice_id": 1,
    "payment_id": null,
    "payment_method_id": null,
    "gateway": "STRIPE",
    "gateway_dispute_id": "du_1QExampleDispute",
    "gateway_payment_ref": "pi_3QExamplePaymentIntent",
    "stage": "chargeback",
    "status": "needs_response",
    "is_final": false,
    "funds_status": "withdrawn",
    "reason": "fraudulent",
    "contestable": true,
    "gateway_status": "needs_response",
    "gateway_substatus": null,
    "gateway_reason": "fraudulent",
    "network_reason_code": "10.4",
    "card_brand": "visa",
    "amount": "14.99",
    "currency": "USD",
    "amount_usd": "14.99",
    "fee": "15.00",
    "fee_currency": "USD",
    "fee_usd": "15.00",
    "is_partial": false,
    "evidence_due_at": "2026-11-03T20:00:52.000000Z",
    "opened_at": "2026-11-01T20:00:52.000000Z",
    "responded_at": null,
    "closed_at": null,
    "gateway_updated_at": "2026-11-01T20:00:52.000000Z",
    "gateway_version": null,
    "fetched": true,
    "invoice_status_before": null,
    "invoice_flipped_at": null,
    "livemode": true,
    "created_at": "2026-11-01T20:00:52.000000Z",
    "updated_at": "2026-11-01T20:00:52.000000Z",
    "invoice": {
      "id": 1,
      "salt": "667e99ffee7e5",
      "shop_id": 1,
      "email": "customer@sellauth.test",
      "price": "14.99",
      "currency": "USD",
      "status": "completed",
      "gateway": "STRIPE",
      "ip": "127.0.0.1",
      "country_code": null,
      "created_at": "2026-11-01T20:00:51.000000Z",
      "completed_at": "2026-11-01T20:00:51.000000Z",
      "unique_id": "667e99ffee7e5-0000000000001"
    },
    "payment_method": null
  },
  "timeline": [
    {
      "id": 1,
      "type": "dispute_opened",
      "actor": "gateway",
      "data": {
        "stage": "chargeback",
        "amount": "14.99",
        "reason": "fraudulent",
        "status": "needs_response",
        "gateway": "STRIPE",
        "currency": "USD",
        "dispute_id": 1,
        "evidence_due_at": "2026-11-03T20:00:52+00:00"
      },
      "created_at": "2026-11-01T20:00:52.000000Z"
    }
  ],
  "actions": {
    "cashback_usd": 0,
    "affiliate_commission_usd": 0,
    "is_topup": false,
    "can_reclassify": false,
    "buyer": {
      "email": "customer@sellauth.test",
      "ip": "127.0.0.1"
    },
    "blacklisted": {
      "email": false,
      "ip": false
    },
    "subscription": null
  }
}

Changes

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • info

      endpoint added