Abonnements

Automatisez la facturation récurrente pour vos clients avec des plans d’abonnement flexibles.

Fonctionnement des abonnements

1. Créez un Produit (par ex. "Plan Premium")
2. Définissez un Prix (par ex. 50 000 XOF/mois)
3. Créez un Abonnement liant un client à un prix
4. Ikawaari gère automatiquement la facturation, les factures et la collecte des paiements

Créer un abonnement

curl -X POST https://api.ikawaari.com/v1/subscriptions \
  -H "Authorization: Bearer ik_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": "cus_abc123",
    "items": [
      { "price": "price_premium_monthly" }
    ],
    "payment_method_types": ["mobile_money", "card"]
  }'

Statuts d’abonnement

Statut	Description
active	L’abonnement est à jour et payé
past_due	Le paiement a échoué, nouvelle tentative en cours
unpaid	Toutes les tentatives de reprise ont été épuisées
canceled	L’abonnement est terminé
trialing	En période d’essai gratuite

Fonctionnalités

• Essais gratuits — Proposez des périodes d’essai avant facturation
• Proration — Calculez automatiquement les ajustements lors des upgrades/downgrades
• Dunning — Logique intelligente de retry pour les paiements échoués
• Webhooks — Soyez notifié des événements du cycle de vie des abonnements