Cycle de vie de l’abonnement

Diagramme d’état

trialing → active → past_due → unpaid → canceled
              ↘ canceled

Événements

Événement	Description
subscription.created	Nouvel abonnement créé
subscription.updated	Abonnement modifié (changement de plan, etc.)
subscription.trial_will_end	La période d’essai se termine dans 3 jours
invoice.payment_succeeded	Paiement récurrent réussi
invoice.payment_failed	Paiement récurrent échoué
subscription.canceled	L’abonnement a pris fin

Upgrade / Downgrade

Mettez à jour le prix de l’abonnement pour changer de plan :

curl -X PATCH https://api.ikawaari.com/v1/subscriptions/sub_abc123 \
  -H "Authorization: Bearer ik_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [{ "id": "si_abc123", "price": "price_new_plan" }],
    "proration_behavior": "create_prorations"
  }'

Annulation

curl -X DELETE https://api.ikawaari.com/v1/subscriptions/sub_abc123 \
  -H "Authorization: Bearer ik_test_your_key"

Par défaut, l’annulation prend effet à la fin de la période de facturation courante. Définissez cancel_at_period_end: false pour une annulation immédiate.