Skip to main content
Apps allow you to manage multiple products or services within a single Organization. Each App acts as a logical container for Plans, Subscriptions, Customers, Invoices, and configurations.

​
Use Cases

  • Multiple Products: If you are a developer and want to sell a “Hello World App” and an “Invoice generator” separately, each can be an App. This is the most common use case and one we recommend.
  • Regional Segregation: If you have “Uganda” and “Kenya” versions of your product with different pricing structures.

​
App-Level Settings

Each App can have its own:
  • Payment Providers: Connect Flutterwave, PawaPay, Pesapal, or DPO. You can always see their availability status as you create an app. Each app can only have one payment provider at a time.
  • Webhooks(Outgoing and Incoming): Listen to events specific to that app.
  • Default Currency: Set the default currency for plans and invoices within that app.
  • Grace Periods: The time period after a subscription expires during which the customer can still access the service.
  • Timezone: Set the timezone for billing cycles and invoice generation.
  • API Keys: Generate API keys scoped to that specific app for secure access.

​
API Keys

When making API requests, your API key determines which app is being accessed. Usually, API keys are scoped to a specific App: 
# API key scoped to a specific app
Authorization: Bearer sk_Jnowe123..
If your organization has access to multiple apps, you can manage different API keys for different apps in the Dashboard under Settings → API Keys.
Team members with access to an organization can see and manage all apps within that organization. Ensure you assign appropriate roles to team members based on the apps they need to access.