# List chargebacks

This endpoint retrieves a list of chargebacks associated with your account. A Chargeback is a mandatory transaction reversal initiated by the consumer's card issuer or bank, usually due to a dispute over a transaction. When a chargeback occurs, the costumer effectively reverses the transaction, resulting in a debit of the disputed amount from the merchant's account. This endpoint allows you to view details of chargebacks, including the reason for the dispute, transaction amount, and status, providing insights into consumer disputes and their impact on your financials.

Endpoint: GET /chargeback
Version: 2.0
Security: accountId, apiKey

## Query parameters:

  - `cursor` (string)
    The cursor parameter is used for pagination. It specifies the pointer to the start of the next set of results in a sequence of paginated data. Typically, this is a unique identifier of the last item from the previous response. If not provided, the API fetches the first page of results.

  - `limit` (number)
    The limit parameter is used for pagination. It specifies the maximum number of entries to return in a single page of results. Max 100.

  - `created_at` (string)
    Filter records by creation datetime interval in UTC. Maximum allowed range is 30 days. Format: interval(YYYY-MM-DD HH:MM,YYYY-MM-DD HH:MM).
    Example: "interval(2006-01-02 15:04,2006-01-02 15:04)"

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (string)
    A unique identifier for the resource. While typically formatted as a UUID (Universally Unique Identifier), it can also be in other formats as defined by the user. This field ensures the resource can be distinctly recognized and referenced.
    Example: "c6056234-a3f9-42de-b944-3ed793fcb6bb"

  - `data.created_at` (string)
    The timestamp indicating when the resource was created. It is formatted as "YYYY-MM-DD HH:MM".
    Example: "2006-01-02 15:04"

  - `data.message` (string)
    The message field provides a human-readable explanation of the chargeback reason code, making it easier to understand the cause of the dispute without needing to interpret technical codes. This message clarifies the issue, such as incorrect account information, insufficient funds, or unauthorized transactions, and helps merchants quickly identify the nature of the problem.
    Example: "MD06 - Refund Request by End Customer"

  - `data.code` (string)
    The code field provides the specific SEPA or Visa/Masterd code associated with the chargeback. This code identifies the reason for the chargeback, offering insight into why the transaction was disputed by the consumer's bank or card issuer.
SEPA reasons:
  - AC01:  Incorrect Account Number
  - AC04:  Closed Account Number
  - AC06:  Blocked Account
  - AC13:  Invalid Debitor Account Type
  - AG01:  Transaction Forbidden
  - AG02:  Invalid Bank Operation Code
  - AM04:  Insufficient Funds
  - AM05:  Duplication
  - BE05:  Unrecognised Initiating Party
  - CNOR:  Creditor Bank is Not Registered
  - DNOR:  Debitor Bank is Not Registered
  - ED05:  Settlement Failed
  - FF01:  Invalid File Format
  - MD01:  No Mandate
  - MD02:  Missing Mandatory Mandate Information
  - MD06:  Refund Request by End Customer
  - MD07:  End Customer Deceased
  - MS02:  Not Specified Reason Customer Generated
  - MS03:  Not Specified Reason Agent Generated
  - RC01:  Bank Identifier Incorrect
  - RR01:  Missing Debitor Account Or Identification
  - RR02:  Missing Debitor Name Or Address
  - RR03:  Missing Creditor Name or Address
  - RR04:  Regulatory Reason
  - SL01:  Specific Service Offered By Debitor Agent
Visa Reasons:
  - 10.1: EMV Liability Shift Counterfeit Fraud
  - 10.2: EMV Liability Shift Non-Counterfeit Fraud
  - 10.3: Other Fraud, Card-Present Environment
  - 10.4: Other Fraud, Card-Absent Environment
  - 10.5: Visa Fraud Monitoring Program
  - 11.1: Card Recovery Bulletin
  - 11.2: Declined Authorization
  - 11.3: No Authorization
  - 12.1: Late Presentment
  - 12.2: Incorrect Transaction Code
  - 12.3: Incorrect Currency
  - 12.4: Incorrect Account Number
  - 12.5: Incorrect Amount
  - 12.6: Duplicate Processing / Paid By Other Means
  - 12.7: Invalid Data
  - 13.1: Merchandise / Services Not Received
  - 13.2: Cancelled Recurring Transaction
  - 13.3: Not As Described Or Defective Merchandise / Services
  - 13.4: Counterfeit Merchandise
  - 13.5: Misrepresentation
  - 13.6: Credit Not Processed
  - 13.7: Cancelled Merchandise / Services
  - 13.8: Original Credit Transaction Not Accepted
  - 13.9: Non-Receipt of Cash or Load Transaction Value

Mastercard reasons:
  - 4837: No Cardholder Authorization
  - 4840: Fraudulent Processing Of Transactions
  - 4849: Questionable Merchant Activity - Global Merchant Audit Program (GMAP)
  - 4849: Questionable Merchant Activity - Mastercard Rule 3.7 Violation for Coercion Claim
  - 4849: Questionable Merchant Activity - Questionable Merchant Audit Program (QMAP)
  - 4863: Cardholder Does Not Recognize, Potential Fraud
  - 4870: EMV Chip Liability Shift
  - 4871: Chip Liability Shift – Lost / Stolen / Never Received Fraud
  - 4807: Warning Bulletin
  - 4808: Authorization Chargeback - Cardholder-Activated Terminal (CAT) 3 Device
  - 4808: Authorization Chargeback - Expired Chargeback Protection Period
  - 4808: Authorization Chargeback - Multiple Authorization Requests
  - 4808: Authorization Chargeback - Required Authorization Not Obtained
  - 4812: Account Number Not On File
  - 4853: Cardholder Dispute - Credit Posted as a Purchase
  - 4853: Cardholder Dispute - Digital Goods Purchase of $25 or Less
  - 4853: Cardholder Dispute - Goods or Services Not as Described or Defective
  - 4853: Cardholder Dispute - Goods or Services Not Provided
  - 4853: Cardholder Dispute - Issuer Dispute of a Recurring Transaction
  - 4853: Cardholder Dispute - Timeshares
  - 4853: Cardholder Dispute - "No Show" Hotel Charge
  - 4853: Cardholder Dispute - Transaction Did Not Complete
  - 4853: Cardholder Dispute - Addendum Dispute
  - 4853: Cardholder Dispute - Cardholder Dispute of a Recurring Transaction
  - 4853: Cardholder Dispute - Counterfeit Goods
  - 4853: Cardholder Dispute - Credit Not Processed
  - 4855: Goods or Services Not Provided
  - 4859: Addendum, No-Show, or ATM Dispute (Europe)
  - 4859: Addendum, No-Show, or ATM Dispute (Non-European Bank)
  - 4860: Credit Not Processed
  - 4831: Incorrect Transaction Amount
  - 4834: POI Error - Charges for Loss, Theft, or Damages
  - 4834: POI Error - Late Presentment
  - 4834: POI Error - Merchant Credit Correcting Error, Cardholder Currency Exchange Loss
  - 4834: POI Error - Transaction Amount Differs
  - 4834: POI Error - Currency Conversion (Dynamic Currency Conversion)
  - 4834: POI Error - Unreasonable Amount (Europe)
  - 4834: POI Error - ATM Disputes
  - 4834: POI Error - Cardholder Debited More than Once
  - 4841: Canceled Recurring or Digital Goods Transactions
  - 4842: Late Presentment (Europe)
  - 4842: Late Presentment (Non-European Banks)
  - 4846: Correct Transaction Currency Code Not Provided / Currency Errors (Non-European Bank)
  - 4846: Correct Transaction Currency Code Not Provided / Currency Error (Europe)
    Example: "MD06"

  - `data.amount` (number)
    The monetary amount requested for the transaction. This field is formatted as a double, and will be rounded to two decimal places. The value must be greater than or equal to 0.5.
    Example: 12.87

  - `data.capture` (object)

  - `data.capture.payment_id` (string)
    A unique identifier for the resource. While typically formatted as a UUID (Universally Unique Identifier), it can also be in other formats as defined by the user. This field ensures the resource can be distinctly recognized and referenced.
    Example: "c6056234-a3f9-42de-b944-3ed793fcb6bb"

  - `data.capture.payment_type` (string)
    Specifies the type of payment processed. Possible values include:

- Single: A one-time payment transaction.
- Frequent: A payment that occurs regularly but is not part of a subscription (e.g., recurring manual payments).
- Subscription: A recurring payment that is part of a subscription plan, automatically processed at regular intervals.

This field helps to categorize and manage different payment methods based on their frequency and nature.
    Enum: "single", "frequent", "subscription"

  - `metadata` (object)
    An object containing additional information about the response. It includes details that help manage and navigate the retrieved data.

  - `metadata.next_cursor` (string)
    Provides the cursor for the next set of records. This value should be used as the cursor parameter in subsequent requests to continue paginating through the data. If the cursor is an empty string or null, it indicates that there are no more results. To retrieve all available results, continue making subsequent requests until next_cursor is empty or null.
    Example: "lL_j7ilk7rc"

  - `metadata.count` (number)
    The total number of records in the current response. This field indicates the number of items returned in the current set of results.
    Example: 10

## Response 403 fields (application/json):

  - `status` (string, required)

  - `message` (array, required)
    An array of human-readable messages included in the response. These messages provide detailed information about the success of the operation or explain the reasons for any failure. This field is always present in the response to ensure clarity and transparency regarding the outcome of the API request.

## Response 412 fields (application/json):

  - `status` (string, required)

  - `message` (array, required)
    An array of human-readable messages included in the response. These messages provide detailed information about the success of the operation or explain the reasons for any failure. This field is always present in the response to ensure clarity and transparency regarding the outcome of the API request.

## Response 500 fields (application/json):

  - `status` (string, required)

  - `message` (array, required)
    An array of human-readable messages included in the response. These messages provide detailed information about the success of the operation or explain the reasons for any failure. This field is always present in the response to ensure clarity and transparency regarding the outcome of the API request.