Chargebacks Report

Last updated: January 22, 2025

The Chargebacks Report lists all chargebacks you raised against your cards during a specified period. It provides information about:

The chargeback, claim, and item involved
The card and cardholder
The transaction and its status
The parties involved in the dispute
User-defined fields (UDFs) you specified during setup

The report is provided as a CSV file. By default, the file name uses the following format:

issuing_chargebacks_{EntityID}_{Start Date: YYYYMMDD}_{End Date:YYYYMMDD}_1.csv

The report data is refreshed daily at 01:00:00 UTC.

See instructions on how to download the report on demand or on a schedule:

The report includes all the following fields in this order:

Field name Description

Field name	Description
Message ID string	The unique identifier for the chargeback message. Example – `msg_abcdef1ghijklmn23opq45r6st`
Client ID string	Your unique identifier from Checkout.com. Example – `cli_abcdef1ghijklmn23opq45r6st`
Entity ID string	The unique identifier for your Checkout.com entity. Example – `ent_abcdef1ghijklmn23opq45r6st`
Cardholder ID string	The unique identifier for the cardholder. Example – `crh_abcdef1ghijklmn23opq45r6st`
Card ID string	The unique identifier for the card. Example – `crd_abcdef1ghijklmn23opq45r6st`
Transaction ID string	The unique identifier for the transaction, which links all related authorization, reversal, and clearing messages. Example – `trx_abcdef1ghijklmn23opq45r6st`
File ID string	The unique identifier for the card scheme's bulk file that the authorization message was extracted from. Example – `0123456789012345678801234`
Claim ID string	The unique identifier for the claim raised against the transaction.
Item ID string	The unique identifier for the item purchased with the transaction.
Status string	The current status of the transaction, which can be one of the following: `authorized` – You have authorized the transaction. `canceled` – The transaction has been canceled. `captured` – The acquirer has captured all the authorized funds. `card verified` – The card has been successfully verified. `declined` – You declined the transaction. `expired` – The transaction has expired. `paid` – You have paid the funds and the transaction is complete. `partially captured` – The acquirer has captured part of the authorized funds. `partially refunded` – The merchant has refunded part of the transaction. `pending` – The transaction is being processed. `refunded` – The merchant has refunded the entire transaction. `retry scheduled` – The transaction is scheduled to be retried. `voided` – The transaction was voided.
Transaction Currency string	The acquirer's local currency or the local currency where the transaction took place. Format – ISO 4217 code
Transaction Amount decimal	The full amount for the transaction in the major currency unit. Format – Fixed-point notation with up to eight decimal places Example – 500 USD is represented as `500.00` More information – Format the payment amount
Reconciliation Currency string	The currency in which you settled the card scheme for the transaction. Format – ISO 4217 code
Reconciliation Amount decimal	The amount you settled with the card scheme for the transaction in the major currency unit. Format – Fixed-point notation with up to eight decimal places Example – 500 USD is represented as `500.00` More information – Format the payment amount
Merchant ID string	The unique identifier for the merchant. This may vary per acquirer.
Merchant Category Code string	The merchant's four-digit category code. Merchants can have multiple category codes.
Merchant Name string	The merchant's company name.
Merchant State string	For US merchants, the state where they are located. For merchants outside the US, this value is `null`.
Merchant Country Code string	The country where the merchant is located. Format – ISO alpha-3 country code
Merchant City string	The city where the merchant is located.
Originator Institution ID string	The unique identifier for the financial institution sending the funds.
Destination Institution ID string	The unique identifier for the financial institution receiving the funds.
Issuer Reference Data string	Your reference information about the transaction.
Acquirer Trace ID string	The unique 23-digit identifier for the transaction as it moves through the payment flow between you and the acquirer. This is also known as the acquirer reference number (ARN).
Acquirer Reference Data string	The acquirer's reference information about the transaction.
Created On UTC datetime	The date and time when the chargeback was created in UTC. Format – ISO 8601 Example – `2020-01-31T10:20:30.456`
Card Type string	The type of card. This can be one of: `physical` – A physical card `virtual` – A non-physical card for card-not-present (CNP) transactions only
Card Status string	The current status of the card. This can be one of: `active` – The card is activated and not subject to any restrictions. `inactive` – The card is awaiting activation. `revoked` – You have canceled the card and all incoming authorizations will be declined. `suspended` – You have frozen the card and all transactions will be declined.
Card Masked PAN string	The masked primary account number (PAN) for the card. Example – `1234 56 ** 7890`
Card Expiry Date datetime	The date when the card expires. Format – `MM/YYYY` Examples – `9/2025`, `11/2029`
Card Billing Currency string	The currency you bill the cardholder in. Format – ISO 4217 code
Card Issuing Country string	The country the card was issued in. Format – ISO alpha-3 country code
Card Display Name string	The display name you provided when creating the card.
Card Reference string	The identification reference you provided when creating the card.
Card UDF 1 string	A user-defined field (UDF) you specified during setup.
Card UDF 2 string	A UDF you specified during setup.
Card UDF 3 string	A UDF you specified during setup.
Card UDF 4 string	A UDF you specified during setup.
Card UDF 5 string	A UDF you specified during setup.

Message ID

string

The unique identifier for the chargeback message.
Example – msg_abcdef1ghijklmn23opq45r6st

Client ID

string

Your unique identifier from Checkout.com.
Example – cli_abcdef1ghijklmn23opq45r6st

Entity ID

string

The unique identifier for your Checkout.com entity.
Example – ent_abcdef1ghijklmn23opq45r6st

Cardholder ID

string

The unique identifier for the cardholder.
Example – crh_abcdef1ghijklmn23opq45r6st

Card ID

string

The unique identifier for the card.
Example – crd_abcdef1ghijklmn23opq45r6st

Transaction ID

string

The unique identifier for the transaction, which links all related authorization, reversal, and clearing messages.
Example – trx_abcdef1ghijklmn23opq45r6st

File ID

string

The unique identifier for the card scheme's bulk file that the authorization message was extracted from.
Example – 0123456789012345678801234

Claim ID

string

The unique identifier for the claim raised against the transaction.

Item ID

string

The unique identifier for the item purchased with the transaction.

Status

string

The current status of the transaction, which can be one of the following:

authorized – You have authorized the transaction.
canceled – The transaction has been canceled.
captured – The acquirer has captured all the authorized funds.
card verified – The card has been successfully verified.
declined – You declined the transaction.
expired – The transaction has expired.
paid – You have paid the funds and the transaction is complete.
partially captured – The acquirer has captured part of the authorized funds.
partially refunded – The merchant has refunded part of the transaction.
pending – The transaction is being processed.
refunded – The merchant has refunded the entire transaction.
retry scheduled – The transaction is scheduled to be retried.
voided – The transaction was voided.

Transaction Currency

string

The acquirer's local currency or the local currency where the transaction took place.
Format – ISO 4217 code

Transaction Amount

decimal

The full amount for the transaction in the major currency unit.
Format – Fixed-point notation with up to eight decimal places
Example – 500 USD is represented as 500.00
More information – Format the payment amount

Reconciliation Currency

string

The currency in which you settled the card scheme for the transaction.
Format – ISO 4217 code

Reconciliation Amount

decimal

The amount you settled with the card scheme for the transaction in the major currency unit.
Format – Fixed-point notation with up to eight decimal places
Example – 500 USD is represented as 500.00
More information – Format the payment amount

Merchant ID

string

The unique identifier for the merchant.

This may vary per acquirer.

Merchant Category Code

string

The merchant's four-digit category code.

Merchants can have multiple category codes.

Merchant Name

string

The merchant's company name.

Merchant State

string

For US merchants, the state where they are located.

For merchants outside the US, this value is null.

Merchant Country Code

string

The country where the merchant is located.
Format – ISO alpha-3 country code

Merchant City

string

The city where the merchant is located.

Originator Institution ID

string

The unique identifier for the financial institution sending the funds.

Destination Institution ID

string

The unique identifier for the financial institution receiving the funds.

Issuer Reference Data

string

Your reference information about the transaction.

Acquirer Trace ID

string

The unique 23-digit identifier for the transaction as it moves through the payment flow between you and the acquirer.

This is also known as the acquirer reference number (ARN).

Acquirer Reference Data

string

The acquirer's reference information about the transaction.

Created On UTC

datetime

The date and time when the chargeback was created in UTC.
Format – ISO 8601
Example – 2020-01-31T10:20:30.456

Card Type

string

The type of card. This can be one of:

physical – A physical card
virtual – A non-physical card for card-not-present (CNP) transactions only

Card Status

string

The current status of the card. This can be one of:

active – The card is activated and not subject to any restrictions.
inactive – The card is awaiting activation.
revoked – You have canceled the card and all incoming authorizations will be declined.
suspended – You have frozen the card and all transactions will be declined.

Card Masked PAN

string

The masked primary account number (PAN) for the card.
Example – 1234 56** **** 7890

Card Expiry Date

datetime

The date when the card expires.
Format – MM/YYYY
Examples – 9/2025, 11/2029

Card Billing Currency

string

The currency you bill the cardholder in.
Format – ISO 4217 code

Card Issuing Country

string

The country the card was issued in.
Format – ISO alpha-3 country code

Card Display Name

string

The display name you provided when creating the card.

Card Reference

string

The identification reference you provided when creating the card.

Card UDF 1

string

A user-defined field (UDF) you specified during setup.

Card UDF 2

string

A UDF you specified during setup.

Card UDF 3

string

A UDF you specified during setup.

Card UDF 4

string

A UDF you specified during setup.

Card UDF 5

string

A UDF you specified during setup.

Chargebacks Report

Report format

Report availability

Report fields