Disputes and chargebacks
Open a dispute against a transaction, attach the evidence, and cancel a case that should not have been raised.
Used to initiate spending disputes from various customer interaction channels
Creates a dispute case for a card using provided card info, case type, dispute date, reason, and explanation. Maps optional dispute case details (UTID, currency, amount) and DMS references. Calls _bkmBatchService.CreateDisputeCase and returns CaseNumber and list of DisputeTransaction details including DisputeTransactionId and UTID.
Used to initiate spending disputes from various customer interaction channels › Request Body
DisputeDateDispute Date - [Optional]
ChannelChannel - [Optional]
ShadowCardNumberShadow Card Number - [Optional]
CardRefNumberCard Ref Number - [Optional]
EncryptedCardNumberEncrypted Card Number - [Optional]
CardNumberCard Number - [Optional]
CaseTypeCase Type - [Optional]
DisputeReasonCodeDispute Reason Code - [Optional]
DisputeExplanationDispute Explanation - [Optional]
Create Dispute Case Detail - [Optional]
Dms Reference - [Optional]
Used to initiate spending disputes from various customer interaction channels › Responses
Success
CaseNumberCase Number - [Optional]
Dispute Transaction - [Optional]
Used in an ongoing dispute process when the customer withdraws the dispute request
Cancels a dispute case by calling the internal BKM batch service with CaseNumber, Channel, DisputeTransactionId, UTID, and Description. Returns a response indicating whether the cancellation was successful.
Used in an ongoing dispute process when the customer withdraws the dispute request › Request Body
CaseNumberCase Number - [Optional]
DisputeTransactionIdDispute Transaction Id - [Optional]
ChannelChannel - [Optional]
UTIDU T I D - [Optional]
DescriptionDescription - [Optional]
Used in an ongoing dispute process when the customer withdraws the dispute request › Responses
Success
isSuccessfulIs Successful - [Optional]
Used when an ongoing dispute case requires adding a new document to the case record
Adds one or more document references to an existing case in the core banking system using the provided case number. The service accepts channel information, case number, and a list of DMS document references, and forwards them to the BKM batch service for processing. This operation performs a state-changing action by attaching documents to the specified case.
Used when an ongoing dispute case requires adding a new document to the case record › Request Body
CaseNumberCase Number - [Optional]
ChannelChannel - [Optional]
Dms References - [Optional]
Used when an ongoing dispute case requires adding a new document to the case record › Responses
Success
Used to view registered case transactions and their statuses presented to the customer
Retrieves the list of dispute transactions. Accepts GetDisputeListRequest with parameters such as CardNumber, CardRefNumber, CaseNumber, CustomerNumber, DisputeTransactionId, EncryptedCardNumber, ShadowCardNumber, and UTID. Calls _bkmBatchService.GetDisputeList() and maps results to GetDisputeListResponse containing DisputeList with properties like CaseNumber, DisputeTransactionId, CustomerNumber, DisputeAmount, DisputeCurrencyCode, DisputeDate, DisputeReasonCode, MaskedCardNumber, MerchantName, TrnAmount, InsertUserId, TrnCurrencyCode, TrnDate, TrnStatusDescription, AuthorizationNumber, Mcc, SourceNetwork, and Utid.
Used to view registered case transactions and their statuses presented to the customer › Request Body
CaseNumberCase Number - [Optional]
DisputeTransactionIdDispute Transaction Id - [Optional]
CustomerNumberCustomer Number - [Optional]
UTIDU T I D - [Optional]
ShadowCardNumberShadow Card Number - [Optional]
CardRefNumberCard Ref Number - [Optional]
EncryptedCardNumberEncrypted Card Number - [Optional]
CardNumberCard Number - [Optional]
Used to view registered case transactions and their statuses presented to the customer › Responses
Success
Dispute List - [Optional]
Service that returns available dispute reasons used when creating a new dispute case via Create Dispute Case
Retrieves the list of dispute reason definitions. Calls _bkmBatchService.GetDisputeReasonDefList() and maps results to GetDisputeReasonDefResponse containing DisputeReasonDefinitions with properties DisputeReasonCode and DisputeReasonDescription.
Service that returns available dispute reasons used when creating a new dispute case via Create Dispute Case › Responses
Success
Dispute Reason Definitions - [Optional]