EDI implementation: Billing how-tos, setting up payment, part 1 (#57022)

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Joe Clark <31087804+jc-clark@users.noreply.github.com>
github · docs-bot · Aug 8, 2025 · Aug 8, 2025 · Aug 8, 2025 · 7141603207bbcb3cdef71c6e976e6fcb05bd3472
commit 7141603207bbcb3cdef71c6e976e6fcb05bd3472
diff --git a/content/billing/concepts/azure-subscriptions.md b/content/billing/concepts/azure-subscriptions.md
@@ -0,0 +1,50 @@
+---
+title: Azure subscription payments
+intro: 'Learn about paying for metered usage of {% data variables.product.github %} plans, licenses, and usage with an Azure subscription.'
+shortTitle: Azure subscriptions
+versions:
+  fpt: '*'
+  ghec: '*'
+  ghes: '*'
+topics:
+  - Billing
+  - Enterprise
+  - Team
+  - Azure subscription
+contentType: concepts
+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.'
+---
+
+## Payment using an Azure subscription
+
+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).
+
+{% 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.
+
+* [Grant tenant-wide admin consent to an application](https://learn.microsoft.com/azure/active-directory/manage-apps/grant-admin-consent) in Microsoft Docs
+* [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.
+
+>[!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.
+
+## Billing cycle for Azure
+
+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.
+
+Prepaid usage is not currently available for usage-based billing through Azure.
+
+### Calculation example
+
+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.
+
+* 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.
+* Any charges incurred before June 16th are billed separately through {% data variables.product.github %} on your account's usual billing date.
+
+## Use of {% data variables.product.prodname_ghe_cloud %} through a Microsoft Enterprise Agreement
+
+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.
+
+## Next steps
+
+For instructions on connecting your Azure subscription, see [AUTOTITLE](/billing/how-tos/set-up-payment/connect-azure-sub).
+
+For reference information, see [AUTOTITLE](/billing/reference/azure-subscription).
diff --git a/content/billing/concepts/index.md b/content/billing/concepts/index.md
@@ -11,11 +11,11 @@ topics:
 children:
   - /billing-cycles
   - /license-consumption
+  - /azure-subscriptions
   - /impact-of-plan-changes
   - /discounted-plans
   - /enterprise-billing
   - /product-billing
   - /third-party-payments
 contentType: concepts
 ---
-
diff --git a/content/billing/how-tos/set-up-payment/connect-azure-sub.md b/content/billing/how-tos/set-up-payment/connect-azure-sub.md
diff --git a/content/billing/how-tos/set-up-payment/manage-payment-info.md b/content/billing/how-tos/set-up-payment/manage-payment-info.md
@@ -1,6 +1,6 @@
 ---
 title: Managing your payment and billing information
-intro: 'Learn how to manage your payment information and history, and update your billing contacts using the new billing platform.'
+intro: 'Learn how to view and manage your payment information and billing contacts using the new billing platform.'
 versions:
   feature: enhanced-billing-platform
 redirect_from:
@@ -21,135 +21,66 @@ topics:
   - Team
   - Receipts
 permissions: '{% data reusables.permissions.enhanced-billing-platform %}'
-product: '{% data reusables.billing.enhanced-billing-platform-product %}'
 shortTitle: Manage payment info
 contentType: how-tos
 ---
 
-You can view your payment information and history, and update your billing contacts.
-
-## Supported payment methods
-
-These are the supported payment methods for metered billing:
-
-* Invoice – Managed accounts only
-* Credit card – Unmanaged accounts, or as a nonrecurring method for managed accounts
-* PayPal – Unmanaged accounts, or as a nonrecurring method for managed accounts
-* Azure Subscription ID – Not available for personal accounts
-* Automated Clearing House (ACH) – Managed accounts only
-
-Accounts with volume licenses and metered billing can use multiple payment methods.
-
-* For unmanaged accounts, you might pay for volume licenses with a credit card or PayPal, and metered usage with an Azure Subscription ID.
-* For managed accounts, you might pay for volume licenses via invoice, and metered usage via Azure Subscription ID.
-
-{% 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.
-
-{% ifversion fpt %}
-
-## Connecting your Azure subscription
-
-You must know your Azure subscription ID. For more information, see the following documentation or [contact Azure support](https://azure.microsoft.com/support/).
-
-* [AUTOTITLE](/billing/managing-the-plan-for-your-github-account/connecting-an-azure-subscription)
-* [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
-
-{% elsif ghec %}
-
-## Prerequisites for paying through Azure
-
-* 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).
-* Prepaid usage is not currently available for usage-based billing through Azure.
-* You must know your Azure subscription ID. For more information, see the following documentation or [contact Azure support](https://azure.microsoft.com/support/).
-
-  * [AUTOTITLE](/billing/managing-the-plan-for-your-github-account/connecting-an-azure-subscription)
-  * [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
-
-## Connecting your Azure subscription
-
-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.
-
-> [!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.
-
-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).
-
-## What does my Azure invoice look like?
-
-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.
-
-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.
-
-| Product Family Usage Charges | Total (excluding Tax) |
-| :- | :- |
-| GH ENTERPRISE | AMOUNT |
-| GH ADVANCED SECURITY | AMOUNT |
-
-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.
-
-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.
-
-{% endif %}
+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).
 
 ## Managing payment information
 
-{% ifversion fpt %}
-
-You can view and edit your billing information and update your payment method.
-
 1. In the upper-right corner of any page on {% data variables.product.prodname_dotcom %}, click your profile picture.
 
-   * 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**.
-   * 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**.
-
-{% elsif ghec %}
+1. Select the account you want to view and then access the "Billing & Licensing" pages:
 
-You can view and edit your billing information, update your payment method, and view active coupons.
+   * **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**.
+   * **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**.
+   * 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.
 
->[!NOTE] This does not apply to invoiced enterprise accounts.
+1. From the list of "Billing & licensing" pages, click **Payment information** to display full details of your payment method.
 
-{% data reusables.enterprise-accounts.access-enterprise %}
-{% data reusables.billing.enterprise-billing-menu %}
+1. To edit your payment method:
 
-{% endif %}
-
-1. Click **Payment information**.
-1. Click **Edit** to edit your payment information or **Remove** to delete your payment method.
-1. Follow the prompts.
+   * **Bank card or PayPal**: In "Payment method", click **Edit** to update your payment information.
+   * **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).
 
 >[!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.
 
-## Troubleshooting payment method issues
+### Troubleshooting payment method issues
 
-If you encounter issues when adding or updating your payment method, you can try the following:
+If you encounter issues when adding or updating a payment method, you can try the following:
 
 1. Retry adding your payment method.
 1. Try adding a new payment method.
-1. Reach out to {% data variables.contact.github_support %} or your customer representative for additional assistance.
+1. Contact {% data variables.contact.github_support %} or your customer representative for additional assistance.
 
 ## Viewing payment history
 
 You can view your payment history, including the date, amount, and payment method. You can also download past payments.
 
-1. Display the **Billing and Licensing** {% ifversion fpt %}section of the sidebar of the organization settings{% else %}page for the enterprise{% endif %}.
-1. Click **Payment history**.
+1. Display the **{% octicon "credit-card" aria-hidden="true" aria-label="credit-card" %} Billing & Licensing** pages.
+1. Click **Payment history** to show details of payments.
+1. To view the receipt for a payment, click {% octicon "eye" aria-label="View receipt" %}.
+1. To download a receipt or invoice, click {% octicon "download" aria-label="Download" %} under "Receipt" or "Invoice".
 
 ## Managing billing contacts
 
-You can add an email address to receive billing notifications regarding payments and budget threshold alerts.
+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.
 
-{% ifversion fpt %}
+### Organization billing contacts
 
-1. Display the **Billing and Licensing** section of the sidebar of the organization settings.
+1. Display the **{% octicon "credit-card" aria-hidden="true" aria-label="credit-card" %} Billing & Licensing** page for the organization.
 1. Click **Additional billing details**.
 1. In the table of "Email recipients":
-   * Click **Add** and follow the prompt to add a new billing contact.
-   * Use the **Edit** drop-down for a contact to either remove the contact or make that contact the primary billing contact.
+   * Click **Add**, enter an email address, and click **Add** to add a new billing contact.
+   * Use the **Edit** drop-down for an existing contact to remove the contact or make that contact the primary billing contact.
+   * Click **Edit** to update the email address for the primary billing contact.
 
-{% else %}
+### Enterprise billing contacts
 
-1. Display the **Billing and Licensing** page for the enterprise.
+1. Display the **{% octicon "credit-card" aria-hidden="true" aria-label="credit-card" %} Billing and Licensing** page for the enterprise.
 1. Click **Billing contacts**.
-1. Click **Add** in the upper-right corner and follow the prompt.
-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.
-
-{% endif %}
+1. In the table of "Email recipients":
+   * Click **Add**, enter an email address, and click **Add** to add a new billing contact.
+   * 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.
+   * Click {% octicon "pencil" aria-label="Edit primary email address" %} to update the email address for the primary billing contact.
diff --git a/content/billing/how-tos/troubleshooting/azure-sub-connection.md b/content/billing/how-tos/troubleshooting/azure-sub-connection.md
@@ -0,0 +1,32 @@
+---
+title: Troubleshooting Azure subscription connection problems
+intro: 'Tips for resolving some common issues with connection of an Azure subscription to your account on {% data variables.product.github %}.'
+versions:
+  fpt: '*'
+  ghec: '*'
+  ghes: '*'
+topics:
+  - Billing
+  - Troubleshooting
+shortTitle: Azure sub connection
+contentType: how-tos
+---
+
+## Message: "Need admin approval"
+
+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.
+
+> **Need admin approval**
+>
+> 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.
+
+ 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.
+
+* [Grant tenant-wide admin consent to an application](https://learn.microsoft.com/azure/active-directory/manage-apps/grant-admin-consent) in Microsoft Docs
+* [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.
+
+>[!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.
+
+## Banner saying my Azure ID is missing
+
+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).
diff --git a/content/billing/how-tos/troubleshooting/index.md b/content/billing/how-tos/troubleshooting/index.md
@@ -11,7 +11,7 @@ topics:
 children:
   - /declined-card
   - /locked-account
+  - /azure-sub-connection
   - /enterprise-license-usage
 contentType: how-tos
 ---
-