---
title: Using Developer Tenants with Basis Theory
description: A Tenant is the first thing you create after you sign up for Basis Theory, providing the foundation for managing your token infrastructure.
image: https://blog.basistheory.com/hubfs/Imported_Blog_Media/62507e5909b9d4edd1544966_Using%20Tenants%20%20in%20Basis%20Theory.jpeg
---

[Skip to content](https://blog.basistheory.com/using-developer-tenants-basis-theory#main-content)

![Basis Theory logo](https://blog.basistheory.com/hs-fs/hubfs/BTLogo%20(1).png?width=365&height=122&name=BTLogo%20(1).png)

- [Use Cases](https://basistheory.com/)
  
  Show submenu for Use Cases 
  
    - [Creator Economy](https://basistheory.com/use-cases/creator-economy)
    - [Digital Health](https://basistheory.com/use-cases/health)
    - [E-Commerce](https://basistheory.com/use-cases/ecommerce)
    - [Fintech](https://basistheory.com/use-cases/fintech)
    - [Gaming](https://basistheory.com/use-cases/gaming)
    - [Subscription Merchants](https://basistheory.com/use-cases/subscriptions)
    - [Travel](https://basistheory.com/use-cases/travel)
    - [VSaaS](https://basistheory.com/use-cases/vsaas)
- Solutions
  
  Show submenu for Solutions 
  
    - [Agentic Commerce](https://basistheory.com/solution/agentic-commerce)
    - [Data Consolidation](https://basistheory.com/solution/data-consolidation)
    - [Monetize Payments](https://basistheory.com/solution/monetize-payments)
    - [Multi PSP](https://basistheory.com/solution/multi-psp)
    - [Payment Method Discovery](https://basistheory.com/solution/payment-method-discovery)
    - [Payment Vault](https://basistheory.com/solution/payment-vault)
- [Platform](https://basistheory.com/platform)
  
  Show submenu for Platform 
  
    - [Enrichments & Add-Ons](https://basistheory.com/add-ons)
    - [Partners](https://basistheory.com/partnerships)
    - [Why Basis Theory](https://basistheory.com/why-basis-theory)
- [Pricing](https://basistheory.com/pricing)
- Resources
  
  Show submenu for Resources 
  
    - [Blog](https://blog.basistheory.com)
    - [Case Studies](https://blog.basistheory.com/case-studies)
- [Docs](https://developers.basistheory.com/)

Open main navigation

Close main navigation

- [Use Cases](https://basistheory.com/)
  
  Show submenu for Use Cases 
  
    - [Creator Economy](https://basistheory.com/use-cases/creator-economy)
    - [Digital Health](https://basistheory.com/use-cases/health)
    - [E-Commerce](https://basistheory.com/use-cases/ecommerce)
    - [Fintech](https://basistheory.com/use-cases/fintech)
    - [Gaming](https://basistheory.com/use-cases/gaming)
    - [Subscription Merchants](https://basistheory.com/use-cases/subscriptions)
    - [Travel](https://basistheory.com/use-cases/travel)
    - [VSaaS](https://basistheory.com/use-cases/vsaas)
- Solutions
  
  Show submenu for Solutions 
  
    - [Agentic Commerce](https://basistheory.com/solution/agentic-commerce)
    - [Data Consolidation](https://basistheory.com/solution/data-consolidation)
    - [Monetize Payments](https://basistheory.com/solution/monetize-payments)
    - [Multi PSP](https://basistheory.com/solution/multi-psp)
    - [Payment Method Discovery](https://basistheory.com/solution/payment-method-discovery)
    - [Payment Vault](https://basistheory.com/solution/payment-vault)
- [Platform](https://basistheory.com/platform)
  
  Show submenu for Platform 
  
    - [Enrichments & Add-Ons](https://basistheory.com/add-ons)
    - [Partners](https://basistheory.com/partnerships)
    - [Why Basis Theory](https://basistheory.com/why-basis-theory)
- [Pricing](https://basistheory.com/pricing)
- Resources
  
  Show submenu for Resources 
  
    - [Blog](https://blog.basistheory.com)
    - [Case Studies](https://blog.basistheory.com/case-studies)
- [Docs](https://developers.basistheory.com/)
- [Get a demo](https://basistheory.com/contact)

[Login](https://portal.basistheory.com/)

[Get a demo](https://basistheory.com/contact)

 April 8, 2022

![Picture of Basis Theory](https://blog.basistheory.com/hs-fs/hubfs/bt-favicon-new.png?width=50&name=bt-favicon-new.png) [Basis Theory](https://blog.basistheory.com/author/basis-theory-team) ·

[Product](https://blog.basistheory.com/tag/product)

# Using Developer Tenants with Basis Theory

![](https://blog.basistheory.com/hubfs/Imported_Blog_Media/62507e5909b9d4edd1544966_Using%20Tenants%20%20in%20Basis%20Theory.jpeg)

A [Tenant](https://developers.basistheory.com/docs/concepts/access-controls#what-are-tenants) is the first thing you create after you sign up for Basis Theory, providing the foundation for managing your token infrastructure. Need a dedicated testing environment? Need to give customers access to their tokens or a custom reactor? Need to separate tokens based on business needs? **Tenants provide the answer.**

## What is a Tenant?

Tenants provide a flexible, secure, and logical separation of your data. You can think of a Tenant like you would a database: each Tenant acts as the container that stores your data and provides separation from other data. 

Basis Theory allows you to create as many Tenants as your business needs for free. Within each tenant, you’re able to create as many Tokens, Applications, Reactors, and other configurations enabling nearly unlimited ways to use them to separate your data. 

## Different Tenant implementation use cases

In this section, we break down the different approaches customers are using. 

Pro-tip: If you are using Terraform to manage your infrastructure, [contact us about our Terraform module](https://basistheory.com/contact) for managing your Basis Theory Tenants and Applications!

### Tenants as Staging Environments

It’s common for enterprises to have Software Development Life Cycles (SDLC) that require separate but identical systems for each stage of development. Many products in the market provide a sandbox environment to use with their production environment, but often that isn't enough for many teams. What if you need to separate your Quality Assurance (QA) data from your User Acceptance Testing (UAT) data? Some enterprises require separate environments for development, quality control, user acceptance, staging, production, and sometimes more! 

Basis Theory makes it easy to separate your integration for each environment you have, simply create one Tenant for each environment. 

![Applications and tokens are hosted in dedicated PCI level 1 compliant tenants](https://blog.basistheory.com/hubfs/Imported_Blog_Media/62507c2bad3cf228227c2203_LZ4zLGkdFvvNKDE6Q2ZxYnwJ5g478Lpyupze4nV36duLW_0FzkQ13r4sF0cMJJRGUyZdmpAovYDyHIPR0YgxNvo3HcKgiPB7d2U-ejUZdCcmNX8zR0m2YrHMk-Hex.png)

### Tenants Separated by Business Unit Data

Separating data between development, testing, and production isn't the only use for Tenants. You can use the same approach for separating business units. 

For example, an accounting department may require its own storage area with data that should be inaccessible to other departments. Creating a separate “Organization Tenant” would solve this issue without needing to sign up twice and without the additional overhead of managing two unique Organizations at Basis Theory.

![Example developer tenant implementation showing business unit, staging environments, and customer data](https://blog.basistheory.com/hubfs/Imported_Blog_Media/62507c399f481857459344c4_xGOU8f1qV00zzunpQYVC1eEDwwAVyhW8RCZ6egla96JXpTPz0nPEuvc-mmcRT9t4LPWAMPU3WzCa9DG12fbW0O5MCb20LL3q8HqdT8EGNLveiOYt_IRk74LT9on1I.png)

### Segmenting Data by an Organization’s End User

For some organizations, it makes sense to separate their data by customer. This is especially valuable for companies that sell platform services to other businesses—whom, in turn—have their own End Users. 

Imagine you work for Acme Auctions, which sells a complete out-of-the-box auction marketplace to homebuilders (Acme Auctions customers) looking to bid out jobs to subcontractors. Aside from the bidding functionality, Acme Auction offers its customers other components, like user administration, and pay-in / pay-out functionality for subcontractors. The homebuilders who purchase the auction marketplace will need to be able to work with their Tokens without having access to Tokens from other homebuilders.

There are several benefits to managing your Tokens this way. By separating the Tokens by customer Acme Auctions can safely give Application Keys to the homebuilders. Each Application can only access the data within its Tenant, eliminating the risk of exposing other data, while still giving each homebuilder the ability to leverage the full power of Basis Theory’s Reactors, Proxy, and more.

Are you interested in trying Basis Theory? [Getting started](https://portal.basistheory.com/register) takes a few clicks and is entirely free. Have questions? Join our [Slack community](http://basis-theory.slack.com/) or reach out via our [contact us form](https://basistheory.com/contact)!

[![View an Interactive Demo   See how the Basis Theory platform secures payment data and significantly reduces PCI compliance burden from day 1.  ](https://no-cache.hubspot.com/cta/default/22332934/interactive-171495116167.png)](https://blog.basistheory.com/hs/cta/wi/redirect?encryptedPayload=AVxigLL2GhyLW%2FMH%2BkHoeVYLScHzJ6enKaUFyia%2Fsj%2BtlT5YtvvGWyLNxKSkNzHxwFt7L68I7B8xUUXtIxsPpIX3UiNd3iGPbvvbWYqWGnU%2F6w1vMiHjiiibHkB2j99ehR%2BBAcFomxPny4u8snyj2AOZM1bdaCAIOmvNqTBJ4Ipn5htURx%2Bc0Oj%2BjACWmhzEF%2FgRAddS3S7eXkj%2BT1MOPT4yyE%2BrGgcHvOJrU38g29ho%2FZTOxq49RNWleQ%3D%3D&webInteractiveContentId=171495116167&portalId=22332934)

## Related posts

[![December 2025 Changelog](https://blog.basistheory.com/hubfs/Dec25%20Jan26.webp)](https://blog.basistheory.com/december-2025-changelog)

[Engineering](https://blog.basistheory.com/tag/engineering)

### [December 2025 Changelog](https://blog.basistheory.com/december-2025-changelog)

![Picture of Basis Theory](https://blog.basistheory.com/hs-fs/hubfs/bt-favicon-new.png?width=50&name=bt-favicon-new.png) [Basis Theory](https://blog.basistheory.com/author/basis-theory-team) 

 January 23, 2026

[Read more](https://blog.basistheory.com/december-2025-changelog)

[![March 2026 Changelog](https://blog.basistheory.com/hubfs/March%202026.webp)](https://blog.basistheory.com/march-2026-changelog)

[Product](https://blog.basistheory.com/tag/product)

### [March 2026 Changelog](https://blog.basistheory.com/march-2026-changelog)

![Picture of Brian Gonzalez](https://blog.basistheory.com/hs-fs/hubfs/Imported_Blog_Media/62b1da642fc5a096fc91429e_Gonzo.jpg?width=50&name=62b1da642fc5a096fc91429e_Gonzo.jpg) [Brian Gonzalez](https://blog.basistheory.com/author/brian-gonzalez) 

 April 24, 2026

[Read more](https://blog.basistheory.com/march-2026-changelog)

[![Getting started with Basis Theory React](https://blog.basistheory.com/hubfs/Imported_Blog_Media/61f93624fb062349c7777415_How%20to%20encrypt%20data%20in%20react.jpeg)](https://blog.basistheory.com/encrypting-data-react-applications)

[Engineering](https://blog.basistheory.com/tag/engineering)

### [Encrypting data in React applications with Basis Theory](https://blog.basistheory.com/encrypting-data-react-applications)

![Picture of Davi Aquino](https://blog.basistheory.com/hs-fs/hubfs/Davi-Square.jpg?width=50&name=Davi-Square.jpg) [Davi Aquino](https://blog.basistheory.com/author/davi-aquino) 

 January 28, 2022

[Read more](https://blog.basistheory.com/encrypting-data-react-applications)

## Stay Connected

### Receive the latest updates straight to your inbox

### Follow on Social

<https://www.linkedin.com/comm/mynetwork/discovery-see-all?usecase=PEOPLE_FOLLOWS&followMember=colinthomasluce>

[![BTLogo (1)](https://blog.basistheory.com/hs-fs/hubfs/BTLogo%20(1).png?width=138&height=46&name=BTLogo%20(1).png "BTLogo (1)")](https://basistheory.com)

- Use Cases 
    - [Creator Economy](https://basistheory.com/use-cases/creator-economy)
    - [Digital Health](https://basistheory.com/use-cases/health)
    - [E-Commerce](https://basistheory.com/use-cases/ecommerce)
    - [Fintech](https://basistheory.com/use-cases/fintech)
    - [Gaming](https://basistheory.com/use-cases/gaming)
    - [Remittance](https://basistheory.com/use-cases/remittance)
    - [Subscription Platforms](https://basistheory.com/use-cases/subscriptions)
    - [Online Travel Agencies](https://basistheory.com/use-cases/travel)
    - [Vertical SaaS](https://basistheory.com/use-cases/vsaas)
- Developers 
    - [Quickstart](https://developers.basistheory.com/getting-started)
    - [Elements](https://developers.basistheory.com/docs/sdks/web/javascript)
    - [Documentation](https://developers.basistheory.com/)
- Basis Theory 
    - [Pricing](https://basistheory.com/pricing)
    - [Add-Ons](https://basistheory.com/add-ons)
    - [ROI Calculator](https://go.basistheory.com/roi)
    - [Case Studies](https://blog.basistheory.com/case-studies)
    - [Blog](https://blog.basistheory.com)
    - [Contact](https://basistheory.com/contact)
- Other 
    - [Terms and Conditions](https://basistheory.com/resources/terms-of-service)
    - [Privacy Policy](https://basistheory.com/resources/privacy-policy)
    - [Cookie Policy](https://basistheory.com/resources/cookie-policy)
    - [Security](https://basistheory.com/security)
    - [System Status](https://status.basistheory.com/)
- Compare 
    - [Basis Theory Vs. Evervault](https://go.basistheory.com/evervault-alternative)
    - [Basis Theory Vs. IXOPAY](https://go.basistheory.com/alternative-to-ixopay)
    - [Basis Theory Vs. VGS](https://go.basistheory.com/compare/very-good-security)

---

```json
{
  "@context" : "https://schema.org",
  "@type" : "BlogPosting",
  "author" : {
    "@type" : "Person",
    "name" : "Basis Theory",
    "url" : "https://blog.basistheory.com/author/basis-theory-team"
  },
  "dateModified" : "2026-10-23T19:58:08.316Z",
  "datePublished" : "2022-04-08T04:00:00.000Z",
  "headline" : "Using Developer Tenants with Basis Theory",
  "image" : [ "https://blog.basistheory.com/hubfs/Imported_Blog_Media/62507e5909b9d4edd1544966_Using%20Tenants%20%20in%20Basis%20Theory.jpeg" ],
  "mainEntityOfPage" : {
    "@id" : "https://blog.basistheory.com/using-developer-tenants-basis-theory",
    "@type" : "WebPage"
  },
  "publisher" : {
    "@type" : "Organization",
    "logo" : {
      "@type" : "ImageObject",
      "url" : "https://blog.basistheory.com/hubfs/BTLogo%20(1).png"
    },
    "name" : "Basis Theory"
  }
}
```