From c21791259f82d1425ff3e12182582ecf549b076e Mon Sep 17 00:00:00 2001 From: Alexa Date: Thu, 2 Apr 2026 14:29:39 -0500 Subject: [PATCH 1/6] Add context that calls out disabling pay by invoice --- content/manuals/billing/payment-method.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/content/manuals/billing/payment-method.md b/content/manuals/billing/payment-method.md index 89cab5904fca..5b7061c5fef0 100644 --- a/content/manuals/billing/payment-method.md +++ b/content/manuals/billing/payment-method.md @@ -161,7 +161,7 @@ To add a payment method: {{< /tab >}} {{< /tabs >}} -## Enable pay by invoice +## Enable and disable pay by invoice {{< summary-bar feature_name="Pay by invoice" >}} @@ -174,11 +174,14 @@ At renewal time, instead of automatic payment, you'll receive an invoice via email that you must pay manually. Pay by invoice is not available for subscription upgrades or changes. +Follow these steps to enable or disable pay by invoice: + 1. Sign in to [Docker Home](https://app.docker.com/) and select your organization. 1. Select **Billing**. 1. Select **Payment methods**, then **Pay by invoice**. -1. To enable pay by invoice, select the toggle. + * To enable pay by invoice, select the toggle labeled **Disabled**. + * To disable pay by invoice, select the toggle labeled **Enabled**. 1. Confirm your billing contact details. If you need to change them, select **Change** and enter your new details. From de7be12ca5e18d18008acf5f87827ef51c327943 Mon Sep 17 00:00:00 2001 From: Alexa Date: Thu, 2 Apr 2026 15:37:30 -0500 Subject: [PATCH 2/6] made some more changes but am still waiting on what needs to happen to add Link payment --- content/manuals/billing/payment-method.md | 168 +++++++--------------- 1 file changed, 54 insertions(+), 114 deletions(-) diff --git a/content/manuals/billing/payment-method.md b/content/manuals/billing/payment-method.md index 5b7061c5fef0..fb6c93118fb2 100644 --- a/content/manuals/billing/payment-method.md +++ b/content/manuals/billing/payment-method.md @@ -7,71 +7,57 @@ aliases: - /billing/core-billing/payment-method/ --- -This page describes how to add or update a payment method for your personal -account or for an organization. +Docker supports different payment methods for your paid personal +account or organization. This page describes supported payment types, how to make payments from [Docker Home](https://app.docker.com/), and how to set up pay by invoice. + +## Payment types You can add a payment method or update your account's existing payment method -at any time. If you want to remove all payment methods, you must first downgrade your -subscription to a free subscription. See [Downgrade](../subscription/change.md). - -The following payment methods are supported: - -- Cards - - Visa - - MasterCard - - American Express - - Discover - - JCB - - Diners - - UnionPay -- Wallets - - Stripe Link -- Bank accounts - - Automated Clearing House (ACH) transfer with a - [verified](/manuals/billing/payment-method.md#verify-a-bank-account) US - bank account -- [Pay by invoice](/manuals/billing/history.md) - -All charges are in United States dollars (USD). +at any time. All charges are in United States dollars (USD). The following payment methods are supported: + +| Category | Payment type | +| ------------- | ------------------------------------------------------------------------------ | +| Cards | Visa, MasterCard, American Express, Discover, JCB, Diners, UnionPay | +| Wallets | Stripe Link | +| Bank accounts | Automated Clearing House (ACH) transfer with a verified US bank account + | + +## Prerequisites + +Certain payment methods require additional steps before selecting them as a payment method: + +* You must [verify a bank account](/manuals/billing/payment-method.md#verify-a-bank-account) before choosing it as a payment method. +* You must have a Docker Business or Docker Team plan to [pay by invoice](/billing/payment-method/#enable-and-disable-pay-by-invoice). +* You must have ELEPHANT to set up Stripe Link. {{% include "tax-compliance.md" %}} ## Manage payment method -### Personal account +Paid personal accounts and organizations follow the same procedures to add, update, or remove payment methods. + +### Add payment method {{< tabs >}} {{< tab name="Docker subscription" >}} -To add a payment method: - -1. Sign in to [Docker Home](https://app.docker.com/) and select your - organization. -1. Select **Billing**. -1. Select **Payment methods** from the left-hand menu. -1. Select **Add payment method**. -1. Enter your new payment information: - - Add a card: - - Select **Card** and fill out the card information form. - - Add a Link payment: +1. Sign in to [Docker Home](https://app.docker.com/) and choose either your account or organization. +1. Choose **Billing**, then select **Payment methods**. +1. Select **Add payment method** and enter your new payment information: + - For first time setup, fill in your billing information. + - You will need your tax ID if you're purchasing as a business. +1. Choose to add a card, add a US bank account, or add a Link payment. + - Select **Card** and fill out the card information form. + - Select **US bank account**. + - Verify your **Email** and **Full name**. + - If your bank is listed, select your bank's name. + - If your bank is not listed, select **Search for your bank**. + - ELEPHANT - Select **Secure, 1-click checkout with Link** and enter your Link **email address** and **phone number**. - If you don't already use Link, you must fill out the card information form to store a card for Link payments. - - Add a bank account: - - Select **US bank account**. - - Verify your **Email** and **Full name**. - - If your bank is listed, select your bank's name. - - If your bank is not listed, select **Search for your bank**. - - To verify your bank account, see - [Verify a bank account](/manuals/billing/payment-method.md#verify-a-bank-account). -1. Select **Add payment method**. -1. Optional. You can set a new default payment method by selecting - the **Set as default** action. -1. Optional. You can remove non-default payment methods by selecting - the **Delete** action. - -If you want to set a US bank account as your default payment method, you must [verify the account](#verify-a-bank-account) first. +1. Finish adding the payment method by selecting **Add payment method**. {{< /tab >}} {{< tab name="Legacy Docker subscription" >}} @@ -99,74 +85,31 @@ To add a payment method: {{< /tab >}} {{< /tabs >}} -### Organization - -You must be an organization owner to make changes to the payment information. - -{{< tabs >}} -{{< tab name="Docker subscription" >}} - -To add a payment method: +### Set default payment method -1. Sign in to [Docker Home](https://app.docker.com/) and select your - organization. -1. Select **Billing**. -1. Select **Payment methods** from the left-hand menu. -1. Select **Add payment method**. -1. Enter your new payment information: - - Add a card: - - Select **Card** and fill out the card information form. - - Add a Link payment: - - Select **Secure, 1-click checkout with Link** and enter your - Link **email address** and **phone number**. - - If you are not an existing Link customer, you must fill out the - card information form to store a card for Link payments. - - Add a bank account: - - Select **US bank account**. - - Verify your **Email** and **Full name**. - - If your bank is listed, select your bank's name. - - If your bank is not listed, select **Search for your bank**. - - To verify your bank account, see [Verify a bank account](/manuals/billing/payment-method.md#verify-a-bank-account). -1. Select **Add payment method**. -1. Optional. You can set a new default payment method by selecting - the **Set as default** action. -1. Optional. You can remove non-default payment methods by selecting - the **Delete** action. +After adding one or more payment methods, you can set one as a default method. -If you want to set a US bank account as your default payment method, you must verify the account first. +1. From **Billing**, go to **Payment methods**. +1. Select the three dots for method you want as default from the **Payment method** table. +1. Choose **Set as default**. -{{< /tab >}} -{{< tab name="Legacy Docker subscription" >}} +### Remove payment method -To add a payment method: +To remove a single payment method: -1. Sign in to [Docker Hub](https://hub.docker.com). -1. Select your organization, then select **Billing**. -1. Select the **Payment methods** link. -1. Select **Add payment method**. -1. Enter your new payment information: - - Add a card: - - Select **Card** and fill out the card information form. - - Add a Link payment: - - Select **Secure, 1-click checkout with Link** and enter your - Link **email address** and **phone number**. - - If you are not an existing Link customer, you must fill out the - card information form to store a card for Link payments. -1. Select **Add payment method**. -1. Select the **Actions** icon, then select **Make default** to ensure that - your new payment method applies to all purchases and subscriptions. -1. Optional. You can remove non-default payment methods by selecting - the **Actions** icon. Then, select **Delete**. +1. From **Billing**, go to **Payment methods**. +1. Select the three dots for method you want as default from the **Payment method** table. +1. Choose **Remove**. -{{< /tab >}} -{{< /tabs >}} +If you have an active plan, you can't remove your default payment. To remove all payment methods, [downgrade your +subscription](/subscription/change) to a free subscription. ## Enable and disable pay by invoice -{{< summary-bar feature_name="Pay by invoice" >}} +> [!TIP] +> Do you need to pay by invoice? [Upgrade to a Docker Business or Docker Team plan](https://www.docker.com/pricing?ref=Docs&refAction=DocsBillingPaymentMethod) and choose the annual subscription. -Pay by invoice is available for Teams and Business customers with annual -subscriptions, starting with your first renewal. When you select this +When you select this payment method, you'll pay upfront for your first subscription period using a payment card or ACH bank transfer. @@ -178,16 +121,13 @@ Follow these steps to enable or disable pay by invoice: 1. Sign in to [Docker Home](https://app.docker.com/) and select your organization. -1. Select **Billing**. -1. Select **Payment methods**, then **Pay by invoice**. +2. Select **Billing**. +3. Select **Payment methods**, then **Pay by invoice**. * To enable pay by invoice, select the toggle labeled **Disabled**. * To disable pay by invoice, select the toggle labeled **Enabled**. -1. Confirm your billing contact details. If you need to change them, select +4. Confirm your billing contact details. If you need to change them, select **Change** and enter your new details. -> [!TIP] -> Do you need to pay by invoice? [Upgrade to a Docker Business or Docker Team plan](https://www.docker.com/pricing?ref=Docs&refAction=DocsBillingPaymentMethod) and choose the annual subscription. - ## Verify a bank account There are two ways to verify a bank account as a payment method: From ad65c1063bb840dc162f38e7d7104717df54e3b9 Mon Sep 17 00:00:00 2001 From: Alexa Date: Thu, 2 Apr 2026 16:04:48 -0500 Subject: [PATCH 3/6] update with stripe link info that was hidden in the doc, fix some markdown goofiness, and my lazy writing --- content/manuals/billing/payment-method.md | 23 +++++++++-------------- 1 file changed, 9 insertions(+), 14 deletions(-) diff --git a/content/manuals/billing/payment-method.md b/content/manuals/billing/payment-method.md index fb6c93118fb2..a979aad3edca 100644 --- a/content/manuals/billing/payment-method.md +++ b/content/manuals/billing/payment-method.md @@ -19,16 +19,15 @@ at any time. All charges are in United States dollars (USD). The following payme | ------------- | ------------------------------------------------------------------------------ | | Cards | Visa, MasterCard, American Express, Discover, JCB, Diners, UnionPay | | Wallets | Stripe Link | -| Bank accounts | Automated Clearing House (ACH) transfer with a verified US bank account - | +| Bank accounts | Automated Clearing House (ACH) transfer with a verified US bank account | ## Prerequisites Certain payment methods require additional steps before selecting them as a payment method: -* You must [verify a bank account](/manuals/billing/payment-method.md#verify-a-bank-account) before choosing it as a payment method. -* You must have a Docker Business or Docker Team plan to [pay by invoice](/billing/payment-method/#enable-and-disable-pay-by-invoice). -* You must have ELEPHANT to set up Stripe Link. +* You must [verify a bank account](/manuals/billing/payment-method.md#verify-a-bank-account) before choosing a bank account as a payment method. +* You must have a Docker Business or Docker Team plan to [pay by invoice](/billing/payment-method/#enable-and-disable-pay-by-invoice) +* You must be an existing Stripe Link customer, or fill out the card information form to store a card for Link payments. {{% include "tax-compliance.md" %}} @@ -52,11 +51,7 @@ Paid personal accounts and organizations follow the same procedures to add, upda - Verify your **Email** and **Full name**. - If your bank is listed, select your bank's name. - If your bank is not listed, select **Search for your bank**. - - ELEPHANT - - Select **Secure, 1-click checkout with Link** and enter your - Link **email address** and **phone number**. - - If you don't already use Link, you must fill out the card information - form to store a card for Link payments. + - Select **Use this card** to pay through Link. 1. Finish adding the payment method by selecting **Add payment method**. {{< /tab >}} @@ -90,16 +85,16 @@ To add a payment method: After adding one or more payment methods, you can set one as a default method. 1. From **Billing**, go to **Payment methods**. -1. Select the three dots for method you want as default from the **Payment method** table. -1. Choose **Set as default**. +2. From the **Payment method table**, find the method to set as the default. +3. Select the three dots, then choose **Set as default**. ### Remove payment method To remove a single payment method: 1. From **Billing**, go to **Payment methods**. -1. Select the three dots for method you want as default from the **Payment method** table. -1. Choose **Remove**. +1. From the **Payment method table**, find the method to remove. +1. Select the three dots, then choose **Remove**. If you have an active plan, you can't remove your default payment. To remove all payment methods, [downgrade your subscription](/subscription/change) to a free subscription. From e4d017e8ca26ee0fd0d1d8b57ab4f129c9340d3a Mon Sep 17 00:00:00 2001 From: Alexa Date: Thu, 2 Apr 2026 16:13:56 -0500 Subject: [PATCH 4/6] i wrote some bad copy --- content/manuals/billing/payment-method.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/content/manuals/billing/payment-method.md b/content/manuals/billing/payment-method.md index a979aad3edca..4805e87a6650 100644 --- a/content/manuals/billing/payment-method.md +++ b/content/manuals/billing/payment-method.md @@ -25,9 +25,9 @@ at any time. All charges are in United States dollars (USD). The following payme Certain payment methods require additional steps before selecting them as a payment method: -* You must [verify a bank account](/manuals/billing/payment-method.md#verify-a-bank-account) before choosing a bank account as a payment method. -* You must have a Docker Business or Docker Team plan to [pay by invoice](/billing/payment-method/#enable-and-disable-pay-by-invoice) -* You must be an existing Stripe Link customer, or fill out the card information form to store a card for Link payments. +* You must [verify a bank account](/manuals/billing/payment-method.md#verify-a-bank-account) before choosing a bank account. +* You must have a Docker Business or Docker Team plan to [pay by invoice](/billing/payment-method/#enable-and-disable-pay-by-invoice). +* You must be an existing Stripe Link customer, or fill out the card information form to use Link payments. {{% include "tax-compliance.md" %}} @@ -44,7 +44,7 @@ Paid personal accounts and organizations follow the same procedures to add, upda 1. Choose **Billing**, then select **Payment methods**. 1. Select **Add payment method** and enter your new payment information: - For first time setup, fill in your billing information. - - You will need your tax ID if you're purchasing as a business. + - To purchase as a business, provide your tax ID. 1. Choose to add a card, add a US bank account, or add a Link payment. - Select **Card** and fill out the card information form. - Select **US bank account**. @@ -85,7 +85,7 @@ To add a payment method: After adding one or more payment methods, you can set one as a default method. 1. From **Billing**, go to **Payment methods**. -2. From the **Payment method table**, find the method to set as the default. +2. Find the payment method you want to set as default from the **Payment method table**. 3. Select the three dots, then choose **Set as default**. ### Remove payment method @@ -93,7 +93,7 @@ After adding one or more payment methods, you can set one as a default method. To remove a single payment method: 1. From **Billing**, go to **Payment methods**. -1. From the **Payment method table**, find the method to remove. +1. Find the payment method you want to remove from the **Payment method table**. 1. Select the three dots, then choose **Remove**. If you have an active plan, you can't remove your default payment. To remove all payment methods, [downgrade your From 0609fb6504f8f6631012a54812a597e236bb22de Mon Sep 17 00:00:00 2001 From: Alexa Date: Thu, 2 Apr 2026 16:37:16 -0500 Subject: [PATCH 5/6] review bot --- content/manuals/billing/payment-method.md | 17 +++++++---------- 1 file changed, 7 insertions(+), 10 deletions(-) diff --git a/content/manuals/billing/payment-method.md b/content/manuals/billing/payment-method.md index 4805e87a6650..e9509e6d3bf2 100644 --- a/content/manuals/billing/payment-method.md +++ b/content/manuals/billing/payment-method.md @@ -40,8 +40,8 @@ Paid personal accounts and organizations follow the same procedures to add, upda {{< tabs >}} {{< tab name="Docker subscription" >}} -1. Sign in to [Docker Home](https://app.docker.com/) and choose either your account or organization. -1. Choose **Billing**, then select **Payment methods**. +1. Sign in to [Docker Home](https://app.docker.com/). Select your account name for personal accounts, or select your organization name for organization accounts. +1. Select **Billing**, then **Payment methods**. 1. Select **Add payment method** and enter your new payment information: - For first time setup, fill in your billing information. - To purchase as a business, provide your tax ID. @@ -85,28 +85,25 @@ To add a payment method: After adding one or more payment methods, you can set one as a default method. 1. From **Billing**, go to **Payment methods**. -2. Find the payment method you want to set as default from the **Payment method table**. -3. Select the three dots, then choose **Set as default**. +1. Find the payment method you want to set as default from the **Payment method** table. +1. Select the three dots, then choose **Set as default**. ### Remove payment method To remove a single payment method: 1. From **Billing**, go to **Payment methods**. -1. Find the payment method you want to remove from the **Payment method table**. +1. Find the payment method you want to remove from the **Payment method** table. 1. Select the three dots, then choose **Remove**. -If you have an active plan, you can't remove your default payment. To remove all payment methods, [downgrade your -subscription](/subscription/change) to a free subscription. +To remove your default payment method, first set a different payment method as default, or [downgrade to a free subscription](/subscription/change). ## Enable and disable pay by invoice > [!TIP] > Do you need to pay by invoice? [Upgrade to a Docker Business or Docker Team plan](https://www.docker.com/pricing?ref=Docs&refAction=DocsBillingPaymentMethod) and choose the annual subscription. -When you select this -payment method, you'll pay upfront for your first subscription period using a -payment card or ACH bank transfer. +Pay by invoice requires you to pay upfront for your first subscription period using a payment card or ACH bank transfer. At renewal time, instead of automatic payment, you'll receive an invoice via email that you must pay manually. Pay by invoice is not available for From 9228781ba5ff5dc3d190f026b3c19ed05ffee0d4 Mon Sep 17 00:00:00 2001 From: Alexa Date: Thu, 2 Apr 2026 17:08:33 -0500 Subject: [PATCH 6/6] tinkering --- content/manuals/billing/payment-method.md | 29 +++++++++++------------ 1 file changed, 14 insertions(+), 15 deletions(-) diff --git a/content/manuals/billing/payment-method.md b/content/manuals/billing/payment-method.md index e9509e6d3bf2..1b45b954f3df 100644 --- a/content/manuals/billing/payment-method.md +++ b/content/manuals/billing/payment-method.md @@ -10,7 +10,7 @@ aliases: Docker supports different payment methods for your paid personal account or organization. This page describes supported payment types, how to make payments from [Docker Home](https://app.docker.com/), and how to set up pay by invoice. -## Payment types +## Supported payment types You can add a payment method or update your account's existing payment method at any time. All charges are in United States dollars (USD). The following payment methods are supported: @@ -40,18 +40,19 @@ Paid personal accounts and organizations follow the same procedures to add, upda {{< tabs >}} {{< tab name="Docker subscription" >}} -1. Sign in to [Docker Home](https://app.docker.com/). Select your account name for personal accounts, or select your organization name for organization accounts. +1. Sign in to [Docker Home](https://app.docker.com/). +1. Select your account name for personal accounts, or select your organization name for organization accounts. 1. Select **Billing**, then **Payment methods**. 1. Select **Add payment method** and enter your new payment information: - For first time setup, fill in your billing information. - To purchase as a business, provide your tax ID. -1. Choose to add a card, add a US bank account, or add a Link payment. - - Select **Card** and fill out the card information form. - - Select **US bank account**. +1. Choose to add a card, a US bank account, or a Link payment. + - To pay with card, fill out the card information form. + - To pay with a US bank account: - Verify your **Email** and **Full name**. - If your bank is listed, select your bank's name. - If your bank is not listed, select **Search for your bank**. - - Select **Use this card** to pay through Link. + - To pay through Link, select an existing payment and choose **Use this card**. 1. Finish adding the payment method by selecting **Add payment method**. {{< /tab >}} @@ -103,23 +104,21 @@ To remove your default payment method, first set a different payment method as d > [!TIP] > Do you need to pay by invoice? [Upgrade to a Docker Business or Docker Team plan](https://www.docker.com/pricing?ref=Docs&refAction=DocsBillingPaymentMethod) and choose the annual subscription. -Pay by invoice requires you to pay upfront for your first subscription period using a payment card or ACH bank transfer. - -At renewal time, instead of automatic payment, you'll receive an invoice via -email that you must pay manually. Pay by invoice is not available for -subscription upgrades or changes. +Pay by invoice requires you to pay upfront for your first subscription period using a payment card or ACH bank transfer. At renewal time, instead of automatic payment, you'll receive an invoice via +email that you must pay manually. Follow these steps to enable or disable pay by invoice: 1. Sign in to [Docker Home](https://app.docker.com/) and select your organization. -2. Select **Billing**. -3. Select **Payment methods**, then **Pay by invoice**. - * To enable pay by invoice, select the toggle labeled **Disabled**. - * To disable pay by invoice, select the toggle labeled **Enabled**. +2. Select **Billing**, then **Payment methods**. +3. Select **Pay by invoice**, then select the pay by invoice toggle to enable or disable. 4. Confirm your billing contact details. If you need to change them, select **Change** and enter your new details. +Pay by invoice is not available for +subscription upgrades or changes. + ## Verify a bank account There are two ways to verify a bank account as a payment method: