billing: freshness

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

@@ -1,31 +1,52 @@
 ---
-title: 3D Secure authentication
-description: Learn about 3D Secure support for Docker billing.
-keywords: billing, renewal, payments, subscriptions
+title: Use 3D Secure authentication for Docker billing
+linkTitle: 3D Secure authentication
+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
 weight: 40
 ---
 
-> [!NOTE]
->
-> [Docker subscription](../subscription/setup.md) payments support 3D secure authentication.
+Docker supports 3D Secure (3DS), an extra layer of authentication required
+for certain credit card payments. If your bank or card issuer requires 3DS, you
+may need to verify your identity before your payment can be completed.
+
+## How it works
+
+When a 3DS check is triggered during checkout, your bank or card issuer
+may ask you to verify your identity. This can include:
 
-3D Secure (3DS) authentication incorporates an additional security layer for credit card transactions. If you’re making payments for your Docker billing in a region that requires 3DS, or using a payment method that requires 3DS, you’ll need to verify your identity to complete any transactions. The method used to verify your identity varies depending on your banking institution.
+- Entering a one-time password sent to your phone
+- Approving the charge through your mobile banking app
+- Answering a security question or using biometrics
 
-The following transactions will use 3DS authentication if your payment method requires it.
+The exact verification steps depend on your financial institution's
+requirements.
 
-- Starting a [new paid subscription](../subscription/setup.md)
+## When you need to verify
+
+You may be asked to verify your identity when performing any of the following
+actions:
+
+- Starting a [paid subscription](../subscription/setup.md)
 - Changing your [billing cycle](/billing/cycle/) from monthly to annual
 - [Upgrading your subscription](../subscription/change.md)
 - [Adding seats](../subscription/manage-seats.md) to an existing subscription
 
-## Troubleshooting
+If 3DS is required and your payment method supports it, the verification prompt
+will appear during checkout.
 
-If you encounter errors completing payments due to 3DS, you can troubleshoot in the following ways.
+## Troubleshooting payment verification
 
-1. Retry your transaction and verification of your identity.
-2. Contact your bank to determine any errors on their end.
-3. Try a different payment method that doesn’t require 3DS.
+If you're unable to complete your payment due to 3DS:
 
-> [!TIP]
+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
+verification attempt.
+
+> [!NOTE]
 >
-> Make sure you allow third-party scripts in your browser and that any ad blocker you may use is disabled when attempting to complete payments.
+> Disabling ad blockers or browser extensions that block pop-ups can help
+the 3DS prompt display correctly.

content/manuals/billing/_index.md

@@ -1,9 +1,9 @@
 ---
-title: Billing and payments
+title: Manage billing and payments
 linkTitle: Billing
-description: Discover information on billing and payment processes for Docker subscriptions.
-keywords: billing, invoice, payment, subscription
-weight: 20
+description: Find information about managing billing and payments for Docker subscriptions.
+keywords: billing, invoice, payment, subscription, Docker billing, update payment method, billing history, invoices, payment verification, tax exemption
+weight: 10
 params:
   sidebar:
     group: Platform
@@ -36,6 +36,7 @@ aliases:
   - /billing/docker-hub-pricing/
 ---
 
-Use the resources in this section to manage your billing and payment settings for your Docker subscriptions.
+Use the resources in this section to manage billing and payments for your Docker
+subscriptions.
 
 {{< grid items="grid_core" >}}

content/manuals/billing/cycle.md

@@ -5,42 +5,41 @@ description: Learn to change your billing cycle for your Docker subscription
 keywords: billing, cycle, payments, subscription
 ---
 
-You can pay for a subscription on a monthly or yearly billing cycle. You select
-your preferred billing cycle when you buy your subscription.
+You can choose between a monthly or annual billing cycle when purchasing a
+Docker subscription. If you have a monthly billing cycle, you can choose to
+switch to an annual
+billing cycle.
 
 > [!NOTE]
 >
-> Business subscriptions are available only on yearly billing cycle.
-
-If you have a monthly billing cycle, you can choose to switch to an annual
-billing cycle.
+> Docker Business subscriptions are only available on an annual billing cycle.
 
 > [!NOTE]
 >
-> You can't switch from an annual billing cycle to a monthly cycle.
+> Switching from an annual billing cycle 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,
+- Your 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 subscription, 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 subscription's start date resets. For example, if the monthly
+subscription started on March 1 and ended on April 1, switching the billing
+duration on March 15, 2024, resets the new start date to March 15, 2024, with
+an end date of March 15, 2025.
+- Any unused portion of your monthly subscription is prorated and applied as
+credit toward an annual subscription. For example, if your monthly cost is $10
+and you're used value is $5, when you switch to an annual cycle ($100), the
+final charge is $95 ($100-$5).
 
 {{% include "tax-compliance.md" %}}
 
-## Personal account
+## Change personal account to an annual cycle
 
 {{< tabs >}}
 {{< tab name="Docker subscription" >}}
 
-To change your billing cycle:
+Follow these steps to switch from a monthly to annual billing
+cycle for your Docker subscription:
 
 1. Sign in to [Docker Home](https://app.docker.com/) and select
 your organization.
@@ -56,13 +55,14 @@ your organization.
 > more information, see
 [Verify a bank account](manuals/billing/payment-method.md#verify-a-bank-account).
 
-The billing plans and usage page will now reflect your new annual subscription
-details.
+After completing the change, the billing plans and usage page displays
+your updated annual subscription details.
 
 {{< /tab >}}
 {{< tab name="Legacy Docker subscription" >}}
 
-To change your billing cycle:
+Follow these steps to switch from a monthly to annual billing cycle for
+a legacy Docker subscription:
 
 1. Sign in to [Docker Hub](https://hub.docker.com).
 1. Select your organization, then select **Billing**.
@@ -73,7 +73,7 @@ page and select **Accept Terms and Purchase** to confirm.
 {{< /tab >}}
 {{< /tabs >}}
 
-## Organization
+## Change organization to an annual cycle
 
 > [!NOTE]
 >
@@ -82,7 +82,8 @@ page and select **Accept Terms and Purchase** to confirm.
 {{< tabs >}}
 {{< tab name="Docker subscription" >}}
 
-To change your organization's billing cycle:
+Follow these steps to switch from a monthly to annual billing cycle for your
+organization's Docker subscription:
 
 1. Sign in to [Docker Home](https://app.docker.com/) and select
 your organization.
@@ -101,7 +102,8 @@ your organization.
 {{< /tab >}}
 {{< tab name="Legacy Docker subscription" >}}
 
-To change your organization's billing cycle:
+Follow these steps to switch from a monthly to annual billing cycle for a
+legacy Docker organization subscription:
 
 1. Sign in to [Docker Hub](https://hub.docker.com).
 1. Select your organization, then select **Billing**.
@@ -110,4 +112,4 @@ To change your organization's billing cycle:
 page and select **Accept Terms and Purchase** to confirm.
 
 {{< /tab >}}
-{{< /tabs >}}
+{{< /tabs >}}

content/manuals/billing/details.md

@@ -1,13 +1,19 @@
 ---
-title: Update billing information
+title: Manage your billing information
 weight: 30
 description: Learn how to update your billing information in Docker Hub
-keywords: payments, billing, subscription, invoices
+keywords: payments, billing, subscription, invoices, update billing email, change billing address, VAT ID, Docker billing account
 ---
 
-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. Note that you can't update an existing invoice, including paid and unpaid invoices.
+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.
 
-The billing information provided appears on all your billing invoices. The email address provided is where Docker sends all invoices and other [billing-related communication](#update-your-billing-invoice-email-address).
+> [!NOTE]
+>
+> Existing invoices, whether paid or unpaid, cannot be updated.
+Changes only apply to future invoices.
 
 {{% include "tax-compliance.md" %}}
 
@@ -101,17 +107,13 @@ To update your billing information:
 {{< /tab >}}
 {{< /tabs >}}
 
-## Update your billing invoice email address
+## Update your billing email address
 
 Docker sends the following billing-related emails:
 
-- Confirmation of a new subscription.
-- Confirmation of paid invoices.
-- Notifications of credit or debit card payment failures.
-- Notifications of credit or debit card expiration.
-- Confirmation of a cancelled subscription
-- Reminders of subscription renewals for annual subscribers. This is sent 14
-days before the renewal date.
+- 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.
 

content/manuals/billing/faqs.md

@@ -7,33 +7,23 @@ tags: [FAQ]
 weight: 60
 ---
 
-### What credit and debit cards are supported?
-
-- Visa
-- MasterCard
-- American Express
-- Discover
-- JCB
-- Diners
-- UnionPay
-- Link
-- ACH transfer with a [verified](manuals/billing/payment-method.md#verify-a-bank-account) US bank account
-
-### What currency is supported?
-
-United States dollar (USD).
-
 ### 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:
+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 subscription 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 subscription and all paid features are
+disabled.
 
 ### Can I manually retry a failed payment?
 
@@ -58,14 +48,7 @@ information and VAT/Tax ID, if applicable, are updated. See
 If you're exempt from sales tax, see
 [Register a tax certificate](/billing/tax-certificate/).
 
-### How do I certify my tax exempt status?
-
-If you're exempt from sales tax, you can [register a valid tax exemption certificate](./tax-certificate.md) with Docker's Support team. [Contact Support](https://hub.docker.com/support/contact) to get started.
-
 ### Does Docker offer academic pricing?
 
-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.
+For academic pricing, contact the
+[Docker Sales Team](https://www.docker.com/company/contact).