Guide till Webhook Events

Dodo Payments skickar webhook events i varje steg av livscykeln för en betalning, prenumeration, tvist, utbetalning, kredit eller licensnyckel. Den här sidan listar alla events efter resurs. Detaljerade payload-scheman och exempel på handlers finns på de resurspecifika sidorna nedan.

Payment Events

Event	Utlöses när
`payment.succeeded`	En betalning har behandlats utan problem.
`payment.failed`	Ett betalningsförsök misslyckas på grund av nekade kort, otillräckliga medel eller andra fel.
`payment.processing`	En betalning behandlas.
`payment.cancelled`	En betalning avbryts innan den slutförs.

Det fullständiga payload-schemat finns i Payment Webhooks.

Refund Events

Event	Utlöses när
`refund.succeeded`	En återbetalning har behandlats utan problem.
`refund.failed`	Ett återbetalningsförsök misslyckas på grund av behandlingsfel eller andra problem.

Det fullständiga payload-schemat finns i Refund Webhooks.

Dispute Events

Event	Utlöses när
`dispute.opened`	En kortinnehavare öppnar en tvist om en betalning.
`dispute.challenged`	Bevis har skickats in för att bestrida tvisten.
`dispute.accepted`	Tvisten accepterades utan att bestridas.
`dispute.cancelled`	Tvisten drogs tillbaka eller avbröts.
`dispute.expired`	Svarsperioden löpte ut utan att tvisten löstes.
`dispute.won`	Tvisten avgjordes till din fördel.
`dispute.lost`	Tvisten avgjordes till kortinnehavarens fördel.

Detaljerade payload-scheman och exempel på handlers finns i Dispute Webhooks.

Subscription Events

Event	Utlöses när
`subscription.active`	En prenumeration aktiveras och återkommande debiteringar schemaläggs.
`subscription.updated`	Något fält i prenumerationen ändras (synkronisering i realtid utan polling).
`subscription.past_due`	En förnyelse misslyckas och respitperioden börjar; kunden behåller åtkomsten fram till slutdatumet.
`subscription.on_hold`	En prenumeration sätts tillfälligt på hold på grund av en misslyckad förnyelse.
`subscription.paused`	En prenumeration pausas.
`subscription.unpaused`	En pausad prenumeration återupptas.
`subscription.renewed`	En prenumeration förnyas för nästa debiteringsperiod.
`subscription.plan_changed`	En prenumeration uppgraderas, nedgraderas eller ändras med andra tillägg.
`subscription.update_payment_method`	Betalningsmetoden för en prenumeration uppdateras.
`subscription.cancelled`	En prenumeration avslutas av handlaren eller kunden.
`subscription.failed`	Det går inte att skapa en prenumeration under skapandet av ett mandat.
`subscription.expired`	En prenumeration når slutet av sin löptid och upphör.

Detaljerade payload-scheman och exempel på handlers finns i Subscription Webhooks.

License Key Events

Event	Utlöses när
`license_key.created`	En ny licensnyckel skapas för en produkt.

Det fullständiga payload-schemat finns i License Key Webhooks.

Entitlement Grant Events

Event	Utlöses när
`entitlement_grant.created`	Ett nytt entitlement grant skapas för en kund. Automatiskt uppfyllda licensnyckel-grants och feature-flag-grants anländer med `status: "Delivered"` och utlöser inget separat `delivered`-event. Andra grants, inklusive manuellt uppfyllda licensnycklar, anländer med `Pending`. Se Entitlement Grant.
`entitlement_grant.delivered`	Uppfyllelsen av ett grant slutförs — licensnyckeln utfärdas, fillänkar löses upp eller plattformsåtkomst beviljas.
`entitlement_grant.failed`	Uppfyllelsen av ett grant misslyckas. Kontrollera `error_code` och `error_message` i payloaden.
`entitlement_grant.revoked`	Åtkomsten dras tillbaka. Kontrollera `revocation_reason` i payloaden.

Detaljerade payload-scheman, exempel på events och den fullständiga referensen för revocation_reason finns i Entitlement Grant Webhooks.

Credit Events

Event	Utlöses när
`credit.added`	Krediter beviljas en kund (via prenumeration, engångsköp, tillägg eller API).
`credit.deducted`	Krediter förbrukas genom användning eller manuell debitering.
`credit.expired`	Oanvända krediter upphör efter den konfigurerade giltighetsperioden.
`credit.rolled_over`	Oanvända krediter förs vidare till ett nytt grant när cykeln avslutas.
`credit.rollover_forfeited`	Krediter förverkas eftersom det maximala antalet rollover har nåtts.
`credit.overage_charged`	Overage-avgifter tillämpas för användning som överstiger ett saldo på noll.
`credit.overage_reset`	Ackumulerade overage-avgifter återställs (till exempel i början av en ny debiteringscykel).
`credit.manual_adjustment`	En manuell kredit- eller debiteringsjustering görs.
`credit.balance_low`	Kreditsaldot sjunker under det konfigurerade tröskelvärdet.

Detaljerade payload-scheman och exempel på handlers finns i Credit-Based Billing Webhooks.

Recovery Events

Event	Utlöses när
`abandoned_checkout.detected`	En ofullständig eller misslyckad checkout upptäcks efter 60 minuter.
`abandoned_checkout.recovered`	En kund slutför betalningen via en recovery-länk.

Detaljerade payload-scheman, fältbeskrivningar och exempel på handlers finns i Recovery Webhooks.

Dunning Events

Event	Utlöses när
`dunning.started`	Ett dunning-försök inleds för en prenumeration som har passerat förfallodatumet eller satts på hold, eller som har avslutats.
`dunning.recovered`	En kund uppdaterar sin betalningsmetod och den resulterande debiteringen lyckas.

Detaljerade payload-scheman, fältbeskrivningar och exempel på handlers finns i Recovery Webhooks.

Payout Events

Payout events följer hur dina pengar flyttas från Dodo Payments till ditt bankkonto. De motsvarar de payout statuses som visas i dashboarden. Payloaden är ett payout-objekt med samma struktur som en post från GET /payouts.

Event	Utlöses när
`payout.created`	En payout skapas, antingen av den automatiska payout-cykeln eller utanför cykeln.
`payout.in_progress`	Förfallodagen för payouten infaller och behandlingen börjar.
`payout.on_hold`	En payout pausas eller placeras under granskning.
`payout.success`	Payouten till ditt bankkonto regleras.
`payout.failed`	En payout misslyckas. Pengarna och avgifterna krediteras tillbaka till din wallet.

Payout events är varken slutgiltiga eller strikt ordnade. payout.failed kan anlända efter payout.success när en bank returnerar överföringen, och payout.success kan anlända efter payout.failed när en misslyckad payout senare återställs. Payloadens status matchar alltid eventtypen, så använd varje events översta timestamp för att hitta det senaste tillståndet.

payout.created skickades tidigare som payout.not_initiated. Om en befintlig endpoint filtrerar på payout.not_initiated uppdaterar du filtret till payout.created så att det fortsätter att matcha.

Detaljerade payload-scheman, fältbeskrivningar och exempel på handlers finns i Payout Webhooks.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Payment Events

Refund Events

Dispute Events

Subscription Events

License Key Events

Entitlement Grant Events

Credit Events

Recovery Events

Dunning Events

Payout Events

​Payment Events

​Refund Events

​Dispute Events

​Subscription Events

​License Key Events

​Entitlement Grant Events

​Credit Events

​Recovery Events

​Dunning Events

​Payout Events

Payment Events

Refund Events

Dispute Events

Subscription Events

License Key Events

Entitlement Grant Events

Credit Events

Recovery Events

Dunning Events

Payout Events