docs: refresh billing documentation

content/manuals/billing/3d-secure.md

@@ -1,8 +1,8 @@
 ---
 title: Use 3D Secure authentication for Docker billing
 linkTitle: 3D Secure
-description: Docker billing supports 3D Secure (3DS) for secure payment authentication. Learn how 3DS works with Docker subscriptions.
-keywords: billing, renewal, payments, subscriptions, 3DS, credit card verification, secure payments, Docker billing security
+description: Learn how 3D Secure authentication works for Docker subscription payments and how to troubleshoot verification issues.
+keywords: billing, payments, subscriptions, 3D Secure, 3DS, credit card verification, payment authentication
 weight: 30
 ---
 
@@ -28,9 +28,10 @@ You may be asked to verify your identity when performing any of the following
 actions:
 
 - Starting a [paid subscription](../subscription/manage.md)
-- Changing your [billing cycle](/manuals/billing/cycle.md) from monthly to annual
+- Changing your [billing cycle](/manuals/billing/details.md#billing-cycle) from monthly to annual
 - [Upgrading your subscription](../subscription/manage.md#upgrade-plans)
-- [Adding seats](../admin/organization/manage/manage-seats.md) to an existing subscription
+- [Adding seats](../admin/organization/manage/manage-seats.md) to an existing
+  subscription
 
 If 3DS is required and your payment method supports it, the verification prompt
 will appear during checkout.
@@ -41,9 +42,8 @@ If you're unable to complete your payment due to 3DS:
 
 1. Retry your transaction. Make sure you're completing the verification
    prompt in the same browser tab.
-1. Use a different payment method. Some cards may not support 3DS properly
-   or be blocked.
-1. Contact your bank. Your bank may be blocking the payment or the 3DS
+1. Use a different payment method.
+1. Contact your bank to confirm whether it's blocking the payment or the 3DS
    verification attempt.
 
 > [!NOTE]

content/manuals/billing/_index.md

@@ -8,35 +8,42 @@ params:
   sidebar:
     group: Platform
 grid_core:
-- title: Add or update a payment method
-  description: Learn how to add or update a payment method for your personal account or organization.
-  link: /billing/payment-method/
-  icon: credit-card
-- title: Update billing information
-  description: Discover how to update the billing information for your personal account or organization.
-  link: /billing/details/
-  icon: pencil-square
-- title: View billing history
-  description: Learn how to view billing history and download past invoices.
-  link: /billing/history/
-  icon: credit-card
-- title: Billing FAQs
-  description: Find the answers you need and explore common questions.
-  link: /billing/faqs/
-  icon: question-mark-circle
-- title: Register a tax certificate
-  description: Learn how to register a tax exemption certificate.
-  link: /billing/tax-certificate/
-  icon: book-open
-- title: 3D Secure authentication
-  description: Discover how Docker billing supports 3DS and how to troubleshoot potential issues.
-  link: /billing/3d-secure/
-  icon: wallet
+  - title: Add or update a payment method
+    description: Learn how to add or update a payment method for your personal account or organization.
+    link: /billing/payment-method/
+    icon: credit-card
+  - title: Update billing information
+    description: Learn how to update billing information for your personal account or organization.
+    link: /billing/details/
+    icon: pencil-square
+  - title: View billing history
+    description: Learn how to view billing history and download past invoices.
+    link: /billing/history/
+    icon: credit-card
+  - title: 3D Secure authentication
+    description: Learn how 3DS works and how to troubleshoot verification issues.
+    link: /billing/3d-secure/
+    icon: wallet
 aliases:
   - /billing/docker-hub-pricing/
 ---
 
-Use the resources in this section to manage billing and payments for your Docker
-subscriptions.
+You can use the billing portal to manage actions for your Docker subscriptions, such as updating
+payment methods, reviewing billing details, and tracking invoice history.
+
+## Docker plans and billing behaviors
+
+Your invoice history is a reference to the Docker plans you subscribe to. To understand more about how you were invoiced, such as renewal dates and billing cycles, review the [plan details](/manuals/subscription/plans/_index.md)
+for what you've subscribed to. To upgrade or add a new plan, see [Subscription](/manuals/subscription/_index.md).
+
+## Sales tax and VAT
+
+Depending on your location, Docker may collect sales tax or VAT on your
+subscription. To add your VAT number or Tax ID, do so when you
+[purchase a Docker plan](/manuals/subscription/manage.md#set-up-a-new-plan).
+If you're a US customer exempt from sales tax, you can
+[submit a tax exemption certificate](/manuals/billing/tax-certificate.md).
+
+## What's next
 
 {{< grid items="grid_core" >}}

content/manuals/billing/details.md

@@ -1,93 +1,40 @@
 ---
-title: Update your billing information
-linkTitle: Update information
+title: Update your billing details
+linkTitle: Update details
 weight: 40
-description: Learn how to update your billing information in Docker Hub
-keywords: payments, billing, subscription, invoices, update billing email, change billing address, VAT ID, Docker billing account
+description: Learn how to update billing details, like contact information, addresses, and notification email for Docker subscriptions.
+keywords: payments, billing, subscription, invoices, update billing email, change billing address, Docker billing account
+aliases:
+  - /billing/cycle/
 ---
 
-You can update the billing information for your personal account or for an
-organization. When you update your billing information, these changes apply to
-future billing invoices. The email address you provide for a billing account is
-where Docker sends all invoices and other billing related communications.
+You can update your billing contact information, address, and notification email at any time. Existing invoices, whether paid or unpaid, cannot be updated. Changes only apply to future invoices.
 
-> [!NOTE]
->
-> Existing invoices, whether paid or unpaid, cannot be updated.
-> Changes only apply to future invoices.
+## Update billing details
 
-## Manage billing information
+You can update your billing details for Docker individual accounts and Docker organization accounts using the same procedures.
 
-### Personal account
+To update your billing information from **Settings** in Docker Home:
 
-To update your billing information:
+1. Sign in to [Docker Home](https://app.docker.com/) and select your personal or organization
+   account.
+1. Select **Billing**, then go to **Settings**.
+1. Select **Edit**, then choose **Update** next to your current billing contact and billing address information.
+1. Verify your information, then select **Save as default**.
 
-1. Sign in to [Docker Home](https://app.docker.com/) and select your
-   organization.
-1. Select **Billing**.
-1. Select **Billing information** from the left-hand navigation.
-1. On your billing information card, select **Change**.
-1. Update your billing contact and billing address information.
-1. Optional. To add or update a VAT ID, select the **I'm purchasing as a business** checkbox and enter your Tax ID.
+For more information on changing your default payment method, see [Change default payment method](/manuals/billing/payment-method.md#change-default-payment-method).
 
-   > [!IMPORTANT]
-   >
-   > Your VAT number must include your country prefix. For example, if you are
-   > entering a VAT number for Germany, you would enter `DE123456789`.
+## Billing notifications
 
-1. Select **Update**.
+Docker sends invoices and other billing-related communications
+to the billing account's email address. These communications include:
 
-### Organization
+- Confirmations, such as new subscriptions, paid invoices
+- Notifications for card failure and card expiration errors
+- Reminders for subscription renewal
 
-> [!NOTE]
->
-> You must be an organization owner to make changes to the billing information.
+## Billing cycle
 
-To update your billing information:
-
-1. Sign in to [Docker Home](https://app.docker.com/) and select your
-   organization.
-1. Select **Billing**.
-1. Select **Billing information** from the left-hand navigation.
-1. On your billing information card, select **Change**.
-1. Update your billing contact and billing address information.
-1. Optional. To add or update a VAT ID, select the **I'm purchasing as a business** checkbox and enter your Tax ID.
-
-   > [!IMPORTANT]
-   >
-   > Your VAT number must include your country prefix. For example, if you are
-   > entering a VAT number for Germany, you would enter `DE123456789`.
-
-1. Select **Update**.
-
-## Update your billing email address
-
-Docker sends the following billing-related emails:
-
-- Confirmations (new subscriptions, paid invoices)
-- Notifications (card failure, card expiration)
-- Reminders (subscription renewal)
-
-You can update the email address that receives billing invoices at any time.
-
-### Personal account
-
-To update your billing email address:
-
-1. Sign in to [Docker Home](https://app.docker.com/) and select your
-   organization.
-1. Select **Billing**.
-1. Select **Billing information** from the left-hand navigation.
-1. On your billing information card, select **Change**.
-1. Update your billing contact information and select **Update**.
-
-### Organizations
-
-To update your billing email address:
-
-1. Sign in to [Docker Home](https://app.docker.com/) and select
-   your organization.
-1. Select **Billing**.
-1. Select **Billing information** from the left-hand navigation.
-1. On your billing information card, select **Change**.
-1. Update your billing contact information and select **Update**.
+Billing cycles are defined on a per-plan basis. Depending on the product you
+subscribe to, your cycle can be monthly, annual, or another cadence. For
+plan-specific billing cycle details, see [Plans](/manuals/subscription/plans/_index.md).

content/manuals/billing/faqs.md

@@ -1,17 +1,17 @@
 ---
 title: Billing FAQs
 linkTitle: FAQs
-description: Frequently asked questions related to billing
-keywords: billing, renewal, payments, faq
+description: Find answers to common questions about Docker billing, failed payments, taxes, and pay by invoice.
+keywords: billing, renewal, failed payments, sales tax, VAT, academic pricing, pay by invoice
 tags: [FAQ]
 weight: 80
 ---
 
-### What happens if my subscription payment fails?
+## What happens if my subscription payment fails?
 
 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:
+including the due date. Docker attempts to collect the payment three times using
+the following schedule:
 
 - 3 days after the due date
 - 5 days after the previous attempt
@@ -21,39 +21,42 @@ 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
+If the invoice remains unpaid after the grace period, the
 subscription downgrades to a free subscription and all paid features are
 disabled.
 
-### Can I manually retry a failed payment?
+## Can I manually retry a failed payment?
 
-No. Docker retries failed payments on a [retry schedule](/manuals/billing/faqs.md#what-happens-if-my-subscription-payment-fails).
+Yes. If your payment fails, select **Pay now** to retry the payment through
+Stripe.
 
-To ensure a retired payment is successful, verify your default payment is
-updated. If you need to update your default payment method, see
-[Manage payment method](/manuals/billing/payment-method.md#manage-payment-method).
+Before retrying, verify that your default payment method is up to date. For
+instructions, see
+[Manage a payment method](/manuals/billing/payment-method.md#manage-payment-method).
 
-### Does Docker collect sales tax and/or VAT?
+## Does Docker collect sales tax and VAT?
 
-Docker collects sales tax and/or VAT from the following:
+Docker collects sales tax or VAT from the following customers:
 
-- For United States customers, Docker began collecting sales tax on July 1, 2024.
+- For United States customers, Docker began collecting sales tax on
+  July 1, 2024.
 - For European customers, Docker began collecting VAT on March 1, 2025.
 - For United Kingdom customers, Docker began collecting VAT on May 1, 2025.
 
-To ensure that tax assessments are correct, make sure that your billing
-information and VAT/Tax ID, if applicable, are updated. See
-[Update the billing information](/manuals/billing/details.md).
+To help ensure correct tax assessments, keep your
+[billing information](/manuals/billing/details.md) up to date. You can add a
+tax ID or VAT ID when you
+[purchase a Docker plan](/manuals/subscription/manage.md#set-up-a-new-plan).
 
 If you're exempt from sales tax, see
-[Register a tax certificate](/manuals/billing/tax-certificate.md).
+[Submit a tax certificate](/manuals/billing/tax-certificate.md).
 
-### Does Docker offer academic pricing?
+## Does Docker offer academic pricing?
 
 For academic pricing, contact the
 [Docker Sales Team](https://www.docker.com/company/contact).
 
-### Can I use pay by invoice for upgrades or additional seats?
+## Can I use pay by invoice for upgrades or additional seats?
 
 No. Pay by invoice is only available for renewing annual subscriptions, not for
 purchasing upgrades or additional seats. You must use card payment or US bank