Skip to content

Commit 7141603

Browse files
felicitymayCopilotjc-clark
authored
EDI implementation: Billing how-tos, setting up payment, part 1 (#57022)
Co-authored-by: Copilot <[email protected]> Co-authored-by: Joe Clark <[email protected]>
1 parent 70af4f7 commit 7141603

14 files changed

+248
-262
lines changed
Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
---
2+
title: Azure subscription payments
3+
intro: 'Learn about paying for metered usage of {% data variables.product.github %} plans, licenses, and usage with an Azure subscription.'
4+
shortTitle: Azure subscriptions
5+
versions:
6+
fpt: '*'
7+
ghec: '*'
8+
ghes: '*'
9+
topics:
10+
- Billing
11+
- Enterprise
12+
- Team
13+
- Azure subscription
14+
contentType: concepts
15+
product: 'Organization and enterprise accounts can pay for any metered use of {% data variables.product.github %} using an Azure subscription. This option is not available for personal accounts.'
16+
---
17+
18+
## Payment using an Azure subscription
19+
20+
You can pay for {% data variables.product.github %} use through an Azure subscription by connecting the subscription to {% data variables.product.github %}. See [AUTOTITLE](/billing/how-tos/set-up-payment/connect-azure-sub).
21+
22+
{% data variables.product.github %} installs a Subscription Permission Validation app (SPV app) on the Azure tenant, which it uses to get a list of available subscriptions from active directory. Installing the SPV app requires tenant-wide admin consent. You must sign into an Azure account that can provide tenant-wide admin consent, or work with an Azure administrator to configure the admin consent workflow.
23+
24+
* [Grant tenant-wide admin consent to an application](https://learn.microsoft.com/azure/active-directory/manage-apps/grant-admin-consent) in Microsoft Docs
25+
* [User and admin consent in Azure Active Directory](https://learn.microsoft.com/en-us/azure/active-directory/manage-apps/user-admin-consent-overview#admin-consent-workflow) in Microsoft Docs.
26+
27+
>[!TIP] If your tenant provides user consent settings, users included in those settings might not require admin consent to install the {% data variables.product.company_short %} SPV app. See [User consent](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/user-admin-consent-overview#user-consent) in Microsoft Docs.
28+
29+
## Billing cycle for Azure
30+
31+
If you link your {% data variables.product.github %} account to Azure, any usage-based costs starting from that point will be billed through Azure and charged on the 1st of each month. However, any remaining {% data variables.product.github %} charges, for example, charges for your {% data variables.product.prodname_dotcom %} plan, will still be billed on your usual billing date.
32+
33+
Prepaid usage is not currently available for usage-based billing through Azure.
34+
35+
### Calculation example
36+
37+
You link your Azure subscription to your organization or enterprise account on **June 16th** and you also have a {% data variables.copilot.copilot_for_business %} subscription.
38+
39+
* From that June 16th onwards, any usage costs for {% data variables.copilot.copilot_business_short %}, with any costs for metered use over the included amounts, is included in your Azure bill and charged on **July 1st** and on the first of every month.
40+
* Any charges incurred before June 16th are billed separately through {% data variables.product.github %} on your account's usual billing date.
41+
42+
## Use of {% data variables.product.prodname_ghe_cloud %} through a Microsoft Enterprise Agreement
43+
44+
If you use {% data variables.product.prodname_ghe_cloud %} through a Microsoft Enterprise Agreement, connecting an Azure subscription is the only way to use {% data variables.product.prodname_GHAS %}, {% data variables.product.prodname_github_codespaces %}, or {% data variables.product.prodname_copilot %}, or to use {% data variables.product.prodname_actions %}, Git Large File Storage (LFS), or {% data variables.product.prodname_registry %} beyond your plan's included amounts.
45+
46+
## Next steps
47+
48+
For instructions on connecting your Azure subscription, see [AUTOTITLE](/billing/how-tos/set-up-payment/connect-azure-sub).
49+
50+
For reference information, see [AUTOTITLE](/billing/reference/azure-subscription).

content/billing/concepts/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,11 +11,11 @@ topics:
1111
children:
1212
- /billing-cycles
1313
- /license-consumption
14+
- /azure-subscriptions
1415
- /impact-of-plan-changes
1516
- /discounted-plans
1617
- /enterprise-billing
1718
- /product-billing
1819
- /third-party-payments
1920
contentType: concepts
2021
---
21-

content/billing/how-tos/set-up-payment/connect-azure-sub.md

Lines changed: 25 additions & 155 deletions
Large diffs are not rendered by default.
Lines changed: 29 additions & 98 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Managing your payment and billing information
3-
intro: 'Learn how to manage your payment information and history, and update your billing contacts using the new billing platform.'
3+
intro: 'Learn how to view and manage your payment information and billing contacts using the new billing platform.'
44
versions:
55
feature: enhanced-billing-platform
66
redirect_from:
@@ -21,135 +21,66 @@ topics:
2121
- Team
2222
- Receipts
2323
permissions: '{% data reusables.permissions.enhanced-billing-platform %}'
24-
product: '{% data reusables.billing.enhanced-billing-platform-product %}'
2524
shortTitle: Manage payment info
2625
contentType: how-tos
2726
---
2827

29-
You can view your payment information and history, and update your billing contacts.
30-
31-
## Supported payment methods
32-
33-
These are the supported payment methods for metered billing:
34-
35-
* Invoice – Managed accounts only
36-
* Credit card – Unmanaged accounts, or as a nonrecurring method for managed accounts
37-
* PayPal – Unmanaged accounts, or as a nonrecurring method for managed accounts
38-
* Azure Subscription ID – Not available for personal accounts
39-
* Automated Clearing House (ACH) – Managed accounts only
40-
41-
Accounts with volume licenses and metered billing can use multiple payment methods.
42-
43-
* For unmanaged accounts, you might pay for volume licenses with a credit card or PayPal, and metered usage with an Azure Subscription ID.
44-
* For managed accounts, you might pay for volume licenses via invoice, and metered usage via Azure Subscription ID.
45-
46-
{% data variables.product.prodname_copilot_short %} standalone accounts, which traditionally used Azure Subscription IDs, can now also pay by credit card. Contact your {% data variables.product.github %} representative for details.
47-
48-
{% ifversion fpt %}
49-
50-
## Connecting your Azure subscription
51-
52-
You must know your Azure subscription ID. For more information, see the following documentation or [contact Azure support](https://azure.microsoft.com/support/).
53-
54-
* [AUTOTITLE](/billing/managing-the-plan-for-your-github-account/connecting-an-azure-subscription)
55-
* [Get subscription and tenant IDs in the Azure portal](https://learn.microsoft.com/en-us/azure/azure-portal/get-subscription-tenant-id) in the Microsoft Docs
56-
57-
{% elsif ghec %}
58-
59-
## Prerequisites for paying through Azure
60-
61-
* You must be new to {% data variables.product.prodname_ghe_cloud %} to begin with usage-based billing through an Azure subscription. If your company already uses {% data variables.product.github %}, you can use {% data variables.product.prodname_importer_proper_name %} to migrate your resources to a new subscription that bills through Azure. For more information, see [AUTOTITLE](/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer).
62-
* Prepaid usage is not currently available for usage-based billing through Azure.
63-
* You must know your Azure subscription ID. For more information, see the following documentation or [contact Azure support](https://azure.microsoft.com/support/).
64-
65-
* [AUTOTITLE](/billing/managing-the-plan-for-your-github-account/connecting-an-azure-subscription)
66-
* [Get subscription and tenant IDs in the Azure portal](https://learn.microsoft.com/en-us/azure/azure-portal/get-subscription-tenant-id) in the Microsoft Docs
67-
68-
## Connecting your Azure subscription
69-
70-
After creation of your new enterprise on {% data variables.product.prodname_dotcom_the_website %}, to begin usage-based billing through Azure, you must connect your Azure subscription.
71-
72-
> [!IMPORTANT] If you don't use {% data variables.product.prodname_emus %}, connection of an Azure subscription will immediately end your trial and begin paid usage.
73-
74-
For more information, see [AUTOTITLE](/billing/managing-the-plan-for-your-github-account/connecting-an-azure-subscription#connecting-your-azure-subscription-to-your-enterprise-account).
75-
76-
## What does my Azure invoice look like?
77-
78-
After you connect your Azure subscription, usage for {% data variables.product.company_short %}'s products will appear on your Azure invoice, summarized by product family.
79-
80-
For example, if you use this billing arrangement for {% data variables.product.prodname_ghe_cloud %} and {% data variables.product.prodname_GHAS %}, usage and price excluding tax for each line item will appear as follows.
81-
82-
| Product Family Usage Charges | Total (excluding Tax) |
83-
| :- | :- |
84-
| GH ENTERPRISE | AMOUNT |
85-
| GH ADVANCED SECURITY | AMOUNT |
86-
87-
For more information about your Azure invoice, see [Understand terms on your Microsoft Azure invoice](https://learn.microsoft.com/azure/cost-management-billing/understand/understand-invoice) in the Microsoft Docs.
88-
89-
The {% data variables.product.company_short %} products on your Azure invoice are also MACC-eligible. For more information, see [Track your Microsoft Azure Consumption Commitment (MACC)](https://learn.microsoft.com/azure/cost-management-billing/manage/track-consumption-commitment) in the Microsoft Docs.
90-
91-
{% endif %}
28+
The payment methods available depend on your account type. Enterprise and organization accounts have more payment options than personal accounts. Invoiced enterprise accounts make their payments using other methods. For more information, see [AUTOTITLE](/billing/reference/supported-payment-methods).
9229

9330
## Managing payment information
9431

95-
{% ifversion fpt %}
96-
97-
You can view and edit your billing information and update your payment method.
98-
9932
1. In the upper-right corner of any page on {% data variables.product.prodname_dotcom %}, click your profile picture.
10033

101-
* For **personal accounts**, click **Settings**, then in the **Access** section of the sidebar, click **{% octicon "credit-card" aria-hidden="true" aria-label="credit-card" %} Billing & Licensing**.
102-
* For **organizations**, click **Your organizations**, then next to the organization, click **Settings**. In the organization sidebar, click **{% octicon "credit-card" aria-hidden="true" aria-label="credit-card" %} Billing & Licensing**.
103-
104-
{% elsif ghec %}
34+
1. Select the account you want to view and then access the "Billing & Licensing" pages:
10535

106-
You can view and edit your billing information, update your payment method, and view active coupons.
36+
* **Personal accounts**: Click **Settings**, then in the **Access** section of the sidebar, click **{% octicon "credit-card" aria-hidden="true" aria-label="credit-card" %} Billing & Licensing**.
37+
* **Organizations**: Click **Your organizations**, then next to the organization, click **Settings**. In the organization sidebar, click **{% octicon "credit-card" aria-hidden="true" aria-label="credit-card" %} Billing & Licensing**.
38+
* For **enterprises**, click **Your enterprises**, then click the enterprise name. Click the **{% octicon "credit-card" aria-hidden="true" aria-label="credit-card" %} Billing & Licensing** tab at the top of the page.
10739

108-
>[!NOTE] This does not apply to invoiced enterprise accounts.
40+
1. From the list of "Billing & licensing" pages, click **Payment information** to display full details of your payment method.
10941

110-
{% data reusables.enterprise-accounts.access-enterprise %}
111-
{% data reusables.billing.enterprise-billing-menu %}
42+
1. To edit your payment method:
11243

113-
{% endif %}
114-
115-
1. Click **Payment information**.
116-
1. Click **Edit** to edit your payment information or **Remove** to delete your payment method.
117-
1. Follow the prompts.
44+
* **Bank card or PayPal**: In "Payment method", click **Edit** to update your payment information.
45+
* **Azure subscription**: Under "Azure subscription", click {% octicon "pencil" aria-label="Edit Azure Subscription" %} to edit your subscription or {% octicon "trash" aria-label="Delete Azure Subscription" %} to remove your subscription. See [AUTOTITLE](/billing/how-tos/set-up-payment/connect-azure-sub).
11846

11947
>[!NOTE] You may see an authorization hold on your provided payment method once its updated or after accruing significant usage of metered services. Authorization holds are temporary and are released as quickly as possible.
12048
121-
## Troubleshooting payment method issues
49+
### Troubleshooting payment method issues
12250

123-
If you encounter issues when adding or updating your payment method, you can try the following:
51+
If you encounter issues when adding or updating a payment method, you can try the following:
12452

12553
1. Retry adding your payment method.
12654
1. Try adding a new payment method.
127-
1. Reach out to {% data variables.contact.github_support %} or your customer representative for additional assistance.
55+
1. Contact {% data variables.contact.github_support %} or your customer representative for additional assistance.
12856

12957
## Viewing payment history
13058

13159
You can view your payment history, including the date, amount, and payment method. You can also download past payments.
13260

133-
1. Display the **Billing and Licensing** {% ifversion fpt %}section of the sidebar of the organization settings{% else %}page for the enterprise{% endif %}.
134-
1. Click **Payment history**.
61+
1. Display the **{% octicon "credit-card" aria-hidden="true" aria-label="credit-card" %} Billing & Licensing** pages.
62+
1. Click **Payment history** to show details of payments.
63+
1. To view the receipt for a payment, click {% octicon "eye" aria-label="View receipt" %}.
64+
1. To download a receipt or invoice, click {% octicon "download" aria-label="Download" %} under "Receipt" or "Invoice".
13565

13666
## Managing billing contacts
13767

138-
You can add an email address to receive billing notifications regarding payments and budget threshold alerts.
68+
Organizations and enterprises can add contacts to receive emails with billing notifications for payments and budget threshold alerts. One of the contacts is defined as the primary contact.
13969

140-
{% ifversion fpt %}
70+
### Organization billing contacts
14171

142-
1. Display the **Billing and Licensing** section of the sidebar of the organization settings.
72+
1. Display the **{% octicon "credit-card" aria-hidden="true" aria-label="credit-card" %} Billing & Licensing** page for the organization.
14373
1. Click **Additional billing details**.
14474
1. In the table of "Email recipients":
145-
* Click **Add** and follow the prompt to add a new billing contact.
146-
* Use the **Edit** drop-down for a contact to either remove the contact or make that contact the primary billing contact.
75+
* Click **Add**, enter an email address, and click **Add** to add a new billing contact.
76+
* Use the **Edit** drop-down for an existing contact to remove the contact or make that contact the primary billing contact.
77+
* Click **Edit** to update the email address for the primary billing contact.
14778

148-
{% else %}
79+
### Enterprise billing contacts
14980

150-
1. Display the **Billing and Licensing** page for the enterprise.
81+
1. Display the **{% octicon "credit-card" aria-hidden="true" aria-label="credit-card" %} Billing and Licensing** page for the enterprise.
15182
1. Click **Billing contacts**.
152-
1. Click **Add** in the upper-right corner and follow the prompt.
153-
1. Click {% octicon "pencil" aria-label="The edit icon" %} to edit the primary billing contact or {% octicon "kebab-horizontal" aria-label="Show options" %} to either remove a contact or make a contact the primary billing contact.
154-
155-
{% endif %}
83+
1. In the table of "Email recipients":
84+
* Click **Add**, enter an email address, and click **Add** to add a new billing contact.
85+
* Use the **{% octicon "kebab-horizontal" aria-label="Show options for ..." %}** drop-down for an existing contact to remove the contact or make that contact the primary billing contact.
86+
* Click {% octicon "pencil" aria-label="Edit primary email address" %} to update the email address for the primary billing contact.
Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
title: Troubleshooting Azure subscription connection problems
3+
intro: 'Tips for resolving some common issues with connection of an Azure subscription to your account on {% data variables.product.github %}.'
4+
versions:
5+
fpt: '*'
6+
ghec: '*'
7+
ghes: '*'
8+
topics:
9+
- Billing
10+
- Troubleshooting
11+
shortTitle: Azure sub connection
12+
contentType: how-tos
13+
---
14+
15+
## Message: "Need admin approval"
16+
17+
This message is displayed if the user account you used to sign into Azure does not have adequate permissions to install the {% data variables.product.github %} Subscription Permission Validation app (SPV app). {% data variables.product.github %} uses the SPV app during the connection process to get a list of available subscriptions from active directory.
18+
19+
> **Need admin approval**
20+
>
21+
> GitHub Inc needs permission to access resources in your organization that only an admin can grant. Please ask an admin to grant permission to this app before you can use it.
22+
23+
Installing the SPV app requires tenant-wide admin consent. You must sign into an Azure account that can provide tenant-wide admin consent, or work with an Azure administrator to configure the admin consent workflow.
24+
25+
* [Grant tenant-wide admin consent to an application](https://learn.microsoft.com/azure/active-directory/manage-apps/grant-admin-consent) in Microsoft Docs
26+
* [User and admin consent in Azure Active Directory](https://learn.microsoft.com/en-us/azure/active-directory/manage-apps/user-admin-consent-overview#admin-consent-workflow) in Microsoft Docs.
27+
28+
>[!TIP] If your tenant provides user consent settings, users included in those settings might not require admin consent to install the {% data variables.product.company_short %} SVP app. See [User consent](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/user-admin-consent-overview#user-consent) in Microsoft Docs.
29+
30+
## Banner saying my Azure ID is missing
31+
32+
If you see this banner, it means your Azure payment method information is missing. To avoid service interruptions for your enterprise or organization, update your Azure subscription connection as soon as possible. See [AUTOTITLE](/billing/how-tos/set-up-payment/connect-azure-sub).

content/billing/how-tos/troubleshooting/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ topics:
1111
children:
1212
- /declined-card
1313
- /locked-account
14+
- /azure-sub-connection
1415
- /enterprise-license-usage
1516
contentType: how-tos
1617
---
17-

0 commit comments

Comments
 (0)