Disputa
Il payload inviato al tuo endpoint webhook quando una disputa viene creata o aggiornata, e come gestire ogni evento del ciclo di vita della disputa.
Eventi Webhook di Disputa
Una disputa emette un evento in ogni fase del suo ciclo di vita:| Evento | Quando si attiva | Cosa significa di solito |
|---|---|---|
dispute.opened | Un titolare di carta apre una disputa su un pagamento | I fondi sono bloccati; preparati a rispondere |
dispute.challenged | Le prove sono state presentate per contestare la disputa | La disputa è in revisione da parte del network |
dispute.accepted | La disputa è stata accettata (non contestata) | I fondi vengono restituiti al titolare della carta |
dispute.cancelled | La disputa è stata ritirata o annullata | Nessuna ulteriore azione necessaria |
dispute.expired | La finestra di risposta è scaduta senza risoluzione | Tipicamente si risolve contro di te |
dispute.won | La disputa è stata risolta a tuo favore | I fondi vengono trattenuti |
dispute.lost | La disputa è stata risolta a favore del titolare della carta | I fondi vengono restituiti al titolare della carta |
dispute.lost con is_resolved_by_rdr: true. Questo è previsto — il rimborso è stato emesso automaticamente per prevenire un chargeback formale.Gestione degli Eventi di Disputa
Quandodispute.opened si attiva, l’importo contestato è immediatamente bloccato. Usa l’evento per aggiornare i tuoi registri e, se intendi contestarlo, raccogli le prove nel dashboard.
Status e Fase della Disputa
L’oggetto della disputa riporta i suoi progressi attraverso due campi:| Campo | Valori |
|---|---|
dispute_status | dispute_opened, dispute_expired, dispute_accepted, dispute_cancelled, dispute_challenged, dispute_won, dispute_lost |
dispute_stage | pre_dispute, dispute, pre_arbitration |
Correlati
Managing Disputes
Handle Payment Failures
Schema del Payload Webhook
The amount involved in the dispute, represented as a string to accommodate precision.
The unique identifier of the business involved in the dispute.
The timestamp of when the dispute was created, in UTC.
The currency of the disputed amount, represented as an ISO 4217 currency code.
The unique identifier of the dispute.
The current stage of the dispute process.
pre_dispute, dispute, pre_arbitration The current status of the dispute.
dispute_opened, dispute_expired, dispute_accepted, dispute_cancelled, dispute_challenged, dispute_won, dispute_lost The unique identifier of the payment associated with the dispute.
Whether the dispute was resolved by Rapid Dispute Resolution
Remarks