---
updatedAt: 2026-06-16T17:01:10.000Z
agentTools:
  projectIndex: https://developer.bill.com/llms.txt
---

# BILL Network sandbox setup

The BILL sandbox environment is a standalone test environment. Before you can test the BILL Network workflow with the API, you must add a vendor organization to the BILL Network.

In this example workflow, to search for a vendor organization named `Happy Music Supplies` in the BILL Network, follow the steps in this section to add a vendor organization named `Happy Music Supplies` to the BILL Network in your sandbox environment.

> 👍 Sandbox limitation
>
> You cannot connect with international (not US) vendors in the BILL sandbox environment. This operation is available in the production environment.

## Set up a vendor record in your BILL organization

Sign in to the BILL web app in your sandbox environment.

1. Click **Vendors** in the navigation menu.
2. Click **Add Vendor**.
3. Enter vendor details and click **Continue**.

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Field
      </th>

      <th>
        Detail
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Vendor name
      </td>

      <td>
        **`Happy Music Supplies`**
      </td>
    </tr>

    <tr>
      <td>
        Address
      </td>

      <td>
        **`123 Main Street`**
      </td>
    </tr>

    <tr>
      <td>
        City
      </td>

      <td>
        **`San Jose`**
      </td>
    </tr>

    <tr>
      <td>
        State
      </td>

      <td>
        **`CA`**
      </td>
    </tr>

    <tr>
      <td>
        ZIP code
      </td>

      <td>
        **`95002`**
      </td>
    </tr>

    <tr>
      <td>
        Vendor email
      </td>

      <td>
        Enter a valid email address.

        Set an email address that is not your username. BILL sends an invitation to this email address for signing up to create a free BILL account as **`Happy Music Supplies`**.
      </td>
    </tr>
  </tbody>
</Table>

4. In the next step, click **Invite vendor (recommended)**, and then click **Continue**.
5. Under **Review vendor details**, click **Save vendor**.

At this point, a vendor record is set up in your BILL organization.

## Accept invitation by email

When BILL sends an invitation to the provided email address, accept the invitation for signing up to create a free BILL account as `Happy Music Supplies`.

1. Enter any first name and last name, and set a password.
2. Complete the MFA security requirements. Enter a mobile number and click **Send code**. BILL sends a six-digit code to the mobile number.
3. Enter the six-digit code sent to the mobile number.
4. In the next step, BILL provides additional features as part of the sign-up process. For this setup, click **No, skip this**.
5. Enter vendor business details and click **Submit**.

| Field                                        | Detail                                                                                     |
| :------------------------------------------- | :----------------------------------------------------------------------------------------- |
| Business type                                | You can set this value as any business type. For example, **`Corporation`**.               |
| Legal company name or full name              | Leave the value as **`Happy Music Supplies`**                                              |
| Business phone                               | Enter a valid phone number                                                                 |
| Business address line 1                      | **`123 Main Street`**                                                                      |
| City                                         | **`San Jose`**                                                                             |
| State                                        | **`CA`**                                                                                   |
| Zip code                                     | **`95002`**                                                                                |
| Industry                                     | You can set this value as any industry. For example, **`Retail Shop or Online Commerce`**. |
| Accounting software                          | Set as **`I don't use accounting software`**                                               |
| Business owner's legal full name             | Leave this value as **`AGATHA FFRINGE`**                                                   |
| EIN (9-digit Employer Identification Number) | You can set this value as any nine-digit number. For example, **`999888777`**.             |

7. In the next step, BILL provides the option to accept virtual card payments. For this setup, click **No, Use Bank Transfers**.
8. Enter vendor bank account details and click **Save and finish**.

| Field                        | Detail                                                                                                    |
| :--------------------------- | :-------------------------------------------------------------------------------------------------------- |
| Account holder name          | Leave the value as **`Happy Music Supplies`**                                                             |
| Account type                 | Leave the value as **`Business Checking`**                                                                |
| Routing number (9 Digits)    | You can set this value as any valid number. For example, **`074000010`**.                                 |
| Bank name                    | When you enter the routing number, the bank name is set as **`JPMorgan Chase Bank National Association`** |
| Account number (4-17 Digits) | You can set this value as any number. For example, **`123456789`**.                                       |
| Re-enter account number      | Re-enter the same account number                                                                          |

9. Select **Standard-ACH delivery** as the payment speed, and click **Save payment speed**.

The vendor setup is complete, and `Happy Music Supplies` is added to the BILL Network in your sandbox environment.

## Complete identity verification

> 👍 Identity verification may be optional
>
> If you do not see the option to verify your identity, this free BILL account does not require you to complete identity verification.

In the free BILL organization that is created for `Happy Music Supplies`, complete identity verification to enable electronic payments.

1. Click **Overview** in the navigation menu.
2. Click **Verify my identity** to begin the verification process.
3. Click **Answer questions** in the **Choose how to verify** modal.
4. Enter identity information and click **Continue**.

| Field        | Detail                                                                |
| :----------- | :-------------------------------------------------------------------- |
| First Name   | Leave this value as the first name you set while creating the account |
| Last Name    | Leave this value as the last name you set while creating the account  |
| Home Address | **`123 Main Street`**                                                 |
| City         | **`San Jose`**                                                        |
| State        | **`CA`**                                                              |
| Zip Code     | **`95002`**                                                           |

5. Select the final option for each question in step two of the verification process and click **Continue**.

The identity verification process is complete. Continue the BILL Network workflow with <Anchor label="Connect with a vendor in the BILL Network" target="_blank" href="doc:connecting-with-a-bill-network-vendor">Connect with a vendor in the BILL Network</Anchor>.