Table of contents

Set up billing to pay for more Visual Studio Team Services users and services

Last Updated: 9/26/2016

Team Services

You only have to set up billing when you need to add more than the free amounts of users and team services that you get with your Team Services account. For example, set up billing when you want to add more than the free or unlimited users that are included with your account, or when your account has no more free monthly build minutes to finish your deployment. Learn more about Team Services users and additional services.

If you make purchases from the Visual Studio Marketplace for your Team Services account, the Visual Studio Marketplace will help you set up billing during your first purchase.

To change the Azure subscription that's linked to your Team Services account, unlink your Team Services account, then relink your account to another Azure subscription.

What do I need to set up billing?

Microsoft Azure handles billing for your Team Services account, so you'll need:

You can follow the steps for the Azure classic portal or Azure portal. Both portals give you the same results.

Azure classic portal

  1. Sign in to the Azure classic portal as Team Services account owner and as Azure subscription Co-administrator or greater.

    If you experience browser problems with Azure, make sure that you use a supported browser.

  2. Go to Visual Studio Team Services. Start linking your account.

    Link your Team Services account to your Azure subscription

  3. Go to Link to Existing. Select your Team Services account, if you have multiple accounts.

    Select Team Services account and Azure subscription

    Why don't my options look the same?

    If you have multiple subscriptions, you can also select an Azure subscription.

    Select Team Services account and Azure subscription

  4. Finish linking your account.

    After Azure sets up the link, your Team Services account appears linked to your Azure subscription.

    Your Team Services account appears in the Azure classic portal

    Need help?

Next

Azure portal

  1. Sign in to the Azure portal as Team Services account owner and as Azure subscription Co-administrator or greater.

    If you experience browser problems with Azure, make sure that you use a supported browser.

  2. Go to Browse > Team Services accounts. Select your Team Services account.

    Browse, Team Services accounts, select your account

  3. Select your Azure subscription. Finish linking your account.

    Select an Azure subscription

    After Azure sets up the link, your Team Services account appears linked to your Azure subscription.

    Your account is now linked to your Azure subscription

    Need help?

Next

Add backup billing managers for your Team Services account

To let others manage billing or make purchases for your Team Services account, add a Co-administrator to the Azure subscription that's linked to your Team Services account.

  1. Sign in to the Azure classic portal as the Azure subscription administrator.

    You can only add subscription Co-administrators through the Azure classic portal.

  2. Go to Settings > Administrators > Add. Add a Co-administrator to your Azure subscription.

    Add a Co-administrator to your Azure subscription

    Need help?

Next

Change the Azure subscription your Team Services account uses for billing

If you want to use another Azure subscription to bill purchases for your Team Services account, you can unlink your Team Services account from your current Azure subscription, and relink your account to another Azure subscription that's associated with you as the Team Services account owner.

What do I need to change my Azure subscription?

When you unlink your account, any paid users and private agents that you've committed for the month will stay unaffected until the 1st of next month, but your account will revert immediately to the free monthly limits for hosted team services, like Build and Deployment and Cloud-based Load Testing. This will also cancel any non-paid Microsoft extensions without refund or credit.

When you relink your account in Azure, you'll have to restore any previous amounts for paid users, agents, or hosted team services that you had set in the Azure portal. You'll also have to repurchase any paid non-Microsoft extensions from the Visual Studio Marketplace. If you wait until the 1st of next month to relink, your account will revert back to 5 free users. Any paid users will appear expired in your Team Services account. So, make sure to restore any paid users promptly so they don't lose access on the 1st of next month. Learn more about what happens when you unlink your Team Services account.

You can follow the steps for the Azure classic portal or Azure portal. Both portals give you the same results.

Azure classic portal

  1. Sign in to the Azure classic portal as Team Services account owner and as Azure subscription Co-administrator or greater.

    If you experience browser problems with Azure, make sure that you use a supported browser.

  2. Go to Visual Studio Team Services. Select your Team Services account. Unlink your account.

    Visual Studio Team Services, select your account, unlink your account

    Your Team Services account is removed from Azure. You'll now relink your account to a new Azure subscription.

  3. Go to New > Link to Existing. Select your Team Services account and your Azure subscription.

    Go to New, App Services, Visual Studio Team Services, Link to Existing. Select account and Azure subscription

    After you finish relinking, your account reappears in the Azure portal with your selected Azure subscription. For more details, see how to link your Team Services account to an Azure subscription.

  4. Follow these steps to restore any paid users, agents, and amounts for team services that you had in Azure.

Azure portal

  1. Sign in to the Azure portal as Team Services account owner and as Azure subscription Co-administrator or greater.

    If you experience browser problems with Azure, make sure that you use a supported browser.

  2. Go to Browse > Team Services accounts. Select your Team Services account.

    Browse, Team Services, select your account

  3. Unlink your account.

    Unlink your account

    Your Team Services account is removed from Azure. You'll now relink your account to a new Azure subscription.

  4. Go to Browse > Team Services accounts. Select your Team Services account.

    Browse, Team Services accounts, select your account

  5. Select your Azure subscription. Finish relinking your account.

    Select an Azure subscription

    After you finish relinking, your account reappears in the Azure portal with your selected Azure subscription. For more details, see how to link your Team Services account to an Azure subscription.

  6. Follow these steps to restore any paid users, agents, and amounts for team services that you had in Azure.

Q&A

Q: Why am I having browser problems with Azure?

A: This might happen if you're using an unsupported browser. For the best experience, please check that you're using a supported browser.

Q: How do I find the account owner?

If you have at least Basic access, you can find the account owner in your account settings.

  1. Sign in to your Team Services account (https://{youraccount}.visualstudio.com), if you haven't already.

  2. Go to your account's control panel.

    Go to account control panel

  3. Go to your account settings.

    Go to settings

Q: Why don't I see the Team Services accounts that I own after I sign in to my Visual Studio profile on visualstudio.com?

A: The list of accounts that you own are associated with the identity that you use to sign in to Visual Studio Team Services.

If you were asked to choose between your personal Microsoft account, or your work or school account when you signed in, you might have selected the wrong identity.

Choose work or school account, or personal Microsoft account

Please try signing out completely from Team Services, then sign in again, and select your other identity.

Here's how you can sign out completely because just closing your browser doesn't always sign you out completely from Team Services:

  1. Close all browsers, including those that aren't running Team Services.

  2. Open a private or incognito browsing session.

  3. Go to this URL: http://aka.ms/vssignout

    You'll get a message that says "Sign out in progress". After you're signed out, you're redirected to the Visual Studio page @www.visualstudio.com.

    Tip If the sign-out page takes more than a minute, close the browser, and continue.

  4. Sign in to Visual Studio Team Services again. Select your other identity.

A: You can use an Azure subscription that's not:

If you have one of these subscriptions, set up a separate Pay-As-You-Go Azure subscription instead.

Important for Visual Studio subscribers and Visual Studio Dev Essentials members:

Q: Why don't my options look the same?

A: Your options might look different based on the Team Services account that you select and how that account is set up:

  • URL: This list shows only the Team Services accounts that you own. Why don't I see any accounts?

  • Directory: The name of a directory appears here only when a directory is connected to the Team Services account selected in the URL box. This directory controls access and authenticates users for the selected Team Services account. Learn more about why a directory is connected to your account.

  • Subscription: Appears only when you have more than one Azure subscription. These subscriptions are also filtered by the directories selected in the Azure classic portal's Subscriptions list:

    Subscriptions filter

Q: Why is a directory connected to my account?

A: Your Team Services account authenticates users through a directory, which is managed through Azure Active Directory (Azure AD). This directory controls who can get access to your account by requiring that all users belong to the directory to get access. Your Team Services account was connected to a directory when the account owner created the account or sometime after that.

Your directory administrator controls who can join the directory and get access. Otherwise, the Team Services account owner is solely responsible for managing access. Learn more about managing work access for your account.

A: This might happen because:

  • You're not the Team Services account owner.

  • You're not at least Co-administrator on the Azure subscription that you want to link.

  • If you don't see any Team Services accounts, your account might already linked to another Azure subscription.

  • If your Team Services account uses Azure Active Directory (Azure AD) to authenticate users, you might have a different directory selected in the Azure portal than the directory that's connected to your Team Services account.

    To select the directory that your Team Services account uses, open the Azure portal's Subscriptions list:

    Filter your subscriptions to the connected directory

Q: Are there billing restrictions that might stop me from linking my Team Services account to my Azure subscription?

A: Yes, you can link accounts in Australia East and India South only to Azure subscriptions with billing addresses in the same region. Otherwise, you'll see one of these messages:

  • "You need an Azure subscription that is valid for Team Services accounts in Australia East."

    -or-

  • "You need an Azure subscription that is valid for Team Services accounts in India South."

Q: Why is my Team Services account already linked to an Azure subscription?

A: This happens if your Team Services account was already set up for billing with an Azure subscription, either manually through Azure or while purchasing from the Visual Studio Marketplace for your account. The selected Azure subscription is also used to bill all later purchases for your account.

A: Yes, you can link an Azure subscription to multiple Team Services accounts. But you can't link a Team Services account to multiple Azure subscriptions.

Q: How does Azure billing work?

A: When you link your Team Services account to an Azure subscription, you select an eligible Azure subscription where you have Co-administrator permissions or greater. If you don't have an Azure subscription, you can either sign up for a new one, or have an Azure administrator add you as Co-Administrator to an Azure subscription that you can use to bill purchases.

Payment is set up with a credit card, or by invoice in some cases. Charges for your purchases will show up on your monthly Azure bill.

Note: You must keep your Azure subscription in good standing to use your Team Services purchases. If your Azure subscription is canceled or becomes disabled, for example, because the credit card used for payment expires, then any purchases with this Azure subscription will be deactivated on the 1st day of next month. To avoid losing access to your Team Services purchases, please keep your Azure subscription active and updated.

For example, if you paid for users with an Azure subscription that becomes disabled, those users will lose access on the 1st of next month.

Q: When do I get billed?

A: You're charged only after you've paid for users or used team services above the free limits. Your charges are prorated during the 1st month. After that, you're billed automatically on the 1st day of the calendar month. Learn more about pricing here.

Q: Why is my first Azure bill larger than expected?

A: Charges for your first purchase are prorated during the 1st month and are combined with charges for the next month, which are billed on the 1st day of the calendar month. This means your first Azure bill might include these partial charges and your 1st full month.

Q: How do I stop billing?

A: Sign in to the Azure classic portal or the Azure portal as the Team Services account owner or at least Azure subscription Co-administrator. Select your Team Services account, reduce any paid users to zero, and turn off any paid team services. Your Team Services account and bill won't show any changes in paid users or Build and Deployment agents until next month when these changes take effect. You're still charged for team services that you've already used.

Q: What happens if I cancel my Azure subscription?

A: Your Team Services account goes back to the free monthly limits, but you'll keep any paid users or Build and Deployment agents until next month. Your account stays linked to your Azure subscription until you unlink your account, or until your account unlinks automatically when your Azure subscription is disabled.

Q: What happens if my credit card expires?

A: Your Team Services account goes back to the free monthly limits, but you'll keep any paid users or Build and Deployment agents until next month. Your Azure subscription will eventually become disabled, but fixing this issue reactivates your subscription and restores your account's paid settings.

Q: What happens if my Azure subscription is disabled?

A: If you're the Team Services account owner or Azure subscription Account Administrator, check your subscription status here, then try to fix your subscription. This will restore your account's paid settings. Or you can link your Team Services account to another Azure subscription by unlinking your account from the disabled subscription. While your subscription is disabled, your account goes back to the free monthly limits until your subscription is fixed.

A: Your account reverts to 5 free users on the 1st of next month, but hosted team services, like Build and Deployment or Cloud-based Load Testing, revert immediately to the monthly free limits. This will also cancel any paid non-Microsoft extensions without refund or credit.

  • You're still charged for any paid users and private agents for Build and Deployment that you've committed for the current month. You're charged for any amounts of Build and Deployment or Cloud-Based Load Testing that you've already used this month.

  • Your account won't appear in the Azure portal anymore.

You can relink your account to another Azure subscription at any time. In Azure, you'll have restore any previous amounts for hosted team services, paid users, or agents that you had before. You'll also have to repurchase any paid non-Microsoft extensions from the Visual Studio Marketplace.

If you wait until the 1st of next month to relink, your account will revert back to 5 free users. Any paid users will appear expired in the Users hub for your Team Services account. So, make sure to restore any paid users promptly so they don't lose access on the 1st of next month.

Q: Where can I check my bill or update billing details on my Azure subscription?

A: If you're the Azure Account Administrator, view your subscription at the Azure account portal.

Q: What if I have other questions about Azure subscriptions and billing?

A: Check the Azure Billing and Subscription FAQ, or try Azure Support.

Q: How do I get help or support for Team Services?

A: Try the Team Services forum or Team Services Support.

© 2016 Microsoft