Move API Reference to its own navbar tab with a version switcher

AGENTS.md

@@ -172,7 +172,7 @@ Always wrap `<Accordion>` in `<Accordions>`. Use them for FAQs and optional deta
 
 - `<APIPage document="..." operations={[...]} />`: API reference pages (generated, see below).
 - `<ChainList />`, `<WalletList />`: live lists from the WalletConnect Explorer.
-- `<Container>`, `<Title>`, `<ProductCard>`, `<ProductCards>`: landing pages only (`mode: frame`). `<ProductCards>` is the four product cards shared by the home page and the 404 page.
+- `<Container>`, `<Title>`, `<ProductCard>`, `<ProductCards>`: landing pages only (`mode: frame`). `<ProductCards>` is the product cards shared by the home page and the 404 page.
 
 ### Headings and links
 
@@ -193,7 +193,7 @@ Put imports right after the frontmatter. Reuse a snippet instead of copying the
 
 ## Generated files (don't hand-edit)
 
-- `openapi/*.json`, `content/docs/payments/api-reference/<version>/`, the API Reference group in `navigation.json` and the `/payments/api-reference/latest` redirect are all rewritten by `pnpm generate` (also the **Update OpenAPI Specs** workflow). Change `scripts/generate-specs.mjs` instead. `content/docs/payments/api-reference/{index,authentication,versioning}.mdx` are hand-written.
+- `openapi/*.json`, `content/docs/payments/api-reference/<version>/`, the API Reference tab in `navigation.json` and the `/payments/api-reference/latest` redirect are all rewritten by `pnpm generate` (also the **Update OpenAPI Specs** workflow). Change `scripts/generate-specs.mjs` instead. `content/docs/payments/api-reference/{index,authentication,versioning}.mdx` are hand-written.
 - `.source/` is generated by `fumadocs-mdx`.
 - `out/` is the static export from `pnpm build`, and `.wrangler/` is Wrangler's local state.
 

components/snippets/home.tsx

@@ -60,7 +60,7 @@ export function ProductCard({ img, imgDark, href, title, description, model, typ
   );
 }
 
-/** The four product entry points, shown on the home page and the 404 page. */
+/** The product entry points, shown on the home page and the 404 page. */
 export function ProductCards() {
   return (
     <div className="grid gap-4 sm:grid-cols-2">
@@ -92,6 +92,20 @@ export function ProductCards() {
         img="/images/network.svg"
         imgDark="/images/network-dark.svg"
       />
+      <ProductCard
+        title="Wallet Verification"
+        description="Prove that a user controls a crypto wallet by having them sign a message."
+        href="/wallet-verification"
+        img="/images/wallet-verification.svg"
+        imgDark="/images/wallet-verification-dark.svg"
+      />
+      <ProductCard
+        title="API Reference"
+        description="Explore every WalletConnect Pay API endpoint, with authentication and versioning."
+        href="/payments/api-reference"
+        img="/images/api-reference.svg"
+        imgDark="/images/api-reference-dark.svg"
+      />
     </div>
   );
 }

content/docs/index.mdx

@@ -14,9 +14,6 @@ description: "The Connectivity Layer for the Financial Internet"
       <p className="text-[#5B616E] dark:text-gray-300 text-md mb-1 mt-3">
         WalletConnect powers apps, wallets and end-users via the WalletConnect network.
       </p>
-      <p className="text-[#5B616E] dark:text-gray-300 text-md mt-4">
-        <strong>Check out our quickstart guides to get started!</strong>
-      </p>
     </div>
     <ProductCards />
     <ul className="not-prose pb-[1px] h-1 min-w-full mt-3 overflow-auto" />

content/docs/payments/api-reference/2026-02-18/delete-v1-merchants-merchantid-settlements-crypto-id.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Delete a crypto settlement"
+_openapi:
+  method: DELETE
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/merchants/{merchantId}/settlements/crypto/{id}","method":"delete"}]} />

content/docs/payments/api-reference/2026-02-18/delete-v1-merchants-merchantid.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Delete a merchant"
+_openapi:
+  method: DELETE
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/merchants/{merchantId}","method":"delete"}]} />

content/docs/payments/api-reference/2026-02-18/get-v1-gateway-payment-id-status.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Get the payment status"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/gateway/payment/{id}/status","method":"get"}]} />

content/docs/payments/api-reference/2026-02-18/get-v1-gateway-payment-id.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Get a payment"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/gateway/payment/{id}","method":"get"}]} />

content/docs/payments/api-reference/2026-02-18/get-v1-merchants-merchant-id-payments.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Get payments for a merchant"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/merchants/{merchant_id}/payments","method":"get"}]} />

content/docs/payments/api-reference/2026-02-18/get-v1-merchants-merchantid-settlements.mdx

@@ -1,5 +1,7 @@
 ---
 title: "List settlements"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/merchants/{merchantId}/settlements","method":"get"}]} />

content/docs/payments/api-reference/2026-02-18/get-v1-merchants-merchantid.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Get a merchant"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/merchants/{merchantId}","method":"get"}]} />

content/docs/payments/api-reference/2026-02-18/get-v1-merchants-payments.mdx

@@ -1,5 +1,7 @@
 ---
 title: "List payments for a merchant"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/merchants/payments","method":"get"}]} />

content/docs/payments/api-reference/2026-02-18/get-v1-merchants.mdx

@@ -1,5 +1,7 @@
 ---
 title: "List merchants"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/merchants","method":"get"}]} />

content/docs/payments/api-reference/2026-02-18/get-v1-payments-id-status.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Get the payment status"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/payments/{id}/status","method":"get"}]} />

content/docs/payments/api-reference/2026-02-18/get-v1-payments-id.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Get payment details"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/payments/{id}","method":"get"}]} />

content/docs/payments/api-reference/2026-02-18/get-v1-payments.mdx

@@ -1,5 +1,7 @@
 ---
 title: "List payments"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/payments","method":"get"}]} />

content/docs/payments/api-reference/2026-02-18/patch-v1-merchants-merchantid.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Update a merchant"
+_openapi:
+  method: PATCH
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/merchants/{merchantId}","method":"patch"}]} />

content/docs/payments/api-reference/2026-02-18/post-v1-gateway-payment-id-cancel.mdx

@@ -1,5 +1,7 @@
 ---
 title: "POST /v1/gateway/payment/{id}/cancel"
+_openapi:
+  method: POST
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/gateway/payment/{id}/cancel","method":"post"}]} />

content/docs/payments/api-reference/2026-02-18/post-v1-gateway-payment-id-confirm.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Confirm a payment"
+_openapi:
+  method: POST
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/gateway/payment/{id}/confirm","method":"post"}]} />

content/docs/payments/api-reference/2026-02-18/post-v1-gateway-payment-id-fetch.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Fetches an action"
+_openapi:
+  method: POST
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/gateway/payment/{id}/fetch","method":"post"}]} />

content/docs/payments/api-reference/2026-02-18/post-v1-gateway-payment-id-options.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Get payment options"
+_openapi:
+  method: POST
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/gateway/payment/{id}/options","method":"post"}]} />

content/docs/payments/api-reference/2026-02-18/post-v1-merchants-merchantid-settlements-crypto.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Create crypto settlements"
+_openapi:
+  method: POST
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/merchants/{merchantId}/settlements/crypto","method":"post"}]} />

content/docs/payments/api-reference/2026-02-18/post-v1-merchants.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Create a merchant"
+_openapi:
+  method: POST
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/merchants","method":"post"}]} />

content/docs/payments/api-reference/2026-02-18/post-v1-payments-id-cancel.mdx

@@ -1,5 +1,7 @@
 ---
 title: "POST /v1/payments/{id}/cancel"
+_openapi:
+  method: POST
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/payments/{id}/cancel","method":"post"}]} />

content/docs/payments/api-reference/2026-02-18/post-v1-payments.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Create a new payment"
+_openapi:
+  method: POST
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/payments","method":"post"}]} />

content/docs/payments/api-reference/2026-02-18/post-v1-refunds.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Mark a payment as refunded"
+_openapi:
+  method: POST
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/refunds","method":"post"}]} />

content/docs/payments/api-reference/2026-02-18/put-v1-merchants-merchantid-settlements-crypto-id.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Update a crypto settlement destination"
+_openapi:
+  method: PUT
 ---
 
 <APIPage document="2026-02-18.json" operations={[{"path":"/v1/merchants/{merchantId}/settlements/crypto/{id}","method":"put"}]} />

content/docs/payments/api-reference/2026-02-19.preview/delete-v1-merchants-merchantid-settlements-crypto-id.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Delete a crypto settlement"
+_openapi:
+  method: DELETE
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/merchants/{merchantId}/settlements/crypto/{id}","method":"delete"}]} />

content/docs/payments/api-reference/2026-02-19.preview/delete-v1-merchants-merchantid.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Delete a merchant"
+_openapi:
+  method: DELETE
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/merchants/{merchantId}","method":"delete"}]} />

content/docs/payments/api-reference/2026-02-19.preview/get-v1-gateway-payment-id-status.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Get the payment status"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/gateway/payment/{id}/status","method":"get"}]} />

content/docs/payments/api-reference/2026-02-19.preview/get-v1-gateway-payment-id.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Get a payment"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/gateway/payment/{id}","method":"get"}]} />

content/docs/payments/api-reference/2026-02-19.preview/get-v1-merchants-merchant-id-payments.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Get payments for a merchant"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/merchants/{merchant_id}/payments","method":"get"}]} />

content/docs/payments/api-reference/2026-02-19.preview/get-v1-merchants-merchantid-settlements.mdx

@@ -1,5 +1,7 @@
 ---
 title: "List settlements"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/merchants/{merchantId}/settlements","method":"get"}]} />

content/docs/payments/api-reference/2026-02-19.preview/get-v1-merchants-merchantid.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Get a merchant"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/merchants/{merchantId}","method":"get"}]} />

content/docs/payments/api-reference/2026-02-19.preview/get-v1-merchants-payments.mdx

@@ -1,5 +1,7 @@
 ---
 title: "List payments for a merchant"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/merchants/payments","method":"get"}]} />

content/docs/payments/api-reference/2026-02-19.preview/get-v1-merchants.mdx

@@ -1,5 +1,7 @@
 ---
 title: "List merchants"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/merchants","method":"get"}]} />

content/docs/payments/api-reference/2026-02-19.preview/get-v1-payments-id-status.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Get the payment status"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/payments/{id}/status","method":"get"}]} />

content/docs/payments/api-reference/2026-02-19.preview/get-v1-payments-id.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Get payment details"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/payments/{id}","method":"get"}]} />

content/docs/payments/api-reference/2026-02-19.preview/get-v1-payments.mdx

@@ -1,5 +1,7 @@
 ---
 title: "List payments"
+_openapi:
+  method: GET
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/payments","method":"get"}]} />

content/docs/payments/api-reference/2026-02-19.preview/patch-v1-merchants-merchantid.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Update a merchant"
+_openapi:
+  method: PATCH
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/merchants/{merchantId}","method":"patch"}]} />

content/docs/payments/api-reference/2026-02-19.preview/post-v1-gateway-payment-id-cancel.mdx

@@ -1,5 +1,7 @@
 ---
 title: "POST /v1/gateway/payment/{id}/cancel"
+_openapi:
+  method: POST
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/gateway/payment/{id}/cancel","method":"post"}]} />

content/docs/payments/api-reference/2026-02-19.preview/post-v1-gateway-payment-id-confirm.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Confirm a payment"
+_openapi:
+  method: POST
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/gateway/payment/{id}/confirm","method":"post"}]} />

content/docs/payments/api-reference/2026-02-19.preview/post-v1-gateway-payment-id-fetch.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Fetches an action"
+_openapi:
+  method: POST
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/gateway/payment/{id}/fetch","method":"post"}]} />

content/docs/payments/api-reference/2026-02-19.preview/post-v1-gateway-payment-id-options.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Get payment options"
+_openapi:
+  method: POST
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/gateway/payment/{id}/options","method":"post"}]} />

content/docs/payments/api-reference/2026-02-19.preview/post-v1-merchants-merchantid-settlements-crypto.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Create crypto settlements"
+_openapi:
+  method: POST
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/merchants/{merchantId}/settlements/crypto","method":"post"}]} />

content/docs/payments/api-reference/2026-02-19.preview/post-v1-merchants.mdx

@@ -1,5 +1,7 @@
 ---
 title: "Create a merchant"
+_openapi:
+  method: POST
 ---
 
 <APIPage document="2026-02-19.preview.json" operations={[{"path":"/v1/merchants","method":"post"}]} />