Chargebacks Report

Last updated: September 24, 2025

Note

This report will be deprecated as of March 31, 2026 and is replaced by the Clearing Activity Report.

For migration support, contact your account manager or request support.

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 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 is provided as a CSV file. The file name uses the following formats by default:

API and SFTP – issuing_chargebacks_{EntityID}_{Start Date: YYYYMMDD}_{End Date:YYYYMMDD}_1.csv
Dashboard scheduled reports – issuing_chargebacks_{EntityID}_{Start Date: YYYYMMDD}_{End Date:YYYYMMDD}_1.csv

For SFTP, the report is uploaded in the following folder structure: {Entity_name} > reports-{Entity_name} > issuing_chargebacks

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` For more information on how to calculate currency units, see Format the amount value.
Reconciliation Currency string	The currency in which you settled the transaction with the card scheme. 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` For more information on how to calculate currency units, see Format the amount value.
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 of the merchant's address. For other merchants, the 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 date-time	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 date-time	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 where you issued the card. Standard – ISO alpha-3 country code Example – `USA`
Card Display Name string	The display name you provided when creating the card.
Card Reference string	The 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
For more information on how to calculate currency units, see Format the amount value.

Reconciliation Currency

string

The currency in which you settled the transaction with the card scheme.
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
For more information on how to calculate currency units, see Format the amount value.

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 of the merchant's address.

For other merchants, the 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

date-time

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

date-time

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 where you issued the card.
Standard – ISO alpha-3 country code
Example – USA

Card Display Name

string

The display name you provided when creating the card.

Card Reference

string

The 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

Note

Report availability

Report format

Report fields