Files
docker-docs/content/manuals/billing/payment-method.md
aevesdocker d91fd61d36 docs: address issue #24242
This change was automatically generated by the documentation agent team
in response to issue #24242.

🤖 Generated with cagent
2026-03-02 08:25:58 +00:00

9.2 KiB
Raw Blame History

title, weight, description, keywords, aliases
title weight description keywords aliases
Add or update a payment method 20 Learn how to add or update a payment method in Docker Hub payments, billing, subscription, supported payment methods, failed payments, add credit card, bank transfer, Stripe Link, payment failure
/billing/core-billing/payment-method/

This page describes how to add or update a payment method for your personal account or for an organization.

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.

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 US bank account
  • Pay by invoice

All charges are in United States dollars (USD).

{{% include "tax-compliance.md" %}}

Manage payment method

Personal account

{{< tabs >}} {{< tab name="Docker subscription" >}}

To add a payment method:

  1. Sign in to Docker Home and select your organization.
  2. Select Billing.
  3. Select Payment methods from the left-hand menu.
  4. Select Add payment method.
  5. 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.
      • 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.
  6. Select Add payment method.
  7. Optional. You can set a new default payment method by selecting the Set as default action.
  8. 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 first.

{{< /tab >}} {{< tab name="Legacy Docker subscription" >}}

To add a payment method:

  1. Sign in to Docker Hub.
  2. Select Billing.
  3. Select the Payment methods link.
  4. Select Add payment method.
  5. 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.
  6. Select Add.
  7. Select the Actions icon, then select Make default to ensure that your new payment method applies to all purchases and subscriptions.
  8. Optional. You can remove non-default payment methods by selecting the Actions icon. Then, select Delete.

{{< /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:

  1. Sign in to Docker Home and select your organization.
  2. Select Billing.
  3. Select Payment methods from the left-hand menu.
  4. Select Add payment method.
  5. 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.
  6. Select Add payment method.
  7. Optional. You can set a new default payment method by selecting the Set as default action.
  8. 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 first.

{{< /tab >}} {{< tab name="Legacy Docker subscription" >}}

To add a payment method:

  1. Sign in to Docker Hub.
  2. Select your organization, then select Billing.
  3. Select the Payment methods link.
  4. Select Add payment method.
  5. 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.
  6. Select Add payment method.
  7. Select the Actions icon, then select Make default to ensure that your new payment method applies to all purchases and subscriptions.
  8. 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" >}}

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.

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.

  1. Sign in to Docker Home and select your organization.
  2. Select Billing.
  3. Select Payment methods, then Pay by invoice.
  4. To enable pay by invoice, select the toggle.
  5. 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 and choose the annual subscription.

Verify a bank account

There are two ways to verify a bank account as a payment method:

  • Instant verification: Docker supports several major banks for instant verification.
  • Manual verification: All other banks must be verified manually.

{{< tabs >}} {{< tab name="Instant verification" >}}

Instant verification

To verify your bank account instantly, you must sign in to your bank account from the Docker billing flow:

  1. Choose US bank account as your payment method.
  2. Verify your Email and Full name.
  3. If your bank is listed, select your bank's name or select Search for your bank.
  4. Sign in to your bank and review the terms and conditions. This agreement allows Docker to debit payments from your connected bank account.
  5. Select Agree and continue.
  6. Select an account to link and verify, and select Connect account.

When the account is verified, you will see a success message in the pop-up modal.

{{< /tab >}} {{< tab name="Manual verification" >}}

Manual verification

To verify your bank account manually, you must enter the micro-deposit amount from your bank statement:

  1. Choose US bank account as your payment method.
  2. Verify your Email and First and last name.
  3. Select Enter bank details manually instead.
  4. Enter your bank details: Routing number and Account number.
  5. Select Submit.
  6. You will receive an email with instructions on how to manually verify.

Manual verification uses micro-deposits. Youll see a small deposit (such as $0.01) in your bank account within 12 business days. Open your manual verification email and enter the amount of this deposit to verify your account.

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

Failed payments

You can't manually retry a failed payment. Docker will retry failed payments based on the retry 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.

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.