A dispute is a customer-initiated challenge of a payment through their payment service provider (PSP) or bank.
Date and time at which the dispute was accepted.
List of actions that can be performed on the dispute. Each action has a specific due date by which it must be completed. Available actions depend on the dispute's current status and stage.
Disputed amount in the currency's main units. For example, "12.95" for $12.95.
Whether the dispute was automatically defended by the payment processor.
Channel through which the dispute is being processed.
ID of the charge that is being disputed.
Date and time the dispute was created.
Three-letter currency code in ISO-4217 alphabetic format. Matches the currency of the disputed charge.
Whether the dispute can be defended with evidence.
Date and time at which the dispute was defended.
The latest date and time until which the dispute can remain in its current status.
If this date passes, the dispute will be resolved against the party that is required to take action. For example, if the status is WAITING_MERCHANT, and the due date passes, the dispute will be LOST and a refund will be processed automatically.
Custom field data for the dispute object.
Extended fields must be configured in the app dashboard before they can be accessed with API calls.
Dispute ID.
Network reason code provided by the card network or issuing bank that initiated the dispute.
Unique identifier assigned by the payment service provider for this dispute.
Reason why the customer initiated the dispute.
Revision number, which increments by 1 each time the dispute is updated. To prevent conflicting changes, the current revision must be passed when updating the dispute. Ignored when creating a dispute.
Level of seller protection coverage for this dispute.
Seller protection is set by the payment provider. For example, PayPal offers a seller protection program.
Stage of the dispute process.
Current status of the dispute. This indicates what action is required and who needs to take it.
Tags assigned to the dispute for organization and filtering purposes.
Date and time the dispute was updated.