Skip to main content
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.

Disputes (Chargebacks)

A card dispute is a cardholder contesting a card payment with their bank. It reaches you as a dispute linked to the payment, and you either contest it with evidence or accept it.

Card disputes are part of the disputes family, next to PIX disputes: the routes to read, contest and accept them, the dispute object and its CARD-DISPUTE-<STATUS> events under the DISPUTE webhook subscription are on Card Disputes (Chargebacks). This page covers what a chargeback does to your money.

What a chargeback costs​

When a chargeback is opened, its amount becomes a debt (a receivable), taken from your collateral, what you are owed, your account's token balance and then your next settlements, in the order described in what a refund or chargeback takes, and you are told with ACQUIRING-RECEIVABLE-OPENED; every movement that takes from or gives back to your balance arrives as ACQUIRING-RECEIVABLE-DEBITED, and the end of the debt as ACQUIRING-RECEIVABLE-RESOLVED (RECOVERED, WRITTEN_OFF or REVERSED). A dispute you win ends the debt at once (REVERSED), but the money does not come back to your balance at once: what the chargeback took returns as your reserve and is paid out on collateralReleaseAt. What it burned from your account's token balance is the exception: the same units are minted back to that balance. The chargeback fee is not given back: it stays with Avenia and is charged to you as a new debt. On a sale paid out in USDC or USDT, a chargeback can also charge an FX difference, which a win reverses. A pre-dispute (disputeType PRE_DISPUTE) is an inquiry and debits nothing. See Webhooks.

A chargeback on a payment paid to a wallet works the same way: the debt is taken from your account's next settlements, and what a won dispute returns is paid to that sale's wallet on collateralReleaseAt.

Simulating a chargeback in the sandbox​

Create a payment whose externalId is one of the values in Sandbox: Test Cards and Scenarios, with the approved test card. A couple of minutes later the test acquirer opens a chargeback on it, and the dispute arrives as it would in production.