Share feedback
Answers are generated based on the documentation.

Add or update a payment method

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, 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. All charges are in United States dollars (USD). The following payment methods are supported:

CategoryPayment type
CardsVisa, MasterCard, American Express, Discover, JCB, Diners, UnionPay
WalletsStripe Link
Bank accountsAutomated 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 before choosing a bank account.
  • You must have a Docker Business or Docker Team plan to pay by invoice.
  • You must be an existing Stripe Link customer, or fill out the card information form to use Link payments.

Manage payment method

Paid personal accounts and organizations follow the same procedures to add, update, or remove payment methods.

Add payment method

  1. Sign in to Docker Home.
  2. Select your account name for personal accounts, or select your organization name for organization accounts.
  3. Select Billing, then Payment methods.
  4. 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.
  5. 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.
    • To pay through Link, select an existing payment and choose Use this card.
  6. Finish adding the payment method by selecting Add payment method.

Set default 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.

Remove payment method

To remove a single payment method:

  1. From Billing, go to Payment methods.
  2. Find the payment method you want to remove from the Payment method table.
  3. Select the three dots, then choose Remove.

To remove your default payment method, first set a different payment method as default, or downgrade to a free subscription.

Enable and disable pay by invoice

Tip

Do you need to pay by invoice? Upgrade to a Docker Business or Docker Team plan 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.

Follow these steps to enable or disable pay by invoice:

  1. Sign in to Docker Home and select your organization.
  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:

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

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.

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. You’ll see a small deposit (such as $0.01) in your bank account within 1–2 business days. Open your manual verification email and enter the amount of this deposit to verify your account.

Failed payments

If your payment fails, select Pay now. This redirects you from Docker Hub so you can manually retry the payment through Stripe.

You have a grace period of 15 days including the due date when your payment fails. 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.