Skip to main content
To enroll a submerchant on your platform, you need to create a Company object for each submerchant. This Company object represents the submerchant’s account and enables them to accept payments and receive payouts through your platform.

​
Getting started

Before you can enroll submerchants, you need to set up your platform account:
  1. Sign up for a platform account: Create a Company account at whop.com/dashboard
  2. Generate a Company API key: Go to your developer settings page and generate a Company API key
  3. Use the API key for authentication: This API key is how you authenticate with the Whop API and control your submerchant accounts
The Company API key provides the necessary permissions to create and manage submerchants (companies) under your platform account.

​
Creating a Company

Each submerchant requires creating a Company object through the API. The API call requires two essential pieces of information:
  • Email address: The email address of the submerchant (business or individual)
  • Title: A title or name for the submerchant account
The email address is used to identify the submerchant and send them important notifications about their account. The title is used to display the submerchant’s name in your platform and on their account.
The email address should belong to the submerchant (business or individual) who will be managing the account. This person will receive account setup and payment notifications.

​
Custom metadata

You can attach custom metadata to companies when creating them. Metadata allows you to store additional information about each submerchant as key-value pairs. This is useful for:
  • Storing your internal user or merchant identifiers
  • Tracking submerchant tiers or classifications
  • Linking to your platform’s database records
Metadata is stored on the Company object and can be retrieved later for reporting, filtering, or integration purposes.

​
API Reference

Create Company API

See the full API reference for creating companies and all available parameters

​
Example

Here’s an example of how to create a Company for a submerchant using the Python SDK: 
from whop_sdk import Whop

client = Whop(
    api_key="my_api_key",
)

company = client.companies.create(
    email="merchant@example.com",
    parent_company_id="biz_xxxxxxxxxxxxxx",
    title="Acme Corporation",
    metadata={
        "internal_user_id": 123,
        "seller_tier": "bronze",
    },
)

print(company.id)
In this example:
  • email is the submerchant’s email address
  • parent_company_id is your platform’s company ID (the parent company)
  • title is the display name for the submerchant account
  • metadata contains custom key-value pairs:
    • internal_user_id: Your platform’s internal identifier for this submerchant
    • seller_tier: A classification or tier level for the submerchant (e.g., “bronze”, “silver”, “gold”)
  • The response includes a company.id that you can use to reference this submerchant in future API calls

​
Next steps

After creating a Company for a submerchant:

Transfers

Transfer funds to your submerchants

Payouts

Configure automatic payouts for submerchants