Sandbox bank account setup

Set up a test bank account in the sandbox environment to test and build with the BILL API.

Sandbox is a standalone environment and any testing with the API in sandbox does not affect your solution in the production environment.

You have access to all BILL API services in sandbox with three exceptions.

  • BILL integrations with other accounting softwares is not available in sandbox.
  • Money movement to and from live bank accounts is not available in sandbox.
  • The BILL Intelligent Virtual Assistant (IVA) is not available in sandbox. See Bills detected by Intelligent Virtual Assistant (IVA) in the BILL Help Center for more information.

While money movement to and from bank accounts is not available in the sandbox environment, you can set up a test bank account in sandbox for submitting test payments.

🚧

IMPORTANT

Any BILL pricing plan or subscription is not charged in the sandbox environment.

Add a test bank account in sandbox

After your sandbox sign-up is complete, you can add test bank accounts with the BILL sandbox web app.

Initiate setup

The bank account setup process begins with ensuring that your sandbox account includes address information.

  1. Sign in to the BILL sandbox web app. Use the email address and password you created as part of the sign-up process.
  2. Click SETTINGS at the top-right of your BILL account.
  3. Click Bank Accounts under Your Company.
  4. Click SET UP NEW BANK.
  5. OPTIONAL STEP: If you are prompted to go through verify your identity, complete the two-step verification process. Enter the provided test name and address information and click Continue.
FieldDetail
First NameGEORGE
Last NameOLLERICH
Home Address1509 85TH ST N
CityBIRMINGHAM
StateAL
Zip Code35206
  1. Select the final option for each question in step two of the verification process and click Continue.

At this point, you are prompted to use Plaid and complete your setup.

Complete setup with Plaid

BILL uses Plaid to connect with bank accounts.

  1. Click Continue when you are prompted to use Plaid and complete your setup.
  2. Select any bank and click Continue. You are redirected to a test First Platypus Bank sign in page.
  3. Enter the provided test credentials and click Sign in.
    • Username: user_good
    • Password: pass_good
  4. On the Verify your identity page, click Get code.
  5. On the Verification page, enter any code number and click Submit.
  6. On the Connect account information page, select Checking account (and any other accounts you want to add) and click Continue.
  7. On the Connect account information - Confirm page, accept the Terms and Conditions and click Connect account information. You are redirected to continue with your Plaid setup.
  8. Click Continue.
  9. Select the accounts you want to add, enter the provided test information, and click Continue.
    • Account Type: Business Checking
    • Account Holder Name: GEORGE OLLERICH
  10. If this is the first time you are adding a test bank account, you are prompted to enter an additional set of test information.
    • Company owner: GEORGE OLLERICH
    • Business type: Corporation
    • Industry: Accounting or Bookkeeping
    • Tax ID type: EIN
    • Tax ID number: 999888777 (or any test Tax ID number)
  11. Click Continue. The selected test bank accounts are added to your sandbox account.

After adding a test bank account, you can assign the account to test users for them to pay bills. Assign the account to test users under SETTINGS > Permissions > Users.