Disputes
Retrieve disputes, submit evidence, and manage chargebacks.
A dispute is raised by a card network when a customer challenges a charge. VINR notifies you via webhook and gives you a window to submit evidence before the network rules on the case.
Illustrative content. Hand-authored to demonstrate the Standard/Advanced pattern; the production page will be generated from the VINR OpenAPI spec (roadmap item #1). Field names are representative.
The dispute objectAsk
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the dispute, e.g. dis_4Wr9nT. |
payment | string | ID of the disputed payment. |
amount | integer | Disputed amount, in the smallest currency unit (e.g. cents). |
currency | string | Three-letter ISO currency code matching the original payment. |
status | enum | One of warning_needs_response, needs_response, under_review, won, or lost. |
reason | string | Reason code from the card network, e.g. fraudulent or product_not_received. |
evidence_due_by | integer | Unix timestamp of the evidence submission deadline. |
created | integer | Unix timestamp when the dispute was opened. |
Retrieve a disputeAsk
Fetch a dispute by its ID to inspect its current status and evidence deadline.
Update a disputeAsk
Submit or update evidence for a dispute. Pass an evidence object containing the fields relevant
to your case. Submitting evidence moves the status to under_review.
| Field | Type | Description |
|---|---|---|
evidence.customer_email | string | Email address of the customer at the time of purchase. |
evidence.receipt | string | ID of an uploaded file containing a purchase receipt. |
evidence.shipping_documentation | string | ID of an uploaded file containing proof of shipment. |
evidence.customer_signature | string | ID of an uploaded file containing a signed authorization. |
evidence.uncategorized_text | string | Free-form explanation to include with your submission. |
Close a disputeAsk
Withdraw your response and accept the dispute outcome. This is irreversible — use it when you decide not to contest a chargeback.
List disputesAsk
Returns a paginated list of disputes, newest first. Filter by payment or status to narrow results.
| Parameter | Type | Description |
|---|---|---|
payment | string | Filter disputes by payment ID. |
status | enum | Filter by status: warning_needs_response, needs_response, under_review, won, or lost. |
limit | integer | Number of results to return. Default 10, max 100. |
Related eventsAsk
dispute.created, dispute.updated, dispute.closed, dispute.won, dispute.lost. See Events.
