API v1FiatPe Home
FiatPeDocs

Dispute

View and manage disputes raised against transactions. Track dispute details, stages, statuses, disputed amounts, response deadlines, reasons, fund state, and related transaction information to support timely review and resolution.

Entity

idstring

The unique identifier of the dispute.

entitystring

The type of entity represented by this object.

payment_idstring

The unique identifier of the payment against which the dispute was raised.

amountinteger

The disputed amount in the smallest currency sub-unit. For INR, 5000 represents ₹50.00.

currencystring

The three-letter ISO currency code of the disputed amount.

stagestring

The current stage of the dispute lifecycle, such as PRE_ARBITRATION, CHARGEBACK, or ARBITRATION.

statusstring

The current processing status of the dispute. Possible values include open, under_review, won, lost, and closed.

user_statusstring

The merchant-facing status indicating whether any action is required for the dispute.

reasonstring

The reason provided for raising the dispute.

explanationstring

A detailed explanation of the dispute and the reason it was raised.

response_due_atinteger

The Unix timestamp indicating the deadline by which the merchant must respond to the dispute.

raised_atinteger

The Unix timestamp indicating when the dispute was raised.

internal_transaction_idstring

The unique transaction identifier generated by FiatPe for the disputed payment.

external_transaction_idstring

The transaction identifier provided by the acquiring bank, payment processor, or external payment partner for the disputed payment.

user_dispute_amountinteger

The amount disputed by the customer, in the smallest currency sub-unit. This amount may be less than or equal to the total transaction amount.

created_atinteger

The Unix timestamp indicating when the dispute record was created.