List disputes

get

https://prod.emea.api.fiservapps.com/sandbox/exp/v1/disputes

Search for Disputes.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📘
List disputes
The list disputes response returns disputes with status 'OPEN' by default. In order to define the status in the response please follow the instruction for 'status' query parameter in the specification below

Query Params

acquirerReferenceNumber

string

length between 23 and 24

Find disputes using the Acquirer Reference Number linked to the original transaction.

from

date

Filter Disputes from a certain date when the dispute was first created. Format YYYY-MM-DD.

date

Filter Disputes to a certain date when the dispute was first created. Format YYYY-MM-DD.

limit

int32

1 to 100

Defaults to 20

Number of elements to be returned in a single query. Can be used for page/offset or cursor based pagination

offset

int32

0 to 2147483647

Starting point to start retrieving the elements from. It is "0" based i.e. value "0" signifies the first page. This can be used with "limit". Can be used for page/offset based pagination.

visaId

string

length between 0 and 20

Filter Disputes by Visa Resolve Online Id number

mastercardId

string

length between 0 and 19

Filter Disputes by MasterCard's Claim Manager ID

orderId

string

Filter Disputes by a Merchant Transaction Reference (Order ID)

status

string

enum

Defaults to OPEN

Open cases are those awaiting an action. In Progress cases are where an action was taken and need to be submitted to the scheme or cases that are waiting if the issuer will continue to dispute the transaction. Closed cases have no further action that can be taken by the issuer or acquirer

Allowed:

sort

string

Defines how to sort the records returned. Must be specified in the syntax "+" (ascending) or "-" (descending) followed by the field name. For example: "+posted" would sort by the "posted" field ascending.

merchantId

string

length between 0 and 20

Filter disputes by Merchant Id.

stage

array

Filter Disputes by stage. For a full list of stage code descriptions, please see the disputes stages guide

stage

Headers

Institution-Number

string

length between 8 and 8

Institution number (8-digit number) associated with the merchant. This information defines the acquirer for the merchant. If a consumer is granted access to this API for multiple institutions, this field must be populated. If access is for only one institution, the API will automatically determine this value, making it optional for the client.

Responses

📘List disputes

200OK

400Bad request

401Unauthorised

403Forbidden

404Not found

429Too many requests

500Internal server error

API Products

Point of Sale

Developer

Resources

📘
List disputes