Availability
No new clients will be set up with Dispute API 2.0. Legacy clients will eventually be migrated to Dispute API 3.0.
Use the Create Case endpoint to initiate a dispute claim. A single claim may contain multiple disputed transactions. Call this endpoint when the account holder initiates a claim by clicking a "dispute a transaction" control on your interface.
This endpoint returns a case number (caseId) that you pass with all subsequent endpoint calls that are related to this dispute.
This endpoint is part of a conversational API—a series of endpoint calls that must be made in a certain order. For instructions see the Creating an API 2.0 Dispute guide.
- Next endpoint: Get Case Reasons
Status codes
See Global Response Statuses for status codes that are common across endpoints.
The table below lists status codes that apply to this specific endpoint.
| Status code | Description |
|---|---|
| 1502-1 | Invalid customer ID |
| 1502-2 | Invalid case ID or case ID returned no results |
| 1502-3 | Error creating case |
| 1502-5 | Invalid request {message} |
| 1502-13 | Case ID references a case that is currently locked |
| 1502-14 | Invalid request message |