Aller au contenu principal

Créer un abonnement

Prérequis​

  • Un Client avec une méthode de paiement enregistrée
  • Un Produit et une configuration billing compatible

Étape 1 : Créer un produit​

curl -X POST https://api.ikawaari.com/api/v1/merchant/products \
  -H "Authorization: Bearer ik_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Plan Premium", "description": "Accès complet à toutes les fonctionnalités" }'

Étape 2 : Préparer la configuration billing​

La famille /api/v1/prices n’est pas exposée actuellement. Utilisez les champs billing acceptés par /api/v1/billing/subscriptions et vérifiez la référence générée avant d’ajouter un exemple de prix autonome.

Étape 3 : Créer l’abonnement​

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

Avec une période d’essai gratuite​

{
  "customer": "cus_abc123",
  "items": [{ "price": "price_abc123" }],
  "trial_period_days": 14
}