<!-- ZenPays documentation · https://docs.zenpayz.com/docs/api-reference/chargebacks -->

# Chargebacks

Manage chargebacks, submit evidence, and track dispute resolution.

## Methods

### create

<Tabs groupId="language">
  <TabItem value="javascript" label="JavaScript" default>

```typescript
const chargeback = await zenpays.chargebacks.create({
  transactionId: 'txn_xxx',
  amount: 500,
  reason: 'product_not_received',
  description: 'Customer did not receive the product',
})
```

  </TabItem>
  <TabItem value="python" label="Python">

```python
chargeback = zenpays.chargebacks.create({
    "transactionId": "txn_xxx",
    "amount": 500,
    "reason": "product_not_received",
    "description": "Customer did not receive the product",
})
```

  </TabItem>
</Tabs>

### get

<Tabs groupId="language">
  <TabItem value="javascript" label="JavaScript" default>

```typescript
const chargeback = await zenpays.chargebacks.get('chg_xxx')
```

  </TabItem>
  <TabItem value="python" label="Python">

```python
chargeback = zenpays.chargebacks.get("chg_xxx")
```

  </TabItem>
</Tabs>

### list

<Tabs groupId="language">
  <TabItem value="javascript" label="JavaScript" default>

```typescript
const { data } = await zenpays.chargebacks.list({
  status: 'open',
  page: 1,
  limit: 20,
})
```

  </TabItem>
  <TabItem value="python" label="Python">

```python
result = zenpays.chargebacks.list({"status": "open", "page": 1, "limit": 20})
data = result["data"]
```

  </TabItem>
</Tabs>

### updateStatus

```typescript
const updated = await zenpays.chargebacks.updateStatus('chg_xxx', 'under_review', 'Reviewing evidence')
```

### submitEvidence

```typescript
const result = await zenpays.chargebacks.submitEvidence('chg_xxx', {
  evidenceType: 'delivery_proof',
  description: 'Delivery confirmation from courier',
  documentUrl: 'https://example.com/proof.pdf',
})
```

### addMerchantResponse

```typescript
const result = await zenpays.chargebacks.addMerchantResponse('chg_xxx', {
  response: 'The product was delivered on time. See tracking proof.',
  documentUrls: ['https://example.com/tracking.pdf'],
})
```

### resolve

```typescript
const resolved = await zenpays.chargebacks.resolve('chg_xxx', {
  resolution: 'accepted',
  notes: 'Refund issued to customer',
})
```

### cancel

```typescript
const cancelled = await zenpays.chargebacks.cancel('chg_xxx')
```

### getStats

```typescript
const stats = await zenpays.chargebacks.getStats('2024-01-01', '2024-12-31', 'INR')
```

### getAnalytics

```typescript
const analytics = await zenpays.chargebacks.getAnalytics('2024-01-01', '2024-12-31', 'month', 'INR')
```

### export

```typescript
const downloadUrl = await zenpays.chargebacks.export({ status: 'open' })
```

### bulkUpload

```typescript
const result = await zenpays.chargebacks.bulkUpload(csvFile, 'https://yoursite.com/webhook')
```
