<!-- ZenPays documentation · https://docs.zenpayz.com/docs/reference/objects/chargeback -->

# The Chargeback object

Chargeback entity

:::note
22 of 22 fields on this object have no description yet. Field documentation lives in the SDK types (`types/chargeback.ts`) so it stays in one place — this page is generated from it.
:::

## Fields

<ParamTable
  label="Field"
  rows={[
    { name: "chargebackId", type: "string", required: true },
    { name: "merchantId", type: "string", required: true },
    { name: "transactionId", type: "string", required: true },
    { name: "customerId", type: "string", required: false },
    { name: "amount", type: "number", required: true },
    { name: "currency", type: "string", required: true },
    { name: "status", type: "ChargebackStatus", required: true, desc: "See ChargebackStatus. [ChargebackStatus](/docs/reference/enums/chargeback-status)" },
    { name: "reason", type: "ChargebackReason", required: true, desc: "See ChargebackReason. [ChargebackReason](/docs/reference/enums/chargeback-status)" },
    { name: "reasonCode", type: "string", required: false },
    { name: "reasonDescription", type: "string", required: false },
    { name: "source", type: "ChargebackSource", required: true, desc: "See ChargebackSource. [ChargebackSource](/docs/reference/enums/chargeback-status)" },
    { name: "outcome", type: "ChargebackOutcome", required: false, desc: "See ChargebackOutcome. [ChargebackOutcome](/docs/reference/enums/chargeback-status)" },
    { name: "priority", type: "ChargebackPriority", required: false, desc: "See ChargebackPriority. [ChargebackPriority](/docs/reference/enums/chargeback-status)" },
    { name: "tspProvider", type: "string", required: false },
    { name: "externalChargebackId", type: "string", required: false },
    { name: "disputeDeadline", type: "string", required: false },
    { name: "evidenceDeadline", type: "string", required: false },
    { name: "evidenceSubmittedAt", type: "string", required: false },
    { name: "resolvedAt", type: "string", required: false },
    { name: "resolutionNotes", type: "string", required: false },
    { name: "createdAt", type: "string", required: true },
    { name: "updatedAt", type: "string", required: false },
  ]}
/>

## Example

```json
{
  "chargebackId": "chargeback_1a2b3c",
  "merchantId": "merchant_1a2b3c",
  "transactionId": "transaction_1a2b3c",
  "customerId": "customer_1a2b3c",
  "amount": 5000,
  "currency": "USD",
  "status": "initiated",
  "reason": "fraudulent",
  "source": "customer",
  "createdAt": "2026-01-15T09:30:00Z"
}
```