Disputes
The following diagram covers the possible status flow for Disputes. For every status change a webhook notification is sent to the merchant's API.
Status Description
| Dispute Status | Description | Possible Next Status(es) |
|---|---|---|
CREATED | The dispute has been initiated and registered in the system. | REFUND_PENDING, EVIDENCE_PENDING |
REFUND_PENDING | A decision to refund the dispute has been made, and the refund is being processed. | REFUNDED |
REFUNDED | The disputed amount has been successfully returned to the payer. This is a final state for this path. | None |
EVIDENCE_PENDING | The dispute requires supporting evidence from the merchant, who has been notified to provide documentation. | EVIDENCE_RECEIVED, FINAL (e.g., if no evidence is sent before a deadline) |
EVIDENCE_RECEIVED | The merchant has uploaded the requested evidence, and it has been received for internal review before submission. | EVIDENCE_SUBMITTED, FINAL |
EVIDENCE_SUBMITTED | The received evidence has been formally submitted to the payment processor or financial institution. | RECOVERED, FINAL |
RECOVERED | The dispute was resolved in favor of the merchant based on the evidence provided. The funds are recovered. This is a final state. | None |
FINAL | The dispute was lost by the merchant. This can occur due to a timeout or because the provided evidence was insufficient. This is a final state. | None |