Billing & Subscription Entitlements
The single source of truth for payment processing, seat allocations, plan upgrades, automated invoicing via Paystack, and real-time subscription lifecycle webhooks.
1. Overview & Payment Rails
Kontyra integrates with Paystack to deliver dual-currency billing (USD and NGN) across card rails, direct bank transfers, and Apple Pay with automated recurring billing and proration.
Instant privilege elevation across all microservices upon payment authorization
User or Org Billing Admin initiates plan upgrade or adds developer seats.
Card details encrypted and processed through 3D Secure / tokenized recurring authorization.
Paystack notifies Kontyra API gateway; updates organization subscription document in Firestore.
New quotas and tier badges immediately injected into active RS256 JWT claims.
2. Subscription Tiers & Entitlements
Choose the subscription tier that matches your engineering workload:
For hobbyists and individual learners.
- • 1 Concurrent DevOS Sandbox
- • Shared Community API Gateway
- • Public VUX Events Only
- • Standard Community Support
For active full-stack engineers and creators.
- • Unlimited DevOS Sandboxes
- • Custom Edge Subdomains
- • 10,000 API Req / Month
- • Priority Support Channel
For engineering teams and growing startups.
- • Organization Multi-Tenancy & RBAC
- • Departmental Scoping & Shared Repos
- • Tamper-Resistant Audit Trail
- • Centralized Corporate Invoicing
For enterprises requiring custom security & SLAs.
- • Dedicated VPC Execution Nodes
- • 99.99% Uptime SLA Guarantee
- • SAML / Okta SSO Enforcement
- • Dedicated Solutions Architect
3. Seat-Based Pricing & Invoicing
Organizations are billed on an active seat model. When an administrator invites a new developer, the billing system recalculates the monthly pro-rated amount and charges the on-file corporate payment method. Invoices and VAT receipts are delivered directly via email from billing@kontyra.name.ng.
4. Customer Portal Sessions
Generate an authenticated Paystack customer portal session allowing users to update card details, download historical PDF invoices, or switch plans:
curl -X POST https://api.kontyra.name.ng/v1/billing \
-H "Authorization: Bearer test-kontyra-key" \
-H "Content-Type: application/json" \
-d '{
"action": "create_portal_session",
"returnUrl": "https://console.kontyra.name.ng/settings/billing"
}'5. Billing Webhook Lifecycle
The platform processes Paystack webhooks to react to billing lifecycle changes:
Renews monthly quota and unlocks premium features.
Triggers 3-day grace period email before downgrading sandboxes.
Reverts account to Community Free tier at conclusion of billing cycle.
6. Billing REST API Reference
Queries active tier, seat counts, and payment method details.
Creates checkout sessions or customer portal management links.