Environments

Kable operates in two distinct environments, Live and Test .

Live

The Live environment is for your production traffic and customers' production usage.

All usage in the Live environment is billable. Your customers' traffic in the Live environment will be billed according to their plans. Your net traffic in the Live environment will be considered billable by Kable.

Test

The Test environment is for non-production traffic. You may use the Test environment for your own development purposes while building and testing your integration with Kable. You may also use the Test environment within your own customer-facing Test or Sandbox environment to monitor your customers' Test usage.

Usage in the Test environment is not billable. Kable will never charge your customers nor you for traffic in the Test environment.

🚧
If you need require access to additional environments beyond Live and Test, please reach out at [email protected] for Enterprise support.

Domain Models

Each of Kable's core domain models exists in one or both Environments. The following table provides an overview of how each domain model interacts with the Live and Test environments:

Domain Model	Environment
Company	Your Company account and corresponding `kableClientId` exists across Live and Test environments.
API Keys	API keys exist in a single environment. Your Live API keys cannot be used in the Test environment, nor your Test API keys in the Live environment.
Usage Events	Usage events are recorded in a single environment -- each event is recorded in either the Live or Test environment.
Dimensions	Dimensions exist across Live and Test environments. A single Dimension may be used to record usage events in each environment.
Plans	Plans exist across Live and Test environments. You can add the same plan (`pln_12345`) to customers in the Live or Test environments.
Bundles	Bundles exist across Live and Test environments. You can add the same bundle (`bun_67890`) to customers in the Live or Test environments.
Customers	Customers exist in a single environment. You may create a Live and Test customer with the same `clientId`, but each will live in isolation in a single environment, and each will have a unique `customerId` assigned.
Customer Plans	Customer Plans exist in a single environment, determined by the customer's environment.
Customer Bundles	Customer Bundles exist in a single environment, determined by the customer's environment.
Credits	Credit Grants exist in a single environment, determined by the customer's environment.
Invoices	Invoices exist in a single environment. Invoices generated in the Live environment consider only Live usage events and Live credits. Only Live Invoices are processed through accounting integrations.
Payment Integrations	Payment integrations exist in a single environment. Kable Live customers should be mapped to Stripe Live customers, while Kable Test customers should be mapped to Stripe Test customers.
Accounting Integrations	Accounting integrations exist only in the Live environment. Customer Accounting Integrations are disabled in the Test environment. If you map your Customer to a QuickBooks or Xero customer, you should map a Live reference ID.