API sandbox bank account setup

Set up a test bank account in the API 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.

📘

NOTE

Money movement to and from live bank accounts is not available in API sandbox. You can set up a test bank account in API sandbox for submitting test payments.

Adding a test bank account in API sandbox

You can add test bank accounts with the BILL sandbox web app.

❗️

IMPORTANT

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

Initiate setup

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

  1. Sign in to the BILL sandbox web app. Use your developer account email address and password.
  2. Click Settings in your BILL account.
  3. Click Bank Accounts under Bank & Payment Accounts.
  4. Click SET UP NEW BANK. You are prompted to verify your identity.
  5. Click Answer questions in the Choose how to verify modal.
  6. 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 verification question and click Continue. The questions help with completing the verification process in the sandbox environment.

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

Completing 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 to log in. You are redirected to a test First Platypus Bank sign in page. This is a test bank account 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 (for example, 111111) and click Submit.
  6. On the Connect account information page, select Plaid Checking (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 on the Plaid success modal.
  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 API 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 > Roles & Permissions > Users.

Adding a test credit card in API sandbox

You can add test credit cards with the BILL sandbox web app.

  1. Sign in to the BILL sandbox web app. Use your developer account email address and password.
  2. Click Settings in your BILL account.
  3. Click Card Accounts under Bank & Payment Accounts.
  4. Click Add New Card. The Add a card modal appears.
  5. Add test credit card information and click Continue.
FieldDetail
Name on CardGEORGE OLLERICH
Card number4111 1111 1111 1111
Expiration12/28 (or any expiration date in the MM/YY format)
Security999
Billing informationYou can select Use address from profile for populating existing profile information from your API sandbox account. You can also set the address information manually.

- Country: United States
- Address line 1: 1509 85TH ST N
- City: BIRMINGHAM
- State / Province Alabama [AL]
- Zip / Postal code: 43206

At this point, the test credit card is added to the list of card accounts.

❗️

IMPORTANT

You can use our test bank account or test credit card for setting up a subscription for your sandbox developer account. When the trial period for your sandbox account is over, you can use the same test credit card to continue using your account.

  1. Click Settings in your BILL account.
  2. Click My Subscription under Billing & Subscription.
  3. Click Subscribe.
  4. On the Subscription summary page, click Add Payment Method & Subscribe. Use the test bank account or test credit card information to set up a subscription.