billing: pay by invoice

content/manuals/billing/cycle.md

@@ -5,23 +5,24 @@ description: Learn to change your billing cycle for your Docker subscription
 keywords: billing, cycle, payments, subscription
 ---
 
-You can pay for a subscription plan on a monthly or yearly billing cycle. You select your preferred billing cycle when you buy your subscription.
+You can choose a monthly or yearly billing cycle when purchasing a subscription.
+[Docker Business](/manuals/subscription/details.md#docker-business) subscription
+plans are only available with yearly billing.
 
-> [!NOTE]
->
-> Business plan is available only on yearly billing cycle.
-
-If you have a monthly billing cycle, you can choose to switch to an annual billing cycle.
-
-> [!NOTE]
->
-> You can't switch from an annual billing cycle to a monthly cycle.
+If you're on a monthly plan, you can switch to a yearly plan at any time.
+However, switching from a yearly to a monthly cycle isn't supported.
 
-When you change the billing cycle's duration:
+When you change your billing cycle:
 
-- The next billing date reflects the new cycle. To find your next billing date, see [View renewal date](history.md#view-renewal-date).
-- The subscription's start date resets. For example, if the start date of the monthly subscription is March 1st and the end date is April 1st, then after switching the billing duration to March 15th, 2024 the new start date is March 15th, 2024, and the new end date is March 15th, 2025.
-- Any unused monthly subscription is prorated and applied as credit towards the new annual period. For example, if you switch from a $10 monthly subscription to a $100 annual plan, deducting the unused monthly value (in this case $5), the migration cost becomes $95 ($100 - $5). The renewal cost after March 15, 2025 is $100.
+- Your next billing date updates to reflect the new cycle. To find your next
+billing date, see [View renewal date](history.md#view-renewal-date).
+- Your subscription start date resets. For example, if your monthly subscription
+runs from March 1 to April 1, and you switching to annual billing on March 15,
+your new subscription runs from March 15, 2025 to March 15, 2026.
+- Any unused portion of your monthly subscription is credited towards the
+annual plan. For example, if you switch from a $10 monthly plan halfway through
+the month, $5 is credited toward the $100 annual fee, making your first charge
+$95. The renewal cost remains $100.
 
 {{% include "tax-compliance.md" %}}
 
@@ -30,6 +31,11 @@ When you change the billing cycle's duration:
 {{< tabs >}}
 {{< tab name="Docker plan" >}}
 
+> [!IMPORTANT]
+>
+> Pay by invoice is only available on first-time checkouts and subscription
+renewals. You can't use pay-by-invoice for subscription upgrades or changes.
+
 To change your billing cycle:
 
 1. Sign in to [Docker Home](https://app.docker.com/).
@@ -62,13 +68,16 @@ To change your billing cycle:
 
 ## Organization
 
-> [!NOTE]
->
-> You must be an organization owner to make changes to the payment information.
+You must be an organization owner to make changes to an organization's payment information.
 
 {{< tabs >}}
 {{< tab name="Docker plan" >}}
 
+> [!IMPORTANT]
+>
+> Pay by invoice is only available on first-time checkouts and subscription
+renewals. You can't use pay-by-invoice for subscription upgrades or changes.
+
 To change your organization's billing cycle:
 
 1. Sign in to [Docker Home](https://app.docker.com/).

content/manuals/billing/faqs.md

@@ -59,4 +59,12 @@
 
 ### Do I need to do anything at the end of my subscription term?
 
-No. All monthly and annual subscriptions are automatically renewed at the end of the term using the original form of payment.
+No. All monthly and annual subscriptions are automatically renewed at the end of the term using the original form of payment.
+
+### Can I use pay-by-invoice for upgrades or additional seats?
+
+No. Pay by invoice is only available for subscribers on an annual subscription
+during first-time checkouts and subscription renewal. You must use card payment
+or US bank accounts for purchasing upgrades or additional seats.
+
+For a list of supported payment methods, see [Add or update a payment method](/manuals/billing/payment-method.md).

content/manuals/billing/history.md

@@ -1,49 +1,81 @@
 ---
-title: View billing history
+title: Invoices and billing history
 weight: 40
-description: Discover how to view your billing history in Docker Hub
-keywords: payments, billing, subscription, invoices, renewals, invoice management, billing administration
+description: Discover how to view invoices and your billing history
+keywords: payments, billing, subscription, invoices, renewals, invoice management, billing administration, pay invoice
 aliases:
     - /billing/core-billing/history/
 ---
 
-In this section, learn how you can view your billing history, manage your invoices, and verify your renewal date. All monthly and annual subscriptions are automatically renewed at the end of the term using the original form of payment.
+Learn how to view and pay invoices, view your billing history, and verify
+your billing renewal date. All monthly and annual subscriptions are
+automatically renewed at the end of the subscription term using your default
+payment method.
 
 {{% include "tax-compliance.md" %}}
 
-## Invoices
+## View an invoice
 
 Your invoice includes the following:
 
 - Invoice number
 - Date of issue
-- Date due
+- Due date
 - Your "Bill to" information
 - Amount due (in USD)
-- Description of your order, quantity if applicable, unit price, and amount (in USD)
+- Pay online: Select this link to pay your invoice online
+- Description of your order, quantity if applicable, unit price, and amount
+(in USD)
+- Subtotal, discount (if applicable), and total
 
-The information listed in the **Bill to** section of your invoice is based on your billing information. Not all fields are required. The billing information includes the following:
+The information listed in the "Bill to" section of your invoice is based on your billing information. Not all fields are required. The billing information
+includes the following:
 
 - Name (required): The name of the administrator or company
-- Email address (required): The email address that receives all billing-related emails for the account
 - Address (required)
+- Email address (required): The email address that receives all billing-related
+emails for the account
 - Phone number
 - Tax ID or VAT
 
-You can’t make changes to a paid or unpaid billing invoice. When you update your billing information, this change won't update an existing invoice. If you need to update your billing information, make sure you do so before your subscription renewal date when your invoice is finalized. For more information, see [Update the billing information](details.md).
+You can’t make changes to a paid or unpaid billing invoice. When you update your billing information, this change won't update an existing invoice. If you need
+to update your billing information, make sure you do so before your subscription renewal date when your invoice is finalized.
+For more information, see [Update billing information](details.md).
 
-### View renewal date
+## Pay an invoice
+
+> [!NOTE]
+>
+> Pay by invoice is only available for subscribers on an annual billing cycle.
+To change your billing cycle, see [Change your billing cycle](/manuals/billing/cycle.md).
+
+You can pay an invoice from the Docker Billing Console:
+
+1. Sign in to [Docker Home](https://app.docker.com/).
+2. Under Settings and administration, select **Billing**.
+3. Select **Invoices** and locate the invoice you want to pay.
+4. In the **Actions** column, select **Pay invoice**.
+5. Fill out your payment details and select **Pay**.
+
+When your payment has processed, the invoice's **Status** column will update to
+**Paid** and you will receive a confirmation email.
+
+If you choose to pay using a US bank account, you must verify the account. For
+more information, see [Verify a bank account](manuals/billing/payment-method.md#verify-a-bank-account).
+
+## View renewal date
 
 {{< tabs >}}
 {{< tab name="Docker plan" >}}
 
-You receive your invoice when the subscription renews. To verify your renewal date, sign in to the [Docker Home Billing](https://app.docker.com/billing). Your renewal date and amount are displayed on your subscription plan card.
-
+You receive your invoice when the subscription renews. To verify your renewal
+date, sign in to the [Docker Home Billing](https://app.docker.com/billing). Your renewal date and amount are displayed on your subscription plan card.
 
 {{< /tab >}}
 {{< tab name="Legacy Docker plan" >}}
 
-You receive your invoice when the subscription renews. To verify your renewal date:
+You receive your invoice when the subscription renews. To verify your renewal
+date:
 
 1. Sign in to [Docker Hub](https://hub.docker.com).
 2. Select your user avatar to open the drop-down menu.
@@ -53,11 +85,13 @@
 {{< /tab >}}
 {{< /tabs >}}
 
-### Include your VAT number on your invoice
+## Include your VAT number on your invoice
 
 > [!NOTE]
 >
-> If the VAT number field is not available, complete the [Contact Support form](https://hub.docker.com/support/contact/). This field may need to be manually added.
+> If the VAT number field is not available, complete the
+[Contact Support form](https://hub.docker.com/support/contact/). This field
+may need to be manually added.
 
 {{< tabs >}}
 {{< tab name="Docker plan" >}}
@@ -86,7 +120,8 @@
 To add or update your VAT number:
 
 1. Sign in to [Docker Hub](https://hub.docker.com).
-2. For user accounts, Select your avatar in the top-right corner, then **Billing**. For organizations, select the name of the organization.
+2. For user accounts, select your user avatar, then **Billing**. For
+organizations, select the name of the organization.
 3. Select the **Billing address** link.
 4. In the **Billing Information** section, select **Update information**.
 5. Enter your VAT number in the Tax ID section.
@@ -105,7 +140,8 @@
 
 ## View billing history
 
-You can view the billing history and download past invoices for a personal account or organization.
+You can view your billing history and download past invoices for a personal
+account or organization.
 
 ### Personal account
 
@@ -138,9 +174,7 @@
 
 ### Organization
 
-> [!NOTE]
->
-> You must be an owner of the organization to view the billing history.
+You must be an owner of the organization to view the billing history.
 
 {{< tabs >}}
 {{< tab name="Docker plan" >}}
@@ -161,10 +195,10 @@
 1. Sign in to [Docker Hub](https://hub.docker.com).
 2. Select your avatar in the top-right corner.
 3. From the drop-down menu select **Billing**.
-4. Select the **Payment methods and billing history** link.
-    You can find your past invoices in the **Invoice History** section.
+4. Select the **Payment methods and billing history** link. You can find your
+past invoices in the **Invoice History** section.
 
-From here you can download an invoice.
+You can also download an invoice from this page if needed.
 
 {{< /tab >}}
 {{< /tabs >}}

content/manuals/billing/payment-method.md

@@ -7,13 +7,16 @@
     - /billing/core-billing/payment-method/
 ---
 
-This page describes how to add or update a payment method for your personal account or for an organization.
+This page describes how to add or update a payment method for your personal
+account or for an organization.
 
-You can add a payment method or update your account's existing payment method at any time.
+You can add a payment method or update your account's existing payment method
+at any time.
 
 > [!IMPORTANT]
 >
-> If you want to remove all payment methods, you must first downgrade your subscription to a free plan. See [Downgrade](../subscription/change.md).
+> If you want to remove all payment methods, you must first downgrade your
+subscription to a free plan. See [Downgrade](../subscription/change.md).
 
 The following payment methods are supported:
 
@@ -29,8 +32,10 @@
   - Stripe Link
 - Bank accounts
   - ACH transfer with a [verified](manuals/billing/payment-method.md#verify-a-bank-account) US bank account
+- Pay by invoice
 
-All currency, for example the amount listed on your billing invoice, is in United States dollar (USD).
+All currency, for example the amount listed on your billing invoice, is in
+United States dollar (USD).
 
 {{% include "tax-compliance.md" %}}
 
@@ -153,6 +158,25 @@
 {{< /tab >}}
 {{< /tabs >}}
 
+## Enable pay-by-invoice
+
+Pay by invoice is available during first-time checkouts and subscription
+renewals for subscribers with an annual subscription. When enabled, subscription
+renewals will be sent to your billing contact's email address via invoice.
+You can pay an invoice using card or US bank account.
+
+> [!NOTE]
+>
+> Pay by invoice is only available for annual subscriptions. You can't use pay
+by invoice for subscription upgrades or purchasing additional seats.
+
+1. Sign in to [Docker Home](https://app.docker.com/).
+2. Under **Settings and administration**, select **Billing**.
+3. Select **Payment methods**, then **Pay by invoice**.
+4. To enable pay-by-invoice, select the **Pay by invoice** toggle.
+5. Confirm your billing contact details. If you need to change them, select
+**Change** and enter your new billing contact details.
+
 ## Verify a bank account
 
 There are two ways to verify a bank account as a payment method:
@@ -196,24 +220,32 @@
 > You can't manually retry a failed payment. Docker will retry failed payments
 based on the retry schedule.
 
-If your subscription payment fails, there is a grace period of 15 days, including the due date. Docker retries to collect the payment 3 times using the following schedule:
+If your subscription payment fails, there is a grace period of 15 days,
+including the due date. Docker retries to collect the payment 3 times using the following schedule:
 
 - 3 days after the due date
 - 5 days after the previous attempt
 - 7 days after the previous attempt
 
-Docker also sends an email notification `Action Required - Credit Card Payment Failed` with an attached unpaid invoice after each failed payment attempt.
+Docker also sends an email notification
+`Action Required - Credit Card Payment Failed` with an attached unpaid
+invoice after each failed payment attempt.
 
-Once the grace period is over and the invoice is still not paid, the subscription downgrades to a free plan and all paid features are disabled.
+Once the grace period is over and the invoice is still not paid, the
+subscription downgrades to a free plan and all paid features are disabled.
 
 ## Redeem a coupon
 
 You can redeem a coupon for any paid Docker subscription.
 
 A coupon can be used when you:
+
 - Sign up to a new paid subscription from a free subscription
 - Upgrade an existing paid subscription
 
-You are asked to enter your coupon code when you confirm or enter your payment method.
+You are asked to enter your coupon code when you confirm or enter your
+payment method.
 
-If you use a coupon to pay for a subscription, when the coupon expires, your payment method is charged the full cost of your subscription. If you don't have a saved payment method, your account downgrades to a free subscription.
+If you use a coupon to pay for a subscription, when the coupon expires, your
+payment method is charged the full cost of your subscription. If you don't have
+a saved payment method, your account downgrades to a free subscription.

content/manuals/subscription/manage-seats.md

@@ -34,7 +34,8 @@
 2. Under Settings and administration, select **Billing**.
 3. Select your account from the drop-down menu in the top-left.
 4. Select **Add seats**.
-5. Follow the on-screen instructions to complete adding seats.
+5. Follow the on-screen instructions to complete adding seats. Note, you can't
+use pay-by-invoice for purchasing additional seats. You must use a card or US bank account.
 
 > [!NOTE]
 >