draft: pay by invoice

Author: sarahsanders-docker

content/manuals/billing/cycle.md

@@ -9,14 +9,10 @@ You can pay for a subscription plan on a monthly or yearly billing cycle. You se
 
 > [!NOTE]
 >
-> Business plan is available only on yearly billing cycle.
+> Business plan is available only on yearly billing cycle. You can't switch from an annual billing cycle to a monthly 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.
-
 When you change the billing cycle's duration:
 
 - The next billing date reflects the new cycle. To find your next billing date, see [View renewal date](history.md#view-renewal-date).
@@ -30,6 +26,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.
+
 To change your billing cycle:
 
 1. Sign in to [Docker Home](https://app.docker.com/).

content/manuals/billing/faqs.md

@@ -58,4 +58,10 @@ Contact the [Docker Sales Team](https://www.docker.com/company/contact).
 
 ### 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.

content/manuals/billing/history.md

@@ -1,17 +1,20 @@
 ---
-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 incoice
 
 Your invoice includes the following:
 
@@ -20,19 +23,44 @@ Your invoice includes the following:
 - Date due
 - Your "Bill to" information
 - Amount due (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:
 
 - 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).
 
-### View renewal date
+## Pay an invoice
+
+> [!NOTE]
+>
+> Pay by invoice is only available for subscribers on an annual billing cylce.
+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.
+
+> [!NOTE]
+>
+> 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" >}}
@@ -53,7 +81,7 @@ You receive your invoice when the subscription renews. To verify your renewal da
 {{< /tab >}}
 {{< /tabs >}}
 
-### Include your VAT number on your invoice
+## Include your VAT number on your invoice
 
 > [!NOTE]
 >

content/manuals/billing/payment-method.md

@@ -25,6 +25,7 @@ The following payment methods are supported:
 - Diners
 - UnionPay
 - Link
+- Pay by invoice
 
 All currency, for example the amount listed on your billing invoice, is in United States dollar (USD).
 
@@ -126,6 +127,25 @@ To add a payment method:
 {{< /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.
+
 ## Failed payments
 
 > [!NOTE]

content/manuals/subscription/manage-seats.md

@@ -34,7 +34,9 @@ To add seats to your subscription:
 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.
 
 You can now add more members to your organization. For more information, see [Manage organization members](../admin/organization/members.md).