Review and resolve the disputes your wallet holders file against their wallet entries.
A wallet holder can dispute a card load or one of your charges. You review the dispute, ask the holder for more information if you need it, then accept or decline it. Accepting records the outcome and amount. Resolving an accepted dispute moves the money. Dispute IDs start with DS-.
| Status | Meaning |
|---|---|
open | Filed by the holder. Nobody has picked it up yet. |
under-review | You are reviewing it. |
needs-more-info | You asked the holder for more information. The holder has 7 days to reply. A reply returns it to under-review. |
accepted | You accepted it, with an outcome and an amount. Resolve it to move the money. |
declined | You declined it, with a reason the holder can read. Final. |
withdrawn | The holder cancelled it. Final. |
expired | The holder did not reply in time. Final. |
superseded-by-chargeback | The card network reversed the money first. Final. |
Every operation here needs the Wallet Management permission. See Access to wallets and payment requests.
Subscribe to wallet-dispute-opened, wallet-dispute-status-changed, and wallet-dispute-message-added to follow disputes. See Wallet Disputes.