---
title: "Chargebacks"
description: "A **Chargeback** is a customer-initiated dispute against a card payment."
url: "https://docs.komoju.com/en/api-reference#2025-01-28/tag/chargebacks"
source_url: "https://docs.komoju.com/en/api-reference/2025-01-28/resources/chargebacks.md"
language: en
api_version: "2025-01-28"
---

# Chargebacks

A **Chargeback** is a customer-initiated dispute against a card payment. KOMOJU exposes each chargeback with its reason code, timeline, and response deadline so you can review the case and submit a defense with supporting evidence before the due date.

## The Chargeback object

A **Chargeback** is a customer-initiated dispute against a card payment.
KOMOJU exposes each chargeback with its reason code, timeline, and response
deadline so you can review the case and submit a defense with supporting
evidence before the due date.

### Attributes

- **`id`** *string (UUID)* *required*

  A unique 25-character alphanumeric resource identifier.

- **`status`** *string (ChargebackStatus)* *required*

  Current status of a chargeback request.

- **`reason_code`** *string* *required*

  Machine-readable reason code. Internal codes (e.g. "CB_Fraud") are used by
  default; for Worldpay Visa/Mastercard payments the network's own reason
  codes are used instead (e.g. "10.4" or "4837").

- **`reason`** *string* *required*

  Human-readable chargeback reason corresponding to the reason code.

- **`created_at`** *string* *required*

  Timestamp when the chargeback was created.

- **`due_date`** *string* *required*

  Deadline by which the merchant must respond.

- **`last_updated_at`** *string* *required*

  Timestamp when the chargeback was last updated.

- **`timeline`** *array of ChargebackTimelineEntry object* *required*

  Chronological list of chargeback events.

- **`payment`** *ChargebackPayment object* *required*

- **`customer`** *ChargebackCustomer object* *required*

- **`defense`** *ChargebackDefense object or null* *required*

### Example

```json
{
  "id": "string",
  "status": "pending",
  "reason_code": "CB_Fraud",
  "reason": "string",
  "created_at": "2024-01-01T00:00:00Z",
  "due_date": "2024-01-01T00:00:00Z",
  "last_updated_at": "2024-01-01T00:00:00Z",
  "timeline": [
    {
      "type": "string",
      "occurred_at": "2024-01-01T00:00:00Z"
    }
  ],
  "payment": {
    "id": "string",
    "amount": 0,
    "currency": "JPY",
    "created_at": "2024-01-01T00:00:00Z",
    "captured_at": "2024-01-01T00:00:00Z",
    "payment_method": {
      "type": "string",
      "brand": "string",
      "last_four_digits": "string"
    },
    "masked_card_number": "string"
  },
  "customer": {
    "name": "string",
    "email": "string"
  },
  "defense": {
    "product_name": "string",
    "reason": "string",
    "shipping_info": {
      "company_name": "string",
      "shipping_date": "string",
      "tracking_number": "string",
      "shipping_address": "string"
    },
    "recipient_info": {
      "name": "string",
      "phone": "string",
      "email": "string"
    },
    "documents": [
      {
        "file_name": "string",
        "content_type": "string",
        "file_size": 0,
        "uploaded_at": "2024-01-01T00:00:00Z",
        "url": "string"
      }
    ]
  }
}
```

## Endpoints

### Chargeback: List

- [GET /chargeback_requests](https://docs.komoju.com/en/api-reference/2025-01-28/list-chargeback-requests.md)

### Chargeback: Show

- [GET /chargeback_requests/{id}](https://docs.komoju.com/en/api-reference/2025-01-28/show-chargeback-request.md)

### Chargeback: Accept

- [POST /chargeback_requests/{id}/accept](https://docs.komoju.com/en/api-reference/2025-01-28/accept-chargeback-request.md)

### Chargeback: Defend

- [POST /chargeback_requests/{id}/defend](https://docs.komoju.com/en/api-reference/2025-01-28/defend-chargeback-request.md)