Request chargeback

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

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

Dispute Response Example

{
  "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"
}