RocketKOR

COMING SOON

Dispute Detail Object

The Dispute Detail object represents details for 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

values when disputeType is UNAUTHORIZED: UN_AUTH_POS_TXN, UN_AUTH_ATM_WITHDRAWAL, UN_AUTH_ONLINE_PURCHASE, UN_CHARGE_AFTER_SUB_CANCELLED, CHARGE_WITHOUT_CONSENT

values when disputeType is MERCHANT_DISPUTE: ATM_REQ_NOT_FULFILLED, DOLLAR_AMT_SALE_INCR, DISPUTE_ON_ENTIRE_CHARGE, MERCH_NOT_RECEIVED, MERCH_RETURNED, ENCLOSING_EXPLANATION, DUP_TRANSACTION, CREDIT_SLIP_CHARGE_APPLIED, CREDIT_SLIP_CHARGE_NOT_APPLIED, HOTEL_RESERVE_CANCEL, RECEIVED_CANCEL_NUMBER, OTHERS, CHARGE_AFTER_SUB_CANCELLED, PAID_BY_OTR_MEANS

Reason for the transaction dispute.

The following values are supported for unauthorized transactions (disputeType is UNAUTHORIZED):

  • UN_AUTH_POS_TXN  Unauthorized point of sale (POS) transaction.
  • UN_AUTH_ATM_WITHDRAWAL  Unauthorized ATM withdrawal.
  • UN_AUTH_ONLINE_PURCHASE  Unauthorized online purchase.
  • UN_CHARGE_AFTER_SUB_CANCELLED  Charge after subscription cancellation.
  • CHARGE_WITHOUT_CONSENT  Charge without consent.

The following values are supported for merchant disputes (disputeType is MERCHANT_DISPUTE):

  • ATM_REQ_NOT_FULFILLED  ATM request was not fulfilled.
  • DOLLAR_AMT_SALE_INCR  Dollar amount sale was increased.
  • DISPUTE_ON_ENTIRE_CHARGE  Dispute on the entire charge or a portion of the charge.
  • MERCH_NOT_RECEIVED  Merchandise was not received.
  • MERCH_RETURNED  Merchandise was returned.
  • ENCLOSING_EXPLANATION  Enclosing explanation or did not receive merchandise or service.
  • DUP_TRANSACTION  Duplicate transaction.
  • 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.
  • HOTEL_RESERVE_CANCEL  Canceled hotel reservation.
  • RECEIVED_CANCEL_NUMBER  Received cancellation number.
  • OTHERS  Other reasons.
  • CHARGE_AFTER_SUB_CANCELLED  Charge after subscription cancelled.
  • PAID_BY_OTR_MEANS  Paid by other means.

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.

disputeStatus

string enum, values: LOGGED, IN_REVIEW, ACCEPTED, DECLINED, CARDHOLDER_WIN

Status of the dispute. The following values are supported:

  • LOGGED  Dispute has been logged.
  • IN_REVIEW  Dispute is in review.
  • ACCEPTED  Dispute has been accepted.
  • DECLINED  Dispute has been declined.
  • CARDHOLDER_WIN  The dispute has been settled in favor of the cardholder.

logDateTime

string (date-time)

Date and time the dispute was created in the RocketKOR system.

Dispute Detail 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",
  "disputeStatus": "LOGGED",
  "logDateTime": "2023-02-13T01:18:02.049Z"
}