Sign in

v1

latestOpenAPI 3.0.02026-08-0696238481.7 KB
Disputes

List disputes

Used to fetch a paginated list of disputes

get/disputes

Query parameters

startTimestampinteger
Example:1641859200

The start timestamp (inclusive), it must be before the endTimestamp.

endTimestampinteger
Example:1641945599

The timestamp when to return payment sessions up to (inclusive), it must be after the startTimestamp.

ascendingboolean

Control the order (newest or oldest) in which the disputes are returned. false will arrange the results with newest first, whereas true shows oldest first. The default is false.

limitinteger
Example:10

Control how many items are return in a given page The max limit we allow is 25. The default is 10.

startsAfterstring
Example:dsp_01FCTS1XMKH9FF43CAFA4CXT3P_1641912473

A token to identify where to resume a subsequent paginated query. The value of the paginationToken field from that response should be supplied here, to retrieve the next page of results for that timestamp range.

Response

Successfully retrieved the disputes

paginationTokenstring nullable

A token to use for getting the next page of results - send the same request with this value in the 'paginationToken' query parameter. This field is null when there are no further items to return

Example response

{
  "items": [
    {
      "id": "dsp_01G0EYVFR02KBBVE2YWQ8AKMGJ",
      "amount": 500,
      "currency": "GBP",
      "status": "Open",
      "category": "Fraudulent",
      "reason": {
        "code": "13.6",
        "description": "Merchandise/Services Not Received"
      },
      "respondBy": 1685059200,
      "paymentSession": {
        "id": "ps_01G0EYVFR02KBBVE2YWQ8AKMGJ",
        "paymentType": "Standard",
        "paymentMethod": {
          "card": {
            "scheme": "Mastercard",
            "last4": "4444"
          }
        }
      },
      "evidence": {
        "files": {
          "proofOfDelivery": {
            "id": "fl_01G0EYVFR02KBBVE2YWQ8AKMGJ"
          },
          "customerSignature": {
            "id": "fl_01G0EYVFR02KBBVE2YWQ8AKMGJ"
          },
          "receipt": {
            "id": "fl_01G0EYVFR02KBBVE2YWQ8AKMGJ"
          },
          "shippingConfirmation": {
            "id": "fl_01G0EYVFR02KBBVE2YWQ8AKMGJ"
          },
          "customerCommunication": {
            "id": "fl_01G0EYVFR02KBBVE2YWQ8AKMGJ"
          },
          "refundPolicy": {
            "id": "fl_01G0EYVFR02KBBVE2YWQ8AKMGJ"
          },
          "recurringPaymentAgreement": {
            "id": "fl_01G0EYVFR02KBBVE2YWQ8AKMGJ"
          },
          "uncategorised": {
            "id": "fl_01G0EYVFR02KBBVE2YWQ8AKMGJ"
          }
        }
      },
      "customer": {
        "email": "john.doe@ryftpay.com",
        "id": "cus_01G0EYVFR02KBBVE2YWQ8AKMGJ",
        "createdTimestamp": 1470989538
      },
      "subAccount": {
        "id": "ac_3fe8398f-8cdb-43a3-9be2-806c4f84c327"
      },
      "createdTimestamp": 1470989538,
      "lastUpdatedTimestamp": 1470989538
    }
  ],
  "paginationToken": "dsp_01FCTS1XMKH9FF43CAFA4CXT3P_1641912473"
}