Skip to main content
GET
Get dispute

Authorizations

​
Authorization
string
header
required

API key as Bearer token

Headers

​
Reap-Version
enum<string>
required

API version (YYYY-MM-DD)

Available options:
2025-02-14
Example:

"2025-02-14"

Path Parameters

​
id
string<uuid>
required

Card dispute ID

Response

Card dispute resource

​
id
string<uuid>
required

Unique dispute identifier

​
transactionId
string<uuid>
required

The card transaction being disputed

​
cardId
string<uuid>
required

Card used for the disputed transaction

​
status
enum<string>
required

Current dispute status

Available options:
PENDING_SIGNATURE,
RECEIVED,
REVIEWING,
SUBMITTED,
WON,
LOST,
REFUNDED,
DECLINED,
CANCELED
Example:

"PENDING_SIGNATURE"

​
reason
enum<string>
required

Why the cardholder is disputing the transaction

Available options:
FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT,
FRAUD_EMV_LIABILITY_SHIFT_NON_COUNTERFEIT,
FRAUD_OTHER_CARD_PRESENT,
FRAUD_OTHER_CARD_ABSENT,
FRAUD_VISA_MONITORING_PROGRAM,
AUTHORIZATION_CARD_RECOVERY_BULLETIN,
AUTHORIZATION_DECLINED,
AUTHORIZATION_NO_AUTH_LATE_PRESENTMENT,
PROCESSING_ERROR_INCORRECT_TRANSACTION_CODE,
PROCESSING_ERROR_INCORRECT_CURRENCY,
PROCESSING_ERROR_INCORRECT_ACCOUNT_NUMBER,
PROCESSING_ERROR_INCORRECT_AMOUNT,
PROCESSING_ERROR_DUPLICATE_PROCESSING,
PROCESSING_ERROR_INVALID_DATA,
CONSUMER_MERCHANDISE_NOT_RECEIVED,
CONSUMER_CANCELLED_RECURRING,
CONSUMER_NOT_AS_DESCRIBED,
CONSUMER_COUNTERFEIT_MERCHANDISE,
CONSUMER_MISREPRESENTATION,
CONSUMER_CREDIT_NOT_PROCESSED,
CONSUMER_CANCELLED_MERCHANDISE,
CONSUMER_ORIGINAL_CREDIT_NOT_ACCEPTED,
CONSUMER_NON_RECEIPT_CASH_ATM
Example:

"FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT"

​
category
enum<string>
required

The grouping the reason belongs to

Available options:
FRAUD,
AUTHORIZATION,
PROCESSING_ERROR,
CONSUMER
Example:

"FRAUD"

​
requiresCardholderSignature
boolean
required

Whether the cardholder must sign a form before the case can progress

​
amount
object
required

The amount under dispute, which may be less than the transaction total

​
cardholder
object
required

Cardholder identity on the case

​
resolvedAt
string<date-time> | null
required

When the dispute reached a final status, or null while open

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
​
createdAt
string<date-time>
required

ISO 8601 timestamp of creation

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
​
updatedAt
string<date-time>
required

ISO 8601 timestamp of last update

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$