Disputes

A dispute occurs when a customer questions your charge with their card issuer. When this happens, you have the opportunity to respond to the dispute with evidence that shows that the charge is legitimate.

Related guide: Disputes and fraud

Endpoints

Update a dispute

• POST /v1/disputes/:id

Retrieve a dispute

• GET /v1/disputes/:id

List all disputes

• GET /v1/disputes

Close a dispute

• POST /v1/disputes/:id/close

Events

• charge.dispute.closed Occurs when a dispute is closed and the dispute status changes to lost, warning_closed, or won.

• charge.dispute.created Occurs whenever a customer disputes a charge with their bank.

• charge.dispute.funds_reinstated Occurs when funds are reinstated to your account after a dispute is closed. This includes partially refunded payments.

• charge.dispute.funds_withdrawn Occurs when funds are removed from your account due to a dispute.

• charge.dispute.updated Occurs when the dispute is updated (usually with evidence).