Webhook Event Guide

Förstå de olika webhook-händelser som utlöses av Dodo Payments under betalning, återbetalning, prenumeration, tvist och licensnyckelaktiviteter

Dodo Payments tillhandahåller realtids-webhook-notifikationer för att hålla dig informerad om kritiska händelser relaterade till transaktioner, prenumerationer, återbetalningar, tvister och hantering av licensnycklar. Nedan finns en detaljerad guide till dessa händelser, kategoriserade för tydlighet, tillsammans med implementeringstips och överväganden.

​

Betalningshändelser

Event Name	Event Type	Description
Payment Succeeded	payment.succeeded	Utlöses när en betalning har behandlats framgångsrikt.
Payment Failed	payment.failed	Uppstår när ett betalningsförsök misslyckas på grund av fel, avvisade kort eller andra problem.
Payment Processing	payment.processing	Indikerar att en betalning för närvarande behandlas.
Payment Cancelled	payment.cancelled	Utlöses när en betalning avbryts innan den slutförs.

​

Återbetalningshändelser

Event Name	Event Type	Description
Refund Succeeded	refund.succeeded	Utlöses när en återbetalning har genomförts framgångsrikt.
Refund Failed	refund.failed	Uppstår när ett återbetalningsförsök misslyckas på grund av bearbetningsfel eller andra problem.

​

Tvist-händelser

Event Name	Event Type	Description
Dispute Opened	dispute.opened	Utlöses när en kund initierar en tvist.
Dispute Expired	dispute.expired	Indikerar att en tvist löpt ut utan att ha nått någon lösning.
Dispute Accepted	dispute.accepted	Utlöses när en handlar accepterar tvisten.
Dispute Cancelled	dispute.cancelled	Uppstår när en tvist avbryts av kunden eller systemet.
Dispute Challenged	dispute.challenged	Utlöses när en handlar bestrider en tvist.
Dispute Won	dispute.won	Indikerar att handlaren framgångsrikt vunnit en tvist.
Dispute Lost	dispute.lost	Uppstår när handlaren förlorar en tvist.

​

Prenumerationshändelser

Event Name	Event Type	Description
Subscription Active	subscription.active	Indikerar att en prenumeration nu är aktiv och att återkommande avgifter är planerade.
Subscription Updated	subscription.updated	Utlöses när något fält i en prenumeration uppdateras (realtidssynk utan polling).
Subscription On Hold	subscription.on_hold	Utlöses när en prenumeration tillfälligt läggs på paus på grund av misslyckad förnyelse.
Subscription Renewed	subscription.renewed	Uppstår när en prenumeration förnyas framgångsrikt.
Subscription Plan Changed	subscription.plan_changed	Utlöses när en prenumeration uppgraderas, nedgraderas eller ändras med andra tillägg.
Subscription Cancelled	subscription.cancelled	Utlöses när en prenumeration avbryts av handlaren eller kunden.
Subscription Failed	subscription.failed	Indikerar en misslyckad prenumeration. Det innebär att vi inte kunde skapa ett mandat.
Subscription Expired	subscription.expired	Utlöses när en prenumeration når slutet av sin period och upphör.

​

Licensnyckelhändelser

Event Name	Event Type	Description
License Key Created	license_key.created	Utlöses när en ny licensnyckel skapas för en produkt.

​

Kredithändelser

Händelsenamn	Händelsetyp	Beskrivning
Credit Added	credit.added	Utlöses när krediter tilldelas en kund (prenumeration, engångsbelopp, tillägg eller API).
Credit Deducted	credit.deducted	Inträffar när krediter förbrukas genom användning eller manuell debitering.
Credit Expired	credit.expired	Utlöses när oanvända krediter löper ut efter den konfigurerade utgångsperioden.
Credit Rolled Over	credit.rolled_over	Inträffar när oanvända krediter förs över till en ny tilldelning vid slutet av cykeln.
Rollover Forfeited	credit.rollover_forfeited	Utlöses när krediter går förlorade eftersom maximal överföringsräkning uppnåtts.
Overage Charged	credit.overage_charged	Inträffar när övertrasseringsavgifter tas ut för användning bortom nollsaldo.
Manual Adjustment	credit.manual_adjustment	Utlöses när en manuell kredit- eller debiteringsjustering görs.
Balance Low	credit.balance_low	Utlöses när kreditsaldot sjunker under den konfigurerade tröskeln.

Dessa webhook-händelser är utformade för att ge handlare kritiska uppdateringar för att effektivt hantera sin verksamhet. Implementera robusta hanterare för varje relevant händelse i din webhook-integration för att säkerställa smidig och pålitlig funktionalitet.