lightsparkdev · AaryamanBhute · May 20, 2026 · May 20, 2026 · May 22, 2026 · May 22, 2026
diff --git a/mintlify/cards/card-management/freezing-and-closing.mdx b/mintlify/cards/card-management/freezing-and-closing.mdx
@@ -0,0 +1,9 @@
+---
+title: "Freezing & Closing Cards"
+description: "Freeze, unfreeze, and close cards via the signed-retry pattern"
+icon: "/images/icons/lock.svg"
+---
+
+import CardsFreezingAndClosing from '/snippets/cards/freezing-and-closing.mdx';
+
+<CardsFreezingAndClosing />
diff --git a/mintlify/cards/card-management/funding-sources.mdx b/mintlify/cards/card-management/funding-sources.mdx
@@ -0,0 +1,9 @@
+---
+title: "Funding Sources"
+description: "Bind and update internal accounts as card funding sources"
+icon: "/images/icons/wallet1.svg"
+---
+
+import CardsFundingSources from '/snippets/cards/funding-sources.mdx';
+
+<CardsFundingSources />
diff --git a/mintlify/cards/card-management/issuing-cards.mdx b/mintlify/cards/card-management/issuing-cards.mdx
@@ -0,0 +1,9 @@
+---
+title: "Issuing Cards"
+description: "Create a virtual card and observe its lifecycle"
+icon: "/images/icons/credit-card1.svg"
+---
+
+import CardsIssuingCards from '/snippets/cards/issuing-cards.mdx';
+
+<CardsIssuingCards />
diff --git a/mintlify/cards/index.mdx b/mintlify/cards/index.mdx
@@ -0,0 +1,11 @@
+---
+title: "Cards"
+sidebarTitle: "Introduction"
+description: "Issue virtual debit cards, decision authorizations in real time, and reconcile transactions against internal accounts."
+icon: "/images/icons/credit-card1.svg"
+mode: "wide"
+---
+
+import CardsIntro from '/snippets/cards/intro.mdx';
+
+<CardsIntro />
diff --git a/mintlify/cards/onboarding/cardholder-setup.mdx b/mintlify/cards/onboarding/cardholder-setup.mdx
@@ -0,0 +1,9 @@
+---
+title: "Cardholder Setup"
+description: "Prepare a customer to receive a card"
+icon: "/images/icons/people.svg"
+---
+
+import CardsCardholderSetup from '/snippets/cards/cardholder-setup.mdx';
+
+<CardsCardholderSetup />
diff --git a/mintlify/cards/onboarding/implementation-overview.mdx b/mintlify/cards/onboarding/implementation-overview.mdx
@@ -0,0 +1,9 @@
+---
+title: "Implementation Overview"
+description: "End-to-end architecture for issuing and operating cards"
+icon: "/images/icons/code.svg"
+---
+
+import CardsImplementationOverview from '/snippets/cards/implementation-overview.mdx';
+
+<CardsImplementationOverview />
diff --git a/mintlify/cards/platform-tools/sandbox-testing.mdx b/mintlify/cards/platform-tools/sandbox-testing.mdx
@@ -0,0 +1,9 @@
+---
+title: "Sandbox Testing"
+description: "Drive deterministic card outcomes with the simulate endpoints"
+icon: "/images/icons/sandbox.svg"
+---
+
+import CardsSandboxTesting from '/snippets/cards/sandbox-testing.mdx';
+
+<CardsSandboxTesting />
diff --git a/mintlify/cards/platform-tools/webhooks.mdx b/mintlify/cards/platform-tools/webhooks.mdx
@@ -0,0 +1,9 @@
+---
+title: "Webhooks"
+description: "Card webhook events and how to consume them"
+icon: "/images/icons/bell.svg"
+---
+
+import CardsWebhooks from '/snippets/cards/webhooks.mdx';
+
+<CardsWebhooks />
diff --git a/mintlify/cards/quickstart.mdx b/mintlify/cards/quickstart.mdx
@@ -0,0 +1,9 @@
+---
+title: "Quickstart"
+description: "Issue your first card and simulate a transaction end to end"
+icon: "/images/icons/rocket.svg"
+---
+
+import CardsQuickstart from '/snippets/cards/quickstart.mdx';
+
+<CardsQuickstart />
diff --git a/mintlify/cards/terminology.mdx b/mintlify/cards/terminology.mdx
@@ -0,0 +1,9 @@
+---
+title: "Terminology"
+description: "Concepts and resources specific to the Cards API"
+icon: "/images/icons/file-text.svg"
+---
+
+import CardsTerminology from '/snippets/cards/terminology.mdx';
+
+<CardsTerminology />
diff --git a/mintlify/cards/transactions/reconciliation.mdx b/mintlify/cards/transactions/reconciliation.mdx
@@ -0,0 +1,9 @@
+---
+title: "Reconciliation"
+description: "How card transactions reconcile, and what exceptions to act on"
+icon: "/images/icons/checkmark1.svg"
+---
+
+import CardsReconciliation from '/snippets/cards/reconciliation.mdx';
+
+<CardsReconciliation />
diff --git a/mintlify/docs.json b/mintlify/docs.json
@@ -329,6 +329,47 @@
           }
         ]
       },
+      {
+        "tab": "Cards",
+        "groups": [
+          {
+            "group": "Overview",
+            "pages": [
+              "cards/index",
+              "cards/terminology",
+              "cards/onboarding/implementation-overview",
+              "cards/quickstart"
+            ]
+          },
+          {
+            "group": "Onboarding",
+            "pages": [
+              "cards/onboarding/cardholder-setup"
+            ]
+          },
+          {
+            "group": "Card Management",
+            "pages": [
+              "cards/card-management/issuing-cards",
+              "cards/card-management/funding-sources",
+              "cards/card-management/freezing-and-closing"
+            ]
+          },
+          {
+            "group": "Transactions",
+            "pages": [
+              "cards/transactions/reconciliation"
+            ]
+          },
+          {
+            "group": "Platform Tools",
+            "pages": [
+              "cards/platform-tools/webhooks",
+              "cards/platform-tools/sandbox-testing"
+            ]
+          }
+        ]
+      },
       {
         "tab": "API reference",
         "groups": [