Create a dispute for a transaction
POST/v1/card/transactions/:transactionId/disputes
The transaction must have POSTED — an authorization that has not settled cannot be disputed and answers 422. Only one dispute can be open per transaction at a time; a second answers 409. Once a dispute reaches a terminal status a new one may be filed on the same transaction.
The issuer does not file every dispute with the card network: disputes of $10 or under are not filed or reimbursed, and from 2026-09-01 disputes under $30 are not filed while each dispute of $30 or more escalated to the network carries a fee whatever the outcome. A small dispute is accepted here and goes no further.
Request
Responses
- 201
- 401
Created successfully
Missing, malformed, unknown, or revoked partner API key.