# Dispute Lifecycle Report The Dispute Lifecycle Report sets out lifecycle events for all [Issuing disputes](https://www.checkout.com/docs/card-issuing/manage-issuing-transactions/manage-issuing-disputes.md) on your cards within a specified timeframe. It covers presentment, chargeback, and representment through to pre-arbitration and arbitration. > **Information** > > This report is for [processing-only clients](https://www.checkout.com/docs/card-issuing/set-up-card-program.md#Processing-only_clients). --- ## Report availability The report data is refreshed twice daily at around 12:30 AM and 10:30 AM, in UTC. See instructions on how to download the report on demand or on a schedule: - [In the Dashboard](https://www.checkout.com/docs/business-operations/retrieve-reports.md#Generate_reports_in_the_Dashboard) - [Using the API](https://www.checkout.com/docs/business-operations/retrieve-reports.md#Retrieve_reports_via_API) - [Using Secure File Transfer Protocol](https://www.checkout.com/docs/business-operations/retrieve-reports.md#Access_reports_via_SFTP) (SFTP) - [Using webhooks](https://www.checkout.com/docs/business-operations/retrieve-reports.md#Receive_reports_using_webhooks) --- ## Report format The report is provided as a CSV file. The file name uses the following formats by default: - API and SFTP – `issuing_dispute_lifecycle_{EntityID}_{Start Date: YYYYMMDD}_{End Date:YYYYMMDD}_1.csv` - Dashboard scheduled reports – `{Start date:YYYYMMDD}-{End date:YYYYMMDD}-Card Issuing: Dispute Lifecycle Report-{Entity name}.csv` For SFTP, the report is uploaded in the following folder structure:
`{Entity_name} > reports-{Entity_name} > issuing_dispute_lifecycle` --- ## Sample report [Download a sample report](https://www.checkout.com/docs/files/Sample_Card_Issuing_Dispute_Lifecycle_Report.csv) (CSV file). > **Information** > > If using Safari, hold down the _Option_ key when selecting the link to download the file. --- ## Report fields The report includes all of the following fields in this order: | Field name | Description | | --- | --- | | Dispute ID

`string` | The dispute's unique identifier, prefixed with `idsp_`. | | Issuing Dispute Status

`string` | The status of the dispute. This can be one of:

- `processing` – Checkout.com and the card scheme are processing your request.
- `action_required` – You need to provide further evidence.
- `canceled` – You did not submit the dispute within the time frame, you reversed the dispute, or the scheme rejected the dispute because the funds were already reversed.
- `lost` – You lost the dispute.
- `won` – You won the dispute. | | Issuing Dispute Status Reason

`string` | The status reason that provides more information about the dispute status.

This can be one of:

- `presentment_reversed` – The scheme rejected the dispute because the funds were already reversed. Do not re-submit the dispute.
- `chargeback_pending` – You have requested a chargeback with the merchant.
- `chargeback_processed` – The card scheme has processed your chargeback.
- `chargeback_evidence_invalid_or_insufficient` – The chargeback evidence you provided was invalid or insufficient.
- `chargeback_change_requested` – Checkout.com or the card scheme requested you to amend the chargeback details.
- `chargeback_rejected` – The merchant has rejected the chargeback.
- `chargeback_response_accepted` – You have accepted the merchant's response to the chargeback.
- `chargeback_reversed` – You have reversed the chargeback.
- `prearbitration_pending` – You have escalated the dispute to pre-arbitration.
- `prearbitration_processed` – The card scheme has processed the pre-arbitration.
- `prearbitration_evidence_invalid_or_insufficient` – The pre-arbitration evidence you provided was invalid or insufficient.
- `prearbitration_change_requested` – Checkout.com or the card scheme requested you to amend the pre-arbitration details.
- `prearbitration_rejected` – The merchant has rejected the pre-arbitration.
- `prearbitration_response_accepted` – You have accepted the merchant's response to pre-arbitration.
- `prearbitration_reversed` – You have reversed the pre-arbitration transaction.
- `arbitration_pending` – You have escalated the dispute to arbitration.
- `arbitration_processed` – The card scheme has processed the arbitration.
- `expired` – The dispute has expired. | | Transaction ID

`string` | The unique identifier for the disputed transaction, which links all related authorization, reversal, and clearing messages. This is prefixed with `trx_`. | | Presentment Message ID

`string` | The unique identifier for the message for the specific disputed presentment from the transaction, prefixed with `msg_`. | | Card ID

`string` | The card's unique identifier, prefixed with `crd_`. | | Presented On

`date-time` | The date and time when the merchant made the presentment for the disputed transaction, in UTC.
Standard – ISO 8601 code
Example – `yyyy-mm-ddThh:mm:ss.sss` | | Reconciliation Amount

`decimal` | The amount you settled with the card scheme for the disputed transaction, in the [major currency unit](https://www.checkout.com/docs/payments/accept-payments/format-the-amount-value.md).

Format – Fixed-point notation with up to eight decimal places

Example – 500 USD is represented as `500.00` | | Reconciliation Currency

`string` | The currency in which you settled the card scheme for the disputed transaction.
Standard – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/testing/codes/currency-codes.md)
Example – `USD` | | Transaction Amount

`decimal` | The amount of the disputed transaction, in the major currency unit.

Format – Fixed-point notation with up to eight decimal places | | Transaction Currency

`string` | The currency in which the disputed transaction was processed.
Standard – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/testing/codes/currency-codes.md)
Example – `USD` | | Chargeback Submitted On

`date-time` | The date and time when you submitted the chargeback to the merchant, in UTC.
Standard – ISO 8601 code
Example – `yyyy-mm-ddThh:mm:ss.sss` | | Chargeback Amount

`decimal` | The amount of the chargeback in the major currency unit.

Format – Fixed-point notation with up to eight decimal places | | Chargeback Currency

`string` | The currency in which the chargeback was raised.
Standard – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/testing/codes/currency-codes.md)
Example – `USD` | | Chargeback Reason Code

`decimal` | The [reason code](https://www.checkout.com/docs/developer-resources/codes/chargeback-codes.md#Mastercard) you provided for the chargeback. | | Chargeback Reason Code Message

`string` | The description of the chargeback [reason code](https://www.checkout.com/docs/developer-resources/codes/chargeback-codes.md#Mastercard). | | Chargeback Justification

`string` | Your justification for the chargeback. | | Chargeback Accepted On

`date-time` | The date and time when the merchant accepted the chargeback, in UTC.
Standard – ISO 8601 code
Example – `yyyy-mm-ddThh:mm:ss.sss` | | Chargeback Accepted Amount

`decimal` | The amount of the chargeback the merchant accepted in the major currency unit.

Format – Fixed-point notation with up to eight decimal places | | Chargeback Reversed On

`date-time` | The date and time when you reversed the chargeback, in UTC.
Standard – ISO 8601 code
Example – `yyyy-mm-ddThh:mm:ss.sss` | | Representment Received On

`date-time` | The date and time when you received representment from the merchant, in UTC.
Standard – ISO 8601 code
Example – `yyyy-mm-ddThh:mm:ss.sss` | | Representment Transaction Amount

`decimal` | The amount of the merchant's representment in the major currency unit.

Format – Fixed-point notation with up to eight decimal places | | Representment Transaction Currency

`string` | The currency in which the representment transaction was processed.
Standard – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/testing/codes/currency-codes.md)
Example – `USD` | | Representment Reversed On

`date-time` | The date and time when you reversed the representment transaction, in UTC.
Standard – ISO 8601 code
Example – `yyyy-mm-ddThh:mm:ss.sss` | | Pre Arbitration Submitted On

`date-time` | The date and time when you escalated to pre-arbitration, in UTC.
Standard – ISO 8601 code
Example – `yyyy-mm-ddThh:mm:ss.sss` | | Pre Arbitration Transaction Amount

`decimal` | The amount of the pre-arbitration transaction, in the major currency unit.

Format – Fixed-point notation with up to eight decimal places | | Pre Arbitration Transaction Currency

`string` | The currency in which the pre-arbitration transaction was processed.
Standard – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/testing/codes/currency-codes.md)
Example – `USD` | | Pre Arbitration Reason Code

`decimal` | The [reason code](https://www.checkout.com/docs/developer-resources/codes/chargeback-codes.md#Mastercard) you provided for the pre-arbitration. | | Pre Arbitration Reason Code Message

`string` | The description of the pre-arbitration [reason code](https://www.checkout.com/docs/developer-resources/codes/chargeback-codes.md#Mastercard). | | Pre Arbitration Justification

`string` | Your justification for escalating to pre-arbitration. | | Pre Arbitration Reversed On

`date-time` | The date and time when you reversed the pre-arbitration transaction, in UTC.
Standard – ISO 8601 code
Example – `yyyy-mm-ddThh:mm:ss.sss` | | Pre Arbitration Response Received On

`date-time` | The date and time when you received the merchant's response to the pre-arbitration, in UTC.
Standard – ISO 8601 code
Example – `yyyy-mm-ddThh:mm:ss.sss` | | Arbitration Submitted On

`date-time` | The date and time when you escalated to arbitration, in UTC.
Standard – ISO 8601 code
Example – `yyyy-mm-ddThh:mm:ss.sss` | | Arbitration Transaction Amount

`decimal` | The amount of the arbitration transaction, in the major currency unit.

Format – Fixed-point notation with up to eight decimal places | | Arbitration Transaction Currency

`string` | The currency in which the arbitration transaction was processed.
Standard – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/testing/codes/currency-codes.md)
Example – `USD` | | Arbitration Decided On

`date-time` | The date and time when the card scheme decided the arbitration, in UTC.
Standard – ISO 8601 code
Example – `yyyy-mm-ddThh:mm:ss.sss` | | Card Reference

`string` | The reference you provided when creating the card. | | Card UDF1

`string` | A user-defined field (UDF) you specified when setting up your card program. | | Card UDF2

`string` | A UDF you specified during setup. | | Card UDF3

`string` | A UDF you specified during setup. | | Card UDF4

`string` | A UDF you specified during setup. | | Card UDF5

`string` | A UDF you specified during setup. | | Merchant ID

`string` | The merchant's unique identifier, as assigned by the card scheme. | | Merchant Name

`string` | The merchant's name. | | Merchant City

`string` | The merchant's city. | | Merchant State

`string` | The merchant's state or province. | | Merchant Country Code

`string` | The merchant's country.
Standard – [ISO 3166-1 alpha-2 code](https://www.checkout.com/docs/developer-resources/codes/country-codes.md)
Example – `GB` | | Merchant Address

`string` | The merchant's street address only. | | Merchant Category Code

`string` | The [merchant category code](https://www.checkout.com/docs/developer-resources/codes/merchant-category-codes.md) (MCC), as assigned by the card scheme. | | Merchant Category Name

`string` | The plain-language name for the MCC. | | Last Event ID

`string` | The unique identifier of the most recent event that changed the dispute's status. | | Action Due On

`date-time` | The deadline for you to respond while the acquirer is challenging the dispute, which is the second presentment or pre-arbitration response deadline. This field is only populated while a response is due.
Standard – ISO 8601 code
Example – `yyyy-mm-ddThh:mm:ss.sss` | | Arbitration Reason Code

`decimal` | The [reason code](https://www.checkout.com/docs/developer-resources/codes/chargeback-codes.md#Mastercard) the card scheme used to escalate the dispute to arbitration. This field is empty for disputes that did not reach arbitration. | | Arbitration Reason Code Message

`string` | The description of the arbitration [reason code](https://www.checkout.com/docs/developer-resources/codes/chargeback-codes.md#Mastercard). | | Representment Reason Code

`string` | The [reason code](https://www.checkout.com/docs/developer-resources/codes/chargeback-codes.md#Mastercard) the acquirer provided with the second presentment. | | Representment Evidence File ID

`string` | The unique identifier for the evidence file the acquirer provided with the second presentment. Use this ID to retrieve the file. | | Representment Evidence Description

`string` | The description the acquirer provided for the evidence file with the second presentment. | | Pre Arbitration Acquirer File ID

`string` | The unique identifier for the evidence file the acquirer provided when challenging the pre-arbitration. | | Required Action Instructions

`string` | The instructions from Checkout.com telling you what to correct before you resubmit the dispute. |