Plans, subscriptions and billing
Managed in ImpartLab.Manager by platform operators.
Create a subscription plan
- Go to Manager → Subscription plans and select New plan.
- Set the plan name, price, billing interval (monthly / annual) and any user or feature limits.
- Select Save.
Assign a plan to a tenant
- Go to Manager → Tenants and open the tenant.
- Select the Subscription tab.
- Choose a plan and set the start and expiry dates.
- Select Save.
Subscription expiry
The expiry service runs every SUBSCRIPTION_CHECK_INTERVAL_HOURS hours (default: 24). When a subscription expires:
- The tenant's API access is blocked for all users.
- A notification email is sent to the tenant's admin email address, or to
BILLING_NOTIFICATION_EMAILif no admin email is set.
To restore access, extend the subscription expiry date or assign a new plan.
Paystack integration
ImpartLab.Manager integrates with Paystack for online payments. Configure the following environment variables:
| Variable | Description |
|---|---|
PAYSTACK_SECRET_KEY | Paystack secret key; also verifies webhook HMAC-SHA512 signatures |
PAYSTACK_CALLBACK_URL | Return URL after checkout |
BILLING_NOTIFICATION_EMAIL | Fallback recipient for expiry notices |
Paystack webhooks are verified automatically using HMAC-SHA512. Do not expose the secret key.
Tenant status enforcement
When TENANT_STATUS_ENFORCEMENT=true (default), the ResourceServer and VC server reject authenticated requests from tenants that are inactive, have no subscription, or whose subscription has expired. Set to false temporarily to bypass enforcement during maintenance.