## Chargeback Request Schema

### Fields

- **amount** (integer, required): Amount for chargeback
- **customer_filed_date** (date-time): Date the customer filed the chargeback request
- **customer_note** (string, ≤ 5000): Customer description
- **reason** (string, required, enum): Reason for chargeback  
  - ATM_CASH_MISDISPENSE  
  - CANCELLED  
  - DUPLICATED  
  - FRAUD_CARD_NOT_PRESENT  
  - FRAUD_CARD_PRESENT  
  - FRAUD_OTHER  
  - GOODS_SERVICES_NOT_AS_DESCRIBED  
  - GOODS_SERVICES_NOT_RECEIVED  
  - INCORRECT_AMOUNT  
  - MISSING_AUTH  
  - OTHER  
  - PROCESSING_ERROR  
  - RECURRING_TRANSACTION_NOT_CANCELLED  
  - REFUND_NOT_PROCESSED  
- **transaction_token** (uuid, required): Transaction for chargeback

---

## Dispute Schema

- **amount** (integer, required): Amount under dispute. May be different from the original transaction amount.
- **arbitration_date** (date-time | null, required): Date dispute entered arbitration.
- **created** (date-time, required): Timestamp of when first Dispute was reported.
- **customer_filed_date** (date-time | null, required): Date that the dispute was filed by the customer making the dispute.
- **customer_note** (string | null, required): End customer description of the reason for the dispute.
- **network_claim_ids** (array of strings, required): Unique identifiers for the dispute from the network.
- **network_filed_date** (date-time | null, required): Date that the dispute was submitted to the network.
- **network_reason_code** (string | null, required): Network reason code used to file the dispute.
- **prearbitration_date** (date-time | null, required): Date dispute entered pre-arbitration.
- **primary_claim_id** (string | null, required): Unique identifier for the dispute from the network.
- **reason** (string, required, enum): Dispute reason:  
  - ATM_CASH_MISDISPENSE  
  - CANCELLED  
  - DUPLICATED  
  - FRAUD_CARD_NOT_PRESENT  
  - FRAUD_CARD_PRESENT  
  - FRAUD_OTHER  
  - GOODS_SERVICES_NOT_AS_DESCRIBED  
  - GOODS_SERVICES_NOT_RECEIVED  
  - INCORRECT_AMOUNT  
  - MISSING_AUTH  
  - OTHER  
  - PROCESSING_ERROR  
  - REFUND_NOT_PROCESSED  
  - RECURRING_TRANSACTION_NOT_CANCELLED  
- **representment_date** (date-time | null, required): Date the representment was received.
- **resolution_date** (date-time | null, required): Date that the dispute was resolved.
- **resolution_note** (string | null, required): Note by Dispute team on the case resolution.
- **resolution_reason** (string | null, required, enum): Reason for the dispute resolution:  
  - CASE_LOST  
  - NETWORK_REJECTED  
  - NO_DISPUTE_RIGHTS_3DS  
  - NO_DISPUTE_RIGHTS_BELOW_THRESHOLD  
  - NO_DISPUTE_RIGHTS_CONTACTLESS  
  - NO_DISPUTE_RIGHTS_HYBRID  
  - NO_DISPUTE_RIGHTS_MAX_CHARGEBACKS  
  - NO_DISPUTE_RIGHTS_OTHER  
  - PAST_FILING_DATE  
  - PREARBITRATION_REJECTED  
  - PROCESSOR_REJECTED_OTHER  
  - REFUNDED  
  - REFUNDED_AFTER_CHARGEBACK  
  - WITHDRAWN  
  - WON_ARBITRATION  
  - WON_FIRST_CHARGEBACK  
  - WON_PREARBITRATION  
- **status** (string, required, enum): Status types:  
  - NEW  
  - PENDING_CUSTOMER  
  - SUBMITTED  
  - REPRESENTMENT  
  - PREARBITRATION  
  - ARBITRATION  
  - CASE_WON  
  - CASE_CLOSED  
- **token** (uuid, required): Globally unique identifier.
- **transaction_token** (uuid, required): The transaction that is being disputed.

---

## Example Requests

### Chargeback Request Example
```json
{
  "amount": 10000,
  "customer_filed_date": "2021-06-28T22:53:15Z",
  "reason": "FRAUD_CARD_PRESENT",
  "transaction_token": "12345624-aa69-4cbc-a946-30d90181b621"
}
```

### Dispute Response Example
```json
{
  "amount": 0,
  "arbitration_date": "2026-07-18T00:25:19.655Z",
  "created": "2026-07-18T00:25:19.655Z",
  "customer_filed_date": "2026-07-18T00:25:19.655Z",
  "customer_note": "string",
  "network_claim_ids": ["string"],
  "network_filed_date": "2026-07-18T00:25:19.655Z",
  "network_reason_code": "string",
  "prearbitration_date": "2026-07-18T00:25:19.655Z",
  "primary_claim_id": "string",
  "reason": "ATM_CASH_MISDISPENSE",
  "representment_date": "2026-07-18T00:25:19.655Z",
  "resolution_date": "2026-07-18T00:25:19.655Z",
  "resolution_note": "string",
  "resolution_reason": "CASE_LOST",
  "status": "ARBITRATION",
  "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "transaction_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
```