Environments

Interacting with Kable's Live and Test 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.

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 ModelEnvironment
CompanyYour Company account and corresponding kableClientId exists across Live and Test environments.
API KeysAPI 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 EventsUsage events are recorded in a single environment -- each event is recorded in either the Live or Test environment.
DimensionsDimensions exist across Live and Test environments. A single Dimension may be used to record usage events in each environment.
PlansPlans exist across Live and Test environments.
BundlesBundles exist across Live and Test environments.
CustomersCustomers exist across Live and Test environments. You can record distinct Live and Test events in each environment for a single Customer.
Customer PlansCustomer Plans exist across Live and Test environments. When you add a Plan to a Customer, it takes effect in both Live and Test environments. (Any credits generated as a result of adding a subscription plan to a customer will be generated in the Live environment)
CreditsCredit grants exist in a single environment. Credits can only be used in the environment in which they were created. Because payment integrations only exist in the Live environment, Credits with a chargeAmount are only allowed in the Live environment.
InvoicesInvoices 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 payment and accounting integrations.
Payment IntegrationsPayment integrations exist only in the Live environment. If you map your Customer to a Stripe customer, you should map a Live Stripe customer ID.
Accounting IntegrationsAccounting integrations exist only in the Live environment. If you map your Customer to a QuickBooks or Xero customer, you should map a Live reference ID.