How to add a Terra billing account user to your Google billing account

Please follow these steps to add terra-billing@terra.bio as a Billing Account User to your Google Billing Account.

NOTE: In order to be able to complete the instructions below, you must already be a Billing Account Administrator on the Google billing account. This will automatically be true if you are the person who created the Google billing account. If you are not already a billing account administrator, you should contact someone who is a billing account administrator on the account in question, and ask them to add you. This may be the PI or business administrator in your office, or in certain specific situations it may be someone within a third party billing entity, such as with Terra's free credit accounts, which are administered by Onix.

1. Go to the Google Cloud Console page.
2. Navigate to the Google project aligned to the Google billing account you will use for Terra. You can do this at the top of the page next to the Google Cloud Platform logo.
3. Click Billing from the hamburger menu.
4. A new window will open. On the right panel, below "Permissions" and will see "Add Members." Add terra-billing@terra.bio and select the role Billing Account User. Click Add.

How to remove Terra billing account user

Please do not remove the Billing Account User until after you create a Terra Billing Project. To remove the Terra Billing Account User from your account, click on the trash can icon next to terra-billing@terra.bio on your billing account page.

How to find your Google billing account ID

To find Google Billing Account information, navigate to the Google Developers Console Billing page and click on Billing. Look for the number below Billing Account ID.

How Terra project OWNERS can change a project's Google billing account

There are times when you may need to change the Google billing account associated with a billing project in Terra (note that the Terra billing project can be used on many workspaces). An example would be if there was a change to the funding source for the project. If you have OWNER permissions for the project, you can follow the following steps to change the billing account:

1. Go to the Billing page:

2. Select a billing project for which you are an owner from the list on the left hand side of the screen. You will see details.

3. There will be a "change account" button:

4. Click that button, and you will see a list of all the google billing accounts you have access to. Select the one you want to use with the project. 

5. Click “OK”

6. Your project is now funded by the chosen account!

How to create a new Terra billing project

After you set up a Google billing account, you can create a new Terra Billing Project through the Billing Management Screen in the Terra UI.

Steps to Create a New Terra Billing Project:

1. In the Terra UI, click on the User Profile drop-down menu and select Billing.

2. Click on Create New Billing Project.

If prompted, Click Here to Enable Billing Permissions, select a Google identity under which you created a Google billing account, and click Allow. This enables Terra to access Google Billing Accounts associated with your Terra account.

3. Enter a unique name for your Terra Billing Project. Then, select the Google Billing Account that you want to tie to your Terra Billing Project, and click OK.

The name of the Terra Billing Project must

• only contain lowercase letters, numbers and hyphens;

• start with a lowercase letter;

• not end with a hyphen;

• be between 6 and 30 characters; and

• be unique across all Google Billing Projects.

Note: You may see multiple Google Billing Accounts that you can select for this Terra Billing Project. If you need to locate a Google Billing Account ID, navigate to the Google Developers Console and click on Billing. Look for the number below Billing Account ID.

Using Terra without a Terra billing project

You do not necessarily need access to your own Terra Billing Project to use Terra. Tutorial workspaces with open access data will be available to view after your register.

In addition, if a Terra user, such as a collaborator or PI, shares a workspace with you and grants you WRITER access, you can compute within that workspace. All charges incurred for that workspace will be tracked through the workspace owner’s Terra Billing Project.

Adding users to a Terra billing project

When you create a new Terra Billing Project, you are automatically designated as the Owner. If lab or team members want to create or clone new workspaces, you can grant them access to any Terra Billing Project of which you are the Owner. First, your lab and team members must independently register as Terra users.

Refer to the instructions below to manage Billing Project Users and Owners:

1. In the Terra UI, click on the User Profile drop-down menu and select Billing.

2. Click on the Terra Billing Project to which you want to add users. You must be an Owner of that Billing Project to add users.

3. To add a new user, click on Add User… Note that the user must first be registered for Terra.

4. In the pop-up window, enter the user’s Terra email address. The system will add the person as a User by default. if you wish for that person to have greater control, click the checkbox labeled "Owner". Owners can add additional users on this Terra Billing Project. Users can also create workspaces charged to this Billing Project, but can not add other users.