Dispute

The amount under dispute, in the currency's basic units.

The Acquirer Reference Number (ARN) is the acquirer's reference for the disputed transaction. It must match the ARN provided on the disputed transaction. If the ARN is not available then you must provide the transactionId or gateway reference.

Minimum length: 1.

Maximum length: 300.

Category mapped to the one given by the cardholder for disputing the transaction.

One of: DUPLICATE, PRODUCT_NOT_RECEIVED, SUBSCRIPTION_CANCELLED, PRODUCT_UNACCEPTABLE, CREDIT_NOT_PROCESSED, GENERAL, FRAUDULENT, or UNRECOGNISED.

The currency of the amount of this dispute, as an ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

A unique reference for the dispute.

Minimum length: 1.

Maximum length: 300.

Time at which the dispute was created, used for reporting. A unix timestamp preferably as an integer count of milliseconds since 1970-01-01T00:00 UTC (nanoseconds are also accepted).

The gateway responsible for processing the disputed transaction.

Pattern: ^[a-zA-Z0-9]*$

The gateway reference value provided on the disputed transaction. If the gateway reference is not available then you must provide the transactionId or ARN.

Minimum length: 1.

Maximum length: 300.

Whether liability for this dispute was shifted to the issuer.

Outcome of the dispute. Use ACCEPTED for disputes you have accepted and decided not to defend, WON for disputes you have successfully defended, EXPIRED for disputes that have timed out and LOST for disputes ruled in favour of the cardholder. Omit outcome if the dispute is still open.

One of: ACCEPTED, WON, LOST, or EXPIRED.

The human-readable text description or message associated with the dispute. Example: Other Fraud - Card Absent Environment

The raw, specific dispute reason code provided directly by the card scheme (e.g., 1040 or 12.6.1)

Maximum length: 100.

Stage of the dispute. A dispute with the stage EARLY_FRAUD_WARNING or REQUEST_FOR_INFORMATION is not considered a chargeback for reporting purposes.

One of: EARLY_FRAUD_WARNING, REQUEST_FOR_INFORMATION, NOTIFICATION_OF_CHARGEBACK, CHARGEBACK, SECOND_CHARGEBACK, CHARGEBACK_REVERSED, PREARBITRATION, or ARBITRATION.

Identifier for the disputed transaction. Must match the transactionId provided on the disputed transaction. If the transactionId is not available then you must provide the gateway reference or ARN.

Minimum length: 1.

Maximum length: 300.

Warnings when the data in the request contained issues.