Set Up Recurring Billing

Overview

Reevit's subscription engine lets you manage recurring billing across multiple providers from a single API. Create plans, enroll customers, handle upgrades/downgrades, and automate failed payment recovery (dunning), all provider-agnostic.

Key concepts

Plan: A billing template (e.g., "Pro Monthly" at GHS 50/month)
Subscription: A customer enrolled in a plan with a billing cycle
Dunning: Automatic retry logic for failed recurring charges

Create a subscription plan

Navigate to Subscriptions

From your dashboard sidebar, click Subscriptions. You'll see tabs for Plans and Active Subscriptions.

Create a plan

Click Create Plan and fill in:

Name: e.g., "Pro Plan"
Amount: The recurring charge (e.g., 5000 for GHS 50.00)
Currency: GHS, NGN, USD, etc.
Interval: Monthly, quarterly, or yearly
Trial days: Optional free trial period (e.g., 14 days)

Subscribe a customer

From the plan detail page, click Add Subscriber or use the API:

POST/v1/subscriptions

bash

curl -X POST https://sandbox-api.reevit.io/v1/subscriptions \
  -H "Authorization: Bearer sk_sandbox_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_id": "plan_abc123",
    "customer_email": "customer@example.com",
    "payment_method_id": "pm_saved_card_123"
  }'

Monitor billing cycles

Each billing cycle, Reevit automatically charges the customer's saved payment method. If the charge fails, the dunning system kicks in, retrying on the same or alternative providers based on your routing rules.

Dunning configuration

Reevit's dunning engine handles failed subscription charges:

Retry	Timing	Action
1st retry	1 day after failure	Retry same provider
2nd retry	3 days after failure	Try failover provider
3rd retry	7 days after failure	Try all available providers
Final	14 days after failure	Mark subscription as `past_due`

Cross-provider dunning

If a charge fails on Paystack, Reevit can automatically retry on Flutterwave or Stripe, dramatically improving recovery rates compared to single-provider dunning.

Subscription statuses

Status	Meaning
`trialing`	Customer is in the free trial period
`active`	Subscription is current and billing normally
`past_due`	Payment failed, dunning in progress
`canceled`	Subscription has been canceled
`paused`	Billing temporarily suspended

What's next?

Handle refunds

Process refunds for subscription charges.

Build workflows

Automate actions when subscriptions change status.

API authentication

Set up webhooks for subscription events.

Command Palette