Abonnement

Événements Webhook d’Abonnement

Les événements webhook suivants sont disponibles pour suivre les changements du cycle de vie des abonnements :

Événement	Description
`subscription.active`	L’abonnement est activé avec succès
`subscription.updated`	L’objet d’abonnement a été mis à jour (tout changement de champ déclenche cet événement)
`subscription.on_hold`	L’abonnement est suspendu en raison d’un échec de renouvellement
`subscription.renewed`	L’abonnement est renouvelé pour la prochaine période de facturation
`subscription.plan_changed`	Le plan d’abonnement a été mis à niveau, rétrogradé ou modifié
`subscription.cancelled`	L’abonnement est annulé
`subscription.failed`	La création de l’abonnement a échoué lors de la création du mandat
`subscription.expired`	L’abonnement a atteint la fin de sa période

Utilisation de `subscription.updated` pour la Synchronisation en Temps Réel

Le webhook subscription.updated se déclenche chaque fois qu’un champ d’abonnement change, vous permettant de garder l’état de votre application synchronisé sans interroger :

app.post('/webhooks/dodo', async (req, res) => {
  const event = req.body;
  
  if (event.type === 'subscription.updated') {
    const subscription = event.data;
    
    // Sync subscription changes to your database
    await syncSubscription(subscription.subscription_id, {
      status: subscription.status,
      next_billing_date: subscription.next_billing_date,
      metadata: subscription.metadata,
      // ... other fields you want to track
    });
    
    console.log(`Subscription ${subscription.subscription_id} updated`);
  }
  
  res.json({ received: true });
});

Abonnez-vous à subscription.updated pour recevoir des notifications en temps réel sur tout changement d’abonnement, éliminant ainsi le besoin d’interroger l’API pour des mises à jour.

Schéma de Charge Utile Webhook

Response struct representing subscription details

addons

Addon Cart Response Item · object[]

required

Addons associated with this subscription

Afficher attributs enfants

addons.addon_id

string

required

addons.quantity

integer<int32>

required

billing

object

required

Billing address details for payments

Afficher attributs enfants

billing.country

enum<string>

required

Two-letter ISO country code (ISO 3166-1 alpha-2)

Options disponibles:

AF,

AX,

AL,

DZ,

AS,

AD,

AO,

AI,

AQ,

AG,

AR,

AM,

AW,

AU,

AT,

AZ,

BS,

BH,

BD,

BB,

BY,

BE,

BZ,

BJ,

BM,

BT,

BO,

BQ,

BA,

BW,

BV,

BR,

IO,

BN,

BG,

BF,

BI,

KH,

CM,

CA,

CV,

KY,

CF,

TD,

CL,

CN,

CX,

CC,

CO,

KM,

CG,

CD,

CK,

CR,

CI,

HR,

CU,

CW,

CY,

CZ,

DK,

DJ,

DM,

DO,

EC,

EG,

SV,

GQ,

ER,

EE,

ET,

FK,

FO,

FJ,

FI,

FR,

GF,

PF,

TF,

GA,

GM,

GE,

DE,

GH,

GI,

GR,

GL,

GD,

GP,

GU,

GT,

GG,

GN,

GW,

GY,

HT,

HM,

VA,

HN,

HK,

HU,

IS,

IN,

ID,

IR,

IQ,

IE,

IM,

IL,

IT,

JM,

JP,

JE,

JO,

KZ,

KE,

KI,

KP,

KR,

KW,

KG,

LA,

LV,

LB,

LS,

LR,

LY,

LI,

LT,

LU,

MO,

MK,

MG,

MW,

MY,

MV,

ML,

MT,

MH,

MQ,

MR,

MU,

YT,

MX,

FM,

MD,

MC,

MN,

ME,

MS,

MA,

MZ,

MM,

NA,

NR,

NP,

NL,

NC,

NZ,

NI,

NE,

NG,

NU,

NF,

MP,

NO,

OM,

PK,

PW,

PS,

PA,

PG,

PY,

PE,

PH,

PN,

PL,

PT,

PR,

QA,

RE,

RO,

RU,

RW,

BL,

SH,

KN,

LC,

MF,

PM,

VC,

WS,

SM,

ST,

SA,

SN,

RS,

SC,

SL,

SG,

SX,

SK,

SI,

SB,

SO,

ZA,

GS,

SS,

ES,

LK,

SD,

SR,

SJ,

SZ,

SE,

CH,

SY,

TW,

TJ,

TZ,

TH,

TL,

TG,

TK,

TO,

TT,

TN,

TR,

TM,

TC,

TV,

UG,

UA,

AE,

GB,

UM,

US,

UY,

UZ,

VU,

VE,

VN,

VG,

VI,

WF,

EH,

YE,

ZM,

ZW

billing.city

string | null

City name

billing.state

string | null

State or province name

billing.street

string | null

Street address including house number and unit/apartment if applicable

billing.zipcode

string | null

Postal code or ZIP code

cancel_at_next_billing_date

boolean

required

Indicates if the subscription will cancel at the next billing date

created_at

string<date-time>

required

Timestamp when the subscription was created

currency

enum<string>

required

Currency used for the subscription payments

Options disponibles:

AED,

ALL,

AMD,

ANG,

AOA,

ARS,

AUD,

AWG,

AZN,

BAM,

BBD,

BDT,

BGN,

BHD,

BIF,

BMD,

BND,

BOB,

BRL,

BSD,

BWP,

BYN,

BZD,

CAD,

CHF,

CLP,

CNY,

COP,

CRC,

CUP,

CVE,

CZK,

DJF,

DKK,

DOP,

DZD,

EGP,

ETB,

EUR,

FJD,

FKP,

GBP,

GEL,

GHS,

GIP,

GMD,

GNF,

GTQ,

GYD,

HKD,

HNL,

HRK,

HTG,

HUF,

IDR,

ILS,

INR,

IQD,

JMD,

JOD,

JPY,

KES,

KGS,

KHR,

KMF,

KRW,

KWD,

KYD,

KZT,

LAK,

LBP,

LKR,

LRD,

LSL,

LYD,

MAD,

MDL,

MGA,

MKD,

MMK,

MNT,

MOP,

MRU,

MUR,

MVR,

MWK,

MXN,

MYR,

MZN,

NAD,

NGN,

NIO,

NOK,

NPR,

NZD,

OMR,

PAB,

PEN,

PGK,

PHP,

PKR,

PLN,

PYG,

QAR,

RON,

RSD,

RUB,

RWF,

SAR,

SBD,

SCR,

SEK,

SGD,

SHP,

SLE,

SLL,

SOS,

SRD,

SSP,

STN,

SVC,

SZL,

THB,

TND,

TOP,

TRY,

TTD,

TWD,

TZS,

UAH,

UGX,

USD,

UYU,

UZS,

VES,

VND,

VUV,

WST,

XAF,

XCD,

XOF,

XPF,

YER,

ZAR,

ZMW

customer

object

required

Customer details associated with the subscription

Afficher attributs enfants

customer.customer_id

string

required

Unique identifier for the customer

customer.email

string

required

Email address of the customer

customer.name

string

required

Full name of the customer

customer.metadata

object

Additional metadata associated with the customer

Afficher attributs enfants

customer.metadata.{key}

string

customer.phone_number

string | null

Phone number of the customer

metadata

object

required

Additional custom data associated with the subscription

Afficher attributs enfants

metadata.{key}

string

meters

object[]

required

Meters associated with this subscription (for usage-based billing)

Afficher attributs enfants

meters.currency

enum<string>

required

Options disponibles:

AED,

ALL,

AMD,

ANG,

AOA,

ARS,

AUD,

AWG,

AZN,

BAM,

BBD,

BDT,

BGN,

BHD,

BIF,

BMD,

BND,

BOB,

BRL,

BSD,

BWP,

BYN,

BZD,

CAD,

CHF,

CLP,

CNY,

COP,

CRC,

CUP,

CVE,

CZK,

DJF,

DKK,

DOP,

DZD,

EGP,

ETB,

EUR,

FJD,

FKP,

GBP,

GEL,

GHS,

GIP,

GMD,

GNF,

GTQ,

GYD,

HKD,

HNL,

HRK,

HTG,

HUF,

IDR,

ILS,

INR,

IQD,

JMD,

JOD,

JPY,

KES,

KGS,

KHR,

KMF,

KRW,

KWD,

KYD,

KZT,

LAK,

LBP,

LKR,

LRD,

LSL,

LYD,

MAD,

MDL,

MGA,

MKD,

MMK,

MNT,

MOP,

MRU,

MUR,

MVR,

MWK,

MXN,

MYR,

MZN,

NAD,

NGN,

NIO,

NOK,

NPR,

NZD,

OMR,

PAB,

PEN,

PGK,

PHP,

PKR,

PLN,

PYG,

QAR,

RON,

RSD,

RUB,

RWF,

SAR,

SBD,

SCR,

SEK,

SGD,

SHP,

SLE,

SLL,

SOS,

SRD,

SSP,

STN,

SVC,

SZL,

THB,

TND,

TOP,

TRY,

TTD,

TWD,

TZS,

UAH,

UGX,

USD,

UYU,

UZS,

VES,

VND,

VUV,

WST,

XAF,

XCD,

XOF,

XPF,

YER,

ZAR,

ZMW

meters.free_threshold

integer<int64>

required

meters.measurement_unit

string

required

meters.meter_id

string

required

meters.name

string

required

meters.price_per_unit

string

required

Example:

"10.50"

meters.description

string | null

next_billing_date

string<date-time>

required

Timestamp of the next scheduled billing. Indicates the end of current billing period

on_demand

boolean

required

Wether the subscription is on-demand or not

payment_frequency_count

integer<int32>

required

Number of payment frequency intervals

payment_frequency_interval

enum<string>

required

Time interval for payment frequency (e.g. month, year)

Options disponibles:

Day,

Week,

Month,

Year

previous_billing_date

string<date-time>

required

Timestamp of the last payment. Indicates the start of current billing period

product_id

string

required

Identifier of the product associated with this subscription

quantity

integer<int32>

required

Number of units/items included in the subscription

recurring_pre_tax_amount

integer<int32>

required

Amount charged before tax for each recurring payment in smallest currency unit (e.g. cents)

status

enum<string>

required

Current status of the subscription

Options disponibles:

pending,

active,

on_hold,

cancelled,

failed,

expired

subscription_id

string

required

Unique identifier for the subscription

subscription_period_count

integer<int32>

required

Number of subscription period intervals

subscription_period_interval

enum<string>

required

Time interval for the subscription period (e.g. month, year)

Options disponibles:

Day,

Week,

Month,

Year

tax_inclusive

boolean

required

Indicates if the recurring_pre_tax_amount is tax inclusive

trial_period_days

integer<int32>

required

Number of days in the trial period (0 if no trial)

cancelled_at

string<date-time> | null

Cancelled timestamp if the subscription is cancelled

discount_cycles_remaining

integer<int32> | null

Number of remaining discount cycles if discount is applied

discount_id

string | null

The discount id if discount is applied

expires_at

string<date-time> | null

Timestamp when the subscription will expire

payment_method_id

string | null

Saved payment method id used for recurring charges

tax_id

string | null

Tax identifier provided for this subscription (if applicable)

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Événements Webhook d’Abonnement

Utilisation de `subscription.updated` pour la Synchronisation en Temps Réel

Schéma de Charge Utile Webhook

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

​Événements Webhook d’Abonnement

​Utilisation de subscription.updated pour la Synchronisation en Temps Réel

​Schéma de Charge Utile Webhook

Événements Webhook d’Abonnement

Utilisation de `subscription.updated` pour la Synchronisation en Temps Réel

Schéma de Charge Utile Webhook