From d86345dc257ea411a6a7d4a521feb06d861426d1 Mon Sep 17 00:00:00 2001 From: Tomas R Date: Tue, 25 Aug 2026 18:09:59 -0300 Subject: [PATCH] docs: restructure Payments sidebar and simplify homepage hero MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Reorganize the Payments tab navigation into audience-first groups: Get Started, For PSPs, For Merchants, For Wallets, For Checkout, and AI Agents. Add a Coverage & Reference sub-group, merge the Merchant API group into For Merchants, and move Test mode and Webhooks Notifications up under Get Started. For Wallets is collapsed down to Quickstart, Integration Options, Tap to Pay, and Token & Chain Support. The per-platform SDK guides, API-first, and WebView pages are no longer listed in the sidebar — they are reached through the new payments/wallets/integration-options page, which holds the Integration Options section moved out of the wallets overview. Sidebar labels updated: Wallet Integration -> Quickstart, Token & Chain Support -> Overview inside its own group, Webhooks -> Webhooks Notifications. Page titles are unchanged. Also simplifies the homepage hero: drops the Get started button and the "Introducing WalletConnect Pay" heading, merging the two containers into one. Co-Authored-By: Claude Opus 5 (1M context) --- docs.json | 79 +++++++++--------------- index.mdx | 37 +---------- payments/wallets/integration-options.mdx | 71 +++++++++++++++++++++ payments/wallets/overview.mdx | 70 ++------------------- payments/wallets/token-chain-support.mdx | 2 +- payments/webhooks.mdx | 2 +- 6 files changed, 109 insertions(+), 152 deletions(-) create mode 100644 payments/wallets/integration-options.mdx diff --git a/docs.json b/docs.json index 980b937..91d1b48 100644 --- a/docs.json +++ b/docs.json @@ -35,56 +35,51 @@ "icon": "credit-card", "groups": [ { - "group": "WalletConnect Pay", + "group": "Get Started", "pages": [ "payments/overview", "payments/for-users", - "payments/token-and-chain-coverage", - "payments/fiat-coverage", - "payments/wallet-coverage", - "payments/cex-coverage", "payments/test-mode", - "payments/webhooks" + "payments/webhooks", + { + "group": "Coverage & Reference", + "pages": [ + "payments/token-and-chain-coverage", + "payments/fiat-coverage", + "payments/wallet-coverage", + "payments/cex-coverage" + ] + } ] }, { - "group": "WalletConnect Pay for Merchants", + "group": "For PSPs", "pages": [ - "payments/merchant/quickstart" + "payments/psps/overview", + { + "group": "Headless SDK", + "pages": [ + "payments/psps/headless-sdk/overview", + "payments/psps/headless-sdk/how-it-works", + "payments/psps/headless-sdk/implementation", + "payments/psps/headless-sdk/packages-reference" + ] + } ] }, { - "group": "Merchant API", + "group": "For Merchants", "pages": [ + "payments/merchant/quickstart", "payments/merchant-api/logo-specification" ] }, { - "group": "WalletConnect Pay for Wallets", + "group": "For Wallets", "pages": [ "payments/wallets/overview", - { - "group": "Standalone integration", - "pages": [ - "payments/wallets/standalone/kotlin", - "payments/wallets/standalone/swift", - "payments/wallets/standalone/react-native", - "payments/wallets/standalone/flutter", - "payments/wallets/standalone/web" - ] - }, - { - "group": "Integrate using the Wallet SDK", - "pages": [ - "payments/wallets/walletkit/kotlin", - "payments/wallets/walletkit/swift", - "payments/wallets/walletkit/react-native", - "payments/wallets/walletkit/flutter", - "payments/wallets/walletkit/web" - ] - }, - "payments/wallets/api-first", - "payments/wallets/webview", + "payments/wallets/integration-options", + "payments/wallets/tap-to-pay", { "group": "Token & Chain Support", "pages": [ @@ -92,27 +87,11 @@ "payments/wallets/token-chain-support/usdt-support", "payments/wallets/token-chain-support/solana-support" ] - }, - "payments/wallets/tap-to-pay" - ] - }, - { - "group": "WalletConnect Pay for PSPs", - "pages": [ - "payments/psps/overview", - { - "group": "Headless SDK", - "pages": [ - "payments/psps/headless-sdk/overview", - "payments/psps/headless-sdk/how-it-works", - "payments/psps/headless-sdk/implementation", - "payments/psps/headless-sdk/packages-reference" - ] } ] }, { - "group": "Ecommerce and Online Checkout", + "group": "For Checkout", "pages": [ "payments/ecommerce/overview", "payments/ecommerce/integration", @@ -120,7 +99,7 @@ ] }, { - "group": "WalletConnect AI Agent SDK", + "group": "AI Agents", "pages": [ "agents/overview" ] diff --git a/index.mdx b/index.mdx index bb687a5..14a101c 100644 --- a/index.mdx +++ b/index.mdx @@ -14,49 +14,16 @@ import { ProductCard } from '/snippets/home/product-cards.mdx';
-
+
WalletConnect Pay
-

- The easiest way to enable crypto payments from any wallet, any asset, anywhere. -

-
- - -
-
- - Introducing WalletConnect Pay - -

- **[WalletConnect Pay](/payments/overview)** is a complete, end-to-end crypto payment solution that allows PSPs and merchants to enable crypto payments from any wallet and any asset through a single, familiar integration. + A complete, end-to-end crypto payment solution that allows PSPs and merchants to enable crypto payments from any wallet and any asset through a single, familiar integration.

diff --git a/payments/wallets/integration-options.mdx b/payments/wallets/integration-options.mdx new file mode 100644 index 0000000..08bf5b9 --- /dev/null +++ b/payments/wallets/integration-options.mdx @@ -0,0 +1,71 @@ +--- +title: "Integration Options" +sidebarTitle: "Integration Options" +description: "The four ways to enable WalletConnect Pay in your wallet — Wallet SDK, standalone SDK, API-first, and WebView." +--- + +WalletConnect provides four integration approaches for enabling WalletConnect Pay in your wallet. Pick the one that matches how your wallet is built today. + +## Integrate using the Wallet SDK (Recommended) + +If your wallet already uses the WalletConnect Wallet SDK (WalletKit), WalletConnect Pay is automatically available when you initialize WalletKit. This is the recommended approach as it provides a unified API and automatic configuration. + + + + WalletKit integration for Android wallets. + + + WalletKit integration for iOS wallets. + + + WalletKit integration for React Native wallets. + + + WalletKit integration for Flutter wallets. + + + WalletKit integration for Web/Node.js wallets. + + + +## Standalone Integration + +For wallets that don't currently use the WalletConnect Wallet SDK, you can integrate the standalone Pay SDK directly. This approach requires configuring the SDK with your WalletConnect Project ID. + + + + Standalone Pay SDK for Android wallets. + + + Standalone Pay SDK for iOS wallets. + + + Standalone Pay SDK for React Native wallets. + + + Standalone Pay SDK for Flutter wallets. + + + Standalone Pay SDK for Web/Node.js wallets. + + + +## API-First Integration + +For wallets that prefer direct API integration without using an SDK, you can use the Gateway API directly. + + + + Integrate WalletConnect Pay using the Gateway API. + + + +## WebView Integration + +For apps that want to embed the full WalletConnect Pay checkout UI inside a native WebView — without redirecting to an external browser. The hosted checkout handles everything; your app supplies two query parameters and listens for bridge messages. + + + + Embed the checkout portal in a native WebView (iOS, Android, React Native, Flutter). + + diff --git a/payments/wallets/overview.mdx b/payments/wallets/overview.mdx index 58e4b49..6876429 100644 --- a/payments/wallets/overview.mdx +++ b/payments/wallets/overview.mdx @@ -1,6 +1,6 @@ --- title: "WalletConnect Pay - Wallet Integration" -sidebarTitle: "Wallet Integration" +sidebarTitle: "Quickstart" --- Your users hold crypto and stablecoins. WalletConnect Pay gives them somewhere to spend it. @@ -13,71 +13,11 @@ What's included - Cashback in $WCT for your users on every purchase - Check [Token and Chain coverage](/payments/token-and-chain-coverage) for supported tokens and chains -WalletConnect provides three integration approaches for enabling WalletConnect Pay in your wallet: +WalletConnect provides four integration approaches for enabling WalletConnect Pay in your wallet: the Wallet SDK (WalletKit), the standalone Pay SDK, an API-first integration, and an embedded WebView checkout. -## Integration Options - -### Integrate using the Wallet SDK (Recommended) - -If your wallet already uses the WalletConnect Wallet SDK (WalletKit), WalletConnect Pay is automatically available when you initialize WalletKit. This is the recommended approach as it provides a unified API and automatic configuration. - - - - WalletKit integration for Android wallets. - - - WalletKit integration for iOS wallets. - - - WalletKit integration for React Native wallets. - - - WalletKit integration for Flutter wallets. - - - WalletKit integration for Web/Node.js wallets. - - - -### Standalone Integration - -For wallets that don't currently use the WalletConnect Wallet SDK, you can integrate the standalone Pay SDK directly. This approach requires configuring the SDK with your WalletConnect Project ID. - - - - Standalone Pay SDK for Android wallets. - - - Standalone Pay SDK for iOS wallets. - - - Standalone Pay SDK for React Native wallets. - - - Standalone Pay SDK for Flutter wallets. - - - Standalone Pay SDK for Web/Node.js wallets. - - - -### API-First Integration - -For wallets that prefer direct API integration without using an SDK, you can use the Gateway API directly. - - - - Integrate WalletConnect Pay using the Gateway API. - - - -### WebView Integration - -For apps that want to embed the full WalletConnect Pay checkout UI inside a native WebView — without redirecting to an external browser. The hosted checkout handles everything; your app supplies two query parameters and listens for bridge messages. - - - - Embed the checkout portal in a native WebView (iOS, Android, React Native, Flutter). + + + Compare the four approaches and jump to the guide for your platform. diff --git a/payments/wallets/token-chain-support.mdx b/payments/wallets/token-chain-support.mdx index 087e266..f6ded65 100644 --- a/payments/wallets/token-chain-support.mdx +++ b/payments/wallets/token-chain-support.mdx @@ -1,6 +1,6 @@ --- title: "Token & Chain Support" -sidebarTitle: "Token & Chain Support" +sidebarTitle: "Overview" description: "Guides for implementing specific token and blockchain support in your WalletConnect Pay wallet integration." --- diff --git a/payments/webhooks.mdx b/payments/webhooks.mdx index 6355ca1..d65b7f9 100644 --- a/payments/webhooks.mdx +++ b/payments/webhooks.mdx @@ -1,6 +1,6 @@ --- title: "Webhooks" -sidebarTitle: "Webhooks" +sidebarTitle: "Webhooks Notifications" description: "Get notified in real time as payments move through their lifecycle." ---