From 3c4f5bf6ee537e8a976dad3ee4227f6dd9683665 Mon Sep 17 00:00:00 2001
From: Stephanie Aurelio <133041642+stephaurelio@users.noreply.github.com>
Date: Mon, 8 Jul 2024 10:46:01 -0700
Subject: [PATCH] Add section on 3DS support (#20334)

* add to billing section
---
 content/billing/3d-secure.md | 31 +++++++++++++++++++++++++++++++
 content/billing/_index.md    |  8 ++++++++
 data/toc.yaml                |  2 ++
 3 files changed, 41 insertions(+)
 create mode 100644 content/billing/3d-secure.md

diff --git a/content/billing/3d-secure.md b/content/billing/3d-secure.md
new file mode 100644
index 0000000000..6bad0609bd
--- /dev/null
+++ b/content/billing/3d-secure.md
@@ -0,0 +1,31 @@
+---
+title: 3D Secure authentication
+description: Learn about 3D Secure support for Docker billing.
+keywords: billing, renewal, payments, subscriptions
+---
+
+> **Note**
+>
+> [Docker Core subscription](/billing/core-billing/get-started-core/) payments support 3D secure authentication.
+
+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.
+
+The following transactions will use 3DS authentication if your payment method requires it.
+
+- Starting a [new paid subscription](/billing/core-billing/get-started-core/)
+- Changing your [billing cycle](/billing/core-billing/cycle/) from monthly to annual
+- [Upgrading your subscription](/subscription/core-subscription/upgrade/)
+- [Adding seats](/subscription/core-subscription/add-seats/) to an existing subscription
+
+## Troubleshooting
+
+If you encounter errors completing payments due to 3DS, you can troubleshoot in the following ways.
+
+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.
+
+> **Tip**
+>
+> 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.
+{ .tip }
diff --git a/content/billing/_index.md b/content/billing/_index.md
index b05086f9f8..902bfb88a5 100644
--- a/content/billing/_index.md
+++ b/content/billing/_index.md
@@ -33,6 +33,14 @@ grid_resources:
   description: Find the answers you need and explore common questions.
   link: /billing/faqs/
   icon: help
+- title: Register a tax certificate
+  description: Learn how to register a tax exemption certificate.
+  link: /billing/tax-certificate/
+  icon: developer_guide
+- title: 3D Secure authentication
+  description: Discover how Docker billing supports 3DS and how to troubleshoot potential issues.
+  link: /billing/3d-secure/
+  icon: wallet
 ---
 
 Use the resources in this section to manage your billing and payment settings for your Docker subscriptions.
diff --git a/data/toc.yaml b/data/toc.yaml
index c34529b77e..afc86bcda3 100644
--- a/data/toc.yaml
+++ b/data/toc.yaml
@@ -2328,6 +2328,8 @@ Manuals:
     title: Docker Scout billing
   - path: /billing/tax-certificate/
     title: Register a tax certificate
+  - path: /billing/3d-secure/
+    title: 3D Secure authentication
   - path: /billing/faqs/
     title: Billing FAQs