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 https://api.ikawaari.com/api/v1/billing/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 POST https://api.ikawaari.com/api/v1/billing/subscriptions/{id}/cancel \
  -H "Authorization: Bearer ik_test_your_key"

Les mises à jour détaillées d’un abonnement ne doivent pas être documentées comme PATCH tant que la référence générée ne publie pas cet endpoint.