COMING SOON

Dispute Object

The Dispute object represents a dispute that has been logged for an issued card. A dispute can be logged against one or more transactions.

Attributes

disputeType

string enum, values: UNAUTHORIZED, MERCHANT_DISPUTE

Type of dispute. The following values are supported:

UNAUTHORIZED Cardholder has reported unauthorized transactions on the card.
MERCHANT_DISPUTE Carholder has reported an issue with the merchant (such as an incorrect charge or merchandise not received).

disputeDescription

string

Details about the dispute.

disputedTransactions

array

List of disputed transactions.

transactionId

string (UUID)

ID of the disputed transaction.

disputeAmount

string (currency)

Disputed amount. This should be less than the transaction amount.

disputeReason

string enum

Reason for the transaction dispute. The following values are supported.

Unauthorized Transactions (disputeType = UNAUTHORIZED)
Value	Description
CHARGE_WITHOUT_CONSENT	Charge without consent.
UN_AUTH_ATM_WITHDRAWAL	Unauthorized ATM withdrawal.
UN_AUTH_ONLINE_PURCHASE	Unauthorized online purchase.
UN_AUTH_POS_TXN	Unauthorized point of sale (POS) transaction.
UN_CHARGE_AFTER_SUB_CANCELLED	Charge after subscription cancellation.

Merchant Disputes (disputeType = MERCHANT_DISPUTE)
Value	Description
ATM_REQ_NOT_FULFILLED	ATM request was not fulfilled.
CHARGE_AFTER_SUB_CANCELLED	Charge after subscription cancelled.
CREDIT_SLIP_CHARGE_APPLIED	Received credit slip but charge was applied to the account.
CREDIT_SLIP_CHARGE_NOT_APPLIED	Received credit slip but charge has not been applied to the account yet.
DISPUTE_ON_ENTIRE_CHARGE	Dispute on the entire charge or a portion of the charge.
DOLLAR_AMT_SALE_INCR	Dollar amount sale was increased.
DUP_TRANSACTION	Duplicate transaction.
ENCLOSING_EXPLANATION	Enclosing explanation or did not receive merchandise or service.
HOTEL_RESERVE_CANCEL	Canceled hotel reservation.
MERCH_NOT_RECEIVED	Merchandise was not received.
MERCH_RETURNED	Merchandise was returned.
OTHERS	Other reasons.
PAID_BY_OTR_MEANS	Paid by other means.
RECEIVED_CANCEL_NUMBER	Received cancellation number.

financialAccountId

string (UUID)

ID of the integrated Financial Account. The issued card is linked to this Financial Account.

disputeCasenumber

string

Unique case number assigned to the dispute.

Dispute Object

				
					{
  "disputeType": "UNAUTHORIZED",
  "disputeDescription": "Transaction not made by the cardholder",
  "disputedTransactions": [
    {
      "transactionId": "af3c4bf0-fb83-46ac-b4de-d164db5e49a0",
      "disputeAmount": "560.50",
      "disputeReason": "UN_AUTH_ONLINE_PURCHASE"
    }
  ],
  "financialAccountId": "7d08a89d-2ac5-4ed3-a6ca-ad7c974c994e",
  "disputeCaseNumber": "665423"
}