INTEGRATION

Getting Started

REPORTS

Disputes Report

Disputes Report

Link icon

Description

The Disputes report provides a list of all dispute history events that occurred in the selected time frame.

Link icon

Audience

  • Product / Engineering

  • Risk

  • Merchant support

  • Disputes Management

Link icon

Purpose

The Disputes report serves several key purposes:

  • Perform business analytics

  • Perform dispute threshold monitoring

  • Enable merchant support

Link icon

Functionality

Create reports

Via API

Via Portal

Access reports

Via API

Download via portal

Push to SFTP or e-mail

Schedule reports

Hourly (using the created query pattern)

Daily (using the created query pattern)

Query patterns

The report is generated by specifying a created date and time range using from and to parameters

Data types

CSV

Data sources

Data is sourced from Silverflow's internal event architecture

Link icon

Relevant links

  1. API Reference: Create Disputes Report: Documentation for generating a new Disputes report via the API.

  2. API Reference: Get Report File: Documentation for downloading a report file that has already been generated.

  3. API Reference: Schedule Report: Documentation for creating a recurring report schedule.

Link icon

Content

This section provides a detailed breakdown of all the fields available in the report.

Core field

Description

disputeHistoryEventKey

Unique identifier of the history event

disputeStatus

Status of the dispute at the time of event

disputeStage

Stage of the dispute at the time of event

eventDate

Date the event occurred on the platform

initiator

Initiator of the event

eventDetailsMessageText

Mastercard field only. Contains data that is also replicated in the corresponding financial (if any).

eventDetailsElaboration

Free text field used for passing relevant context

eventDetailsIssuerQuestionnaire

Visa field only. Contains dispute reason code specific answers to questionaire for received chargebacks.

eventDetailsResponseReason

Response Reason Code selected by merchant or acquirer

eventDetailsSubResponseReason

Visa field only. Sub Response Reason Code selected by merchant or acquirer

disputeKey

Unique identifier of the dispute to which the event corresponds

agentKey

Unique identifier of the agent to which the dispute corresponds

merchantKey

Unique identifier of the merchant object to which the dispute corresponds

merchantAcceptorKey

Unique identifier of the merchant acceptor object to which the dispute corresponds

chargeInfoArn

Acquirer Reference Number of the original transaction that was disputed, generated by Silverflow

chargeInfoLocalTransactionDateTime

Local transaction date and time when the original transaction was authorised

chargeInfoNetworkReference

Card network identifier for the authorization of the original transaction

chargeInfoTransactionReference

Merchant or Acquirer reference for the original transaction

chargeInfoFraudLiability

Fraud Liability indicator for the original transaction

chargeInfoChargeKey

Unique identifier for the charge object corresponding to the original transaction

cardInfoLast4

Last 4 digits of the cardholder account number

isPartial

Partial indicator for the dispute event

disputeReference

Card network identifier for the dispute

mid

Merchant Identifier

acquirerBin

Acquirer BIN

actionDueDate

Due date for the response to the event as determined by the card networks

reasonCode

Reason code for the dispute at time of the event

reasonDescription

Description of the reason code

reasonCategory

Reason code category

disputeAmountValue

Dispute amount at time of the event

disputeAmountCurrency

Currency of the dispute amount at time of the event

reconciliationAmountValue

Issuer billing amount for the dispute at time of filing

reconciliationAmountCurrency

Issuer billing currency for the dispute at time of filing

disputeDate

Date the dispute was created (first event)

network

Card network that the dispute has been filed for