Subscriptions

Automate recurring billing for your customers with flexible subscription plans.

How Subscriptions Work

1. Create a Product (e.g., "Premium Plan")
2. Define a Price (e.g., 50,000 XOF/month)
3. Create a Subscription linking a customer to a price
4. Ikawaari handles billing, invoicing, and payment collection automatically

Create a Subscription

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"]
  }'

Subscription Statuses

Status	Description
active	Subscription is current and paid
past_due	Payment failed, retrying
unpaid	All retry attempts exhausted
canceled	Subscription ended
trialing	In free trial period

Features

• Free trials — Offer trial periods before charging
• Proration — Automatically calculate charges when upgrading/downgrading
• Dunning — Smart retry logic for failed payments
• Webhooks — Get notified of subscription lifecycle events