Skip to content

Add context that calls out disabling pay by invoice #24615

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
akristen wants to merge 6 commits into
base: main
Choose a base branch
from
+55 −121
Open

Add context that calls out disabling pay by invoice #24615

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
c217912
Add context that calls out disabling pay by invoice
akristen Apr 2, 2026
de7be12
made some more changes but am still waiting on what needs to happen t…
akristen Apr 2, 2026
ad65c10
update with stripe link info that was hidden in the doc, fix some mar…
akristen Apr 2, 2026
e4d017e
i wrote some bad copy
akristen Apr 2, 2026
0609fb6
review bot
akristen Apr 2, 2026
9228781
tinkering
akristen Apr 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
176 changes: 55 additions & 121 deletions content/manuals/billing/payment-method.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,71 +7,53 @@
- /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.

## Supported 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 |

Check warning on line 22 in content/manuals/billing/payment-method.md

View workflow job for this annotation

GitHub Actions / validate (vale) 

[vale] reported by reviewdog 🐶
[Docker.We] Avoid using first-person plural like 'US'.

Raw Output:
{"message": "[Docker.We] Avoid using first-person plural like 'US'.", "location": {"path": "content/manuals/billing/payment-method.md", "range": {"start": {"line": 22, "column": 75}}}, "severity": "WARNING"}

## 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 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" %}}

## 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:
- 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**.
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.

Check warning on line 44 in content/manuals/billing/payment-method.md

View workflow job for this annotation

GitHub Actions / validate (vale) 

[vale] reported by reviewdog 🐶
[Docker.RecommendedWords] Consider using 'username' instead of 'account name'

Raw Output:
{"message": "[Docker.RecommendedWords] Consider using 'username' instead of 'account name'", "location": {"path": "content/manuals/billing/payment-method.md", "range": {"start": {"line": 44, "column": 16}}}, "severity": "INFO"}
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, a US bank account, or a Link payment.

Check warning on line 49 in content/manuals/billing/payment-method.md

View workflow job for this annotation

GitHub Actions / validate (vale) 

[vale] reported by reviewdog 🐶
[Docker.We] Avoid using first-person plural like 'US'.

Raw Output:
{"message": "[Docker.We] Avoid using first-person plural like 'US'.", "location": {"path": "content/manuals/billing/payment-method.md", "range": {"start": {"line": 49, "column": 28}}}, "severity": "WARNING"}
- To pay with card, fill out the card information form.
- To pay with a US bank account:

Check warning on line 51 in content/manuals/billing/payment-method.md

View workflow job for this annotation

GitHub Actions / validate (vale) 

[vale] reported by reviewdog 🐶
[Docker.We] Avoid using first-person plural like 'US'.

Raw Output:
{"message": "[Docker.We] Avoid using first-person plural like 'US'.", "location": {"path": "content/manuals/billing/payment-method.md", "range": {"start": {"line": 51, "column": 20}}}, "severity": "WARNING"}
- 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.
- 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 >}}
{{< tab name="Legacy Docker subscription" >}}
Expand Down Expand Up @@ -99,91 +81,43 @@
{{< /tab >}}
{{< /tabs >}}

### Organization
### Set default payment method

You must be an organization owner to make changes to the payment information.
After adding one or more payment methods, you can set one as a default method.

{{< tabs >}}
{{< tab name="Docker subscription" >}}
1. From **Billing**, go to **Payment methods**.
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**.

To add a payment method:
### Remove 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.
To remove a single payment 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. Find the payment method you want to remove from the **Payment method** table.
1. Select the three dots, then choose **Remove**.

{{< /tab >}}
{{< tab name="Legacy Docker subscription" >}}
To remove your default payment method, first set a different payment method as default, or [downgrade to a free subscription](/subscription/change).

To add a payment method:
## Enable and disable pay by invoice

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**.

{{< /tab >}}
{{< /tabs >}}

## Enable 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
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.

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.
1. Confirm your billing contact details. If you need to change them, select
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.

> [!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 not available for
subscription upgrades or changes.

## Verify a bank account

Expand Down
Loading