feat: Cleanup and improve Invoicing use case page

use-cases/checkout.mdx

@@ -1,6 +1,7 @@
 ---
-title: "🛒 Checkout"
+title: "Checkout"
+icon: "cart-shopping"
 description: "Add crypto payment checkout to your e-commerce platform with seamless customer experience"
 ---
 
 <Warning>
@@ -9,7 +10,7 @@
 
 ## Overview
 
 Transform your e-commerce checkout with Request Network's payment infrastructure. Accept crypto payments with support for 80+ wallets, enable crosschain transactions, and provide customers with a seamless payment experience that rivals traditional payment processors.
 
 ## 🚀 Quickstart: Integrate Your First Checkout Payment
 
@@ -56,10 +57,10 @@
 </CardGroup>
 
 **Demo Features:**
 - 80+ wallet connection support (MetaMask, WalletConnect, Coinbase, etc.)
 - Direct payment forms with QR codes
 - Real-time payment status updates
 - Crosschain payment options
 - Mobile-optimized payment experience
 
 ## Integration Options
@@ -156,7 +157,7 @@
 <AccordionGroup>
   <Accordion title="🛍️ Traditional E-commerce">
     Integrate with existing e-commerce platforms:
     - Shopify, WooCommerce, Magento plugins
     - Payment gateway replacement
     - Inventory management integration
     - Order fulfillment automation
@@ -192,8 +193,8 @@
 <Tabs>
   <Tab title="Wallet Choice">
     **80+ Supported Wallets:**
     - MetaMask, WalletConnect, Coinbase Wallet
     - Hardware wallets (Ledger, Trezor)
     - Mobile wallets (Trust Wallet, Rainbow)
     - Exchange wallets and DeFi wallets
   </Tab>
@@ -202,14 +203,14 @@
     **Multiple Payment Options:**
     - Direct wallet payments
     - QR code scanning for mobile
     - Crosschain payment routing
     - Multiple currency options
   </Tab>
 
   <Tab title="Security & Trust">
     **Enhanced Security:**
     - No stored payment credentials
     - Transparent blockchain transactions
     - Real-time payment verification
     - Immutable payment records
   </Tab>
@@ -221,7 +222,7 @@
 ```javascript React Component
 import { PaymentWidget } from '@requestnetwork/payment-widget';
 
 function CheckoutPage({ orderTotal, orderId }) {
   return (
     <PaymentWidget
       amount={orderTotal}

use-cases/invoicing.mdx

@@ -1,184 +1,189 @@
 ---
-title: "📄 Invoicing"
+title: "Invoicing"
+icon: "file-invoice"
 description: "Create crypto invoices with automatic payment detection and reconciliation"
 ---
 
-<Warning>
-**AI-Generated Content** – This page was generated with AI assistance and may contain inaccuracies. While likely close to accurate, please verify critical details with the [stable documentation](https://docs.request.network) or [contact support](https://github.com/orgs/RequestNetwork/discussions).
-</Warning>
-
 ## Overview
 
-Transform your invoicing workflow with Request Network. Create professional invoices, accept payments in 553+ currencies across 10 EVM chains, and maintain perfect payment records with zero reconciliation errors.
-
-## 🚀 Quickstart: Create Your First Invoice
+Bring instant, verifiable payments to your invoicing flow. Generate invoices in fiat or crypto, let customers pay in their preferred token across 9 EVM chains and 150+ currencies, and receive automatic reconciliation with on-chain payment detection - no manual tracking, no infrastructure overhead.
 
-<Info>
-**Get your first invoice paid in under 1 minute**
+**What you get:**
+- **Permanent records** - Invoices stored on <Tooltip tip="InterPlanetary File System - a distributed storage network for permanent data">IPFS</Tooltip> create a tamper-proof audit trail
+- **Multi-currency flexibility** - Invoice in USD, get paid in crypto with automatic conversion
+- **Instant reconciliation** - Every invoice automatically linked to its <Tooltip tip="Blockchain-recorded transaction verified by network validators">on-chain</Tooltip> payment
+- **Cross-chain support** - Accept payments across 9 networks in 150+ currencies
+- **Webhook automation** - Real-time payment confirmations for backend integration
 
-*Interactive quickstart experience coming soon*
-</Info>
+## Quickstart
 
 <Steps>
   <Step title="Create Invoice">
-    Generate a payment request with amount, recipient, and payment terms
+    Call the [Create Request endpoint](/api-features/create-requests) with invoice details
   </Step>
-  <Step title="Share Payment Link">
-    Send the secure payment link to your customer
-  </Step>
-  <Step title="Get Paid">
-    Customer pays with their preferred wallet and currency
+  <Step title="Process Payment">
+    Use the payment data to show payment options, then guide the payer through wallet signature and submission
   </Step>
   <Step title="Track Payment">
-    Real-time payment detection and automatic reconciliation
+    Use [webhooks](/api-features/webhooks-events) for real-time payment notifications
   </Step>
 </Steps>
 
-## EasyInvoice Demo
+## Invoicing Demo
+
+Try the complete invoicing workflow with EasyInvoice:
+
+<Card 
+  title="Try EasyInvoice Demo" 
+  href="https://easyinvoice.request.network" 
+  icon="external-link"
+>
+  Create invoices, accept crypto payments, and track payment status - all powered by Request Network API
+</Card>
+
+**What you'll see:**
+- Invoice creation with Request Network
+- Multiple payment currencies and chains
+- Automatic payment detection
+- Real-time status updates via webhooks
 
-See the complete invoicing workflow in action with our demo application:
+<Check>
+**Ready to integrate?** If EasyInvoice meets your needs, you can start using it immediately. For custom requirements, explore the integration options below.
+</Check>
+
+## Integration Approaches
+
+<Info>
+Not sure which approach fits your needs? [See our detailed comparison of integration approaches →](/resources/integration-approaches)
+</Info>
 
 <CardGroup cols={2}>
   <Card 
-    title="🎬 Watch Demo Video" 
-    href="#" 
-    icon="play"
+    title="Use EasyInvoice" 
+    icon="rocket"
+    href="https://easyinvoice.request.network"
   >
-    Complete invoicing workflow with Google login, dashboard metrics, and real-time updates
+    **Go live in minutes**
+
+    Use our hosted application with no development required.
+
+    - Dashboard analytics
+    - Multi-currency support
+    - Immediate deployment
+
+    [Try it now →](https://easyinvoice.request.network)
   </Card>
 
   <Card 
-    title="🔗 Try Live Demo" 
-    href="https://easy-invoice-demo.vercel.app" 
-    icon="external-link"
+    title="Fork EasyInvoice" 
+    icon="code-fork"
+    href="#"
   >
-    Experience the full EasyInvoice application
+    **Customize for your brand**
+
+    Clone and modify the open-source application to match your needs.
+
+    - Full source code access
+    - Custom branding
+    - Add your own features
+
+    [Forking guide →](#)
   </Card>
 </CardGroup>
 
-**Demo Features:**
-- Google authentication and user management
-- Professional invoice creation with custom branding
-- Real-time payment tracking and notifications
-- Dashboard with payment analytics and metrics
-- Multi-currency support (USD invoicing, crypto settlement)
-
-## Integration Options
-
-Choose the approach that best fits your needs:
-
-<Tabs>
-  <Tab title="Use EasyInvoice As-Is">
-    **Best for:** Quick deployment, immediate invoicing capabilities
-
-    Deploy EasyInvoice directly for your business:
-    - Ready-to-use invoicing interface
-    - No development required
-    - Hosted solution with custom domain support
-
-    [Deploy EasyInvoice →](#)
-  </Tab>
+<Card 
+  title="Build with API" 
+  icon="code"
+  href="/api-features/create-requests"
+>
+  **Complete control**
 
-  <Tab title="Fork & Customize">
-    **Best for:** Custom branding, workflow modifications
-
-    Customize EasyInvoice for your specific needs:
-    - Clone the repository
-    - Modify UI/UX to match your brand
-    - Add custom business logic
-    - Requires API key setup
-
-    [Fork Repository →](#) | [Setup Guide →](#)
-  </Tab>
+  Build a custom solution integrated with your existing systems.
 
-  <Tab title="Custom Implementation">
-    **Best for:** White-label solutions, full control
-
-    Build your own invoicing system using Request Network API:
-    - Complete customization freedom
-    - Integrate with existing systems
-    - Pure API integration
-
-    [API Documentation →](/api-features/payment-types)
-  </Tab>
-</Tabs>
+  - White-label ready
+  - Full customization
+  - Add fee layers
+  - <Tooltip tip="Users maintain control of their funds - you never custody crypto">Non-custodial</Tooltip> architecture
+
+  [API docs →](/api-features/create-requests)
+</Card>
 
 ## Key API Features for Invoicing
 
 <CardGroup cols={2}>
   <Card 
     title="Create Requests" 
-    href="/api-features/payment-types"
+    href="/api-features/create-requests"
     icon="plus"
   >
-    Generate payment requests with flexible parameters and metadata
+    Generate payment requests with amount, recipient, and payment terms
   </Card>
 
   <Card 
     title="Conversion Payments" 
-    href="/api-features/payment-types"
+    href="/api-features/conversion-payments"
     icon="exchange"
   >
-    Invoice in USD, get paid in crypto with automatic conversion
+    Fiat-denominated invoices settled in crypto with real-time price conversion
   </Card>
 
   <Card 
-    title="Recurring Payments" 
-    href="/api-features/payment-types"
-    icon="repeat"
+    title="Batch Payments" 
+    href="/api-features/batch-payments"
+    icon="layer-group"
   >
-    Set up subscription billing and automated recurring invoices
+    Pay multiple invoices in a single transaction
   </Card>
 
   <Card 
-    title="Webhooks" 
-    href="/api-features/advanced-features"
-    icon="webhook"
+    title="Recurring Invoices" 
+    href="/api-features/recurring-payments"
+    icon="repeat"
   >
-    Real-time payment notifications for instant reconciliation
+    Automate recurring invoice generation for ongoing vendor relationships
   </Card>
 
   <Card 
-    title="Partial Payments" 
-    href="/api-features/payment-types"
-    icon="coins"
+    title="Payment Detection" 
+    href="/api-features/payment-detection"
+    icon="radar"
   >
-    Accept installment payments and partial settlements
+    Automatic detection and verification of payments across chains
   </Card>
 
   <Card 
-    title="Custom Metadata" 
-    href="/api-features/advanced-features"
-    icon="tag"
+    title="Query Requests" 
+    href="/api-features/query-requests"
+    icon="magnifying-glass"
   >
-    Add invoice numbers, tax info, and business data
+    Build invoicing dashboards with historical invoice data and status tracking
   </Card>
 </CardGroup>
 
 ## What's Next?
 
 <CardGroup cols={3}>
   <Card 
-    title="🔑 Get API Keys" 
+    title="Get API Keys" 
     href="/api-setup/getting-started"
     icon="key"
   >
     Set up your account and get API credentials
   </Card>
 
   <Card 
-    title="⚙️ Explore Features" 
-    href="/api-features/payment-types"
-    icon="cog"
+    title="View Invoicing Examples" 
+    href="#"
+    icon="code"
   >
-    Learn about payment types and advanced capabilities
+    See code examples for common invoicing workflows
   </Card>
 
   <Card 
-    title="🌐 Check Compatibility" 
+    title="Supported Chains & Currencies" 
     href="/resources/supported-chains-and-currencies"
     icon="globe"
   >
-    Review supported chains and currencies
+    See which networks and tokens you can use
   </Card>
 </CardGroup>

use-cases/payment-detection.mdx

@@ -1,6 +1,7 @@
 ---
-title: "💳 Payment Detection"
+title: "Payment Detection"
+icon: "credit-card"
 description: "Automatically detect and verify crypto payments with real-time blockchain monitoring and webhooks"
 ---
 
 <Warning>
@@ -9,13 +10,13 @@
 
 ## Overview
 
 Payment Detection monitors blockchain networks to automatically identify and verify when payments are completed. Add crypto payment acceptance to your existing systems without rebuilding your entire infrastructure.
 
 ## When to Use Payment Detection
 
 <CardGroup cols={2}>
   <Card title="Existing Business Logic" icon="building">
     You already have invoicing, billing, or business systems and just need crypto payment acceptance
   </Card>
 
   <Card title="Single Wallet, Many Payments" icon="wallet">
@@ -23,35 +24,35 @@
   </Card>
 
   <Card title="Real-time Verification" icon="clock">
     Need instant payment confirmation without manual blockchain checking
   </Card>
 
   <Card title="Multi-chain Support" icon="link">
     Accept payments across Ethereum, Polygon, BSC, and 10+ EVM chains
   </Card>
 </CardGroup>
 
 ## Common Scenarios
 
 ### Donations with Attribution
 Accept crypto donations to a single wallet and automatically attribute each to the correct donor, campaign, or cause.
 
 **Example:** A nonprofit collects donations from hundreds of donors to one Ethereum address. Each donation includes a Request ID, enabling automatic attribution and thank-you emails.
 
 ### SaaS Adding Crypto Payments
 Existing subscription or billing platform adds crypto as a payment option alongside credit cards.
 
 **Example:** A SaaS company uses Stripe for card payments but wants to offer USDC payments. Payment Detection monitors for crypto payments and updates subscription status automatically.
 
 ### Manual Invoices + Crypto Detection
 Send invoices through existing channels (email, PDF) and let customers pay in crypto with automatic detection.
 
 **Example:** A freelancer emails invoices as PDFs with a Request ID. Clients pay in crypto, and the freelancer's accounting software automatically marks invoices as paid via webhook.
 
 ### High-Volume Payment Collection
 Collect thousands of payments without creating new wallet addresses for each transaction.
 
 **Example:** An e-commerce platform processes 10,000+ crypto orders per day. Instead of generating unique addresses, each order gets a Request ID for attribution.
 
 ---
 
@@ -59,11 +60,11 @@
 
 <Steps>
   <Step title="Payment Initiated">
     Customer sends crypto payment including the Request ID in the transaction reference
   </Step>
 
   <Step title="Blockchain Monitoring">
     Request Network continuously scans supported blockchains for transactions matching your requests
   </Step>
 
   <Step title="Payment Detected">
@@ -83,9 +84,9 @@
 
 ## Detection Features
 
 ### Real-time Blockchain Scanning
 - **Multi-chain monitoring:** Ethereum, Polygon, Arbitrum, Optimism, BSC, Gnosis, Fantom, Avalanche, and more
 - **Sub-minute detection:** Typically detect payments within seconds of blockchain confirmation
 - **Confirmation tracking:** Configurable confirmation thresholds for different security requirements
 
 ### Payment Verification
@@ -95,7 +96,7 @@
 
 ### Webhook Integration
 - **Event notifications:** `payment.detected`, `payment.confirmed`, `payment.failed`
 - **Retry logic:** Automatic webhook retries with exponential backoff
 - **Signature verification:** Cryptographically signed webhooks for security
 
 ---
@@ -143,7 +144,7 @@
     - Webhook delivery with retry logic
     - Permanent on-chain payment records
 
     **Example:** QuickBooks + crypto payments via Request Network detection
   </Tab>
 
   <Tab title="Full Invoicing Workflow">
@@ -194,14 +195,14 @@
   },
   body: JSON.stringify({
     currency: 'USDC-matic',
     expectedAmount: '100.00',
     paymentAddress: '0x...your-wallet',
     reason: 'Invoice #12345'
   })
 });
 
 const { requestId } = await response.json();
 // Include requestId in payment instructions to customer
 ```
 
 ```javascript Node.js - Webhook Handler
@@ -244,18 +245,18 @@
 
 ## Supported Networks & Currencies
 
 ### Mainnet Networks
 - **Ethereum:** ETH, USDC, USDT, DAI, and 200+ ERC20 tokens
 - **Polygon:** MATIC, USDC, USDT, DAI, and 150+ tokens
 - **Arbitrum, Optimism, BSC, Gnosis, Fantom, Avalanche:** Full ERC20 support
 
 ### Detection Speed
 - **Ethereum:** ~15 seconds per confirmation
 - **Polygon:** ~2 seconds per confirmation
 - **Layer 2s:** Sub-second to ~2 seconds
 
 ### Testnet Support
 Available on Sepolia, Mumbai, and other testnets for development
 
 [View all supported chains and currencies →](/resources/supported-chains-and-currencies)
 

use-cases/payouts.mdx

@@ -1,5 +1,6 @@
 ---
-title: "💰 Payouts"
+title: "Payouts"
+icon: "money-bill-transfer"
 description: "Send batch payments to multiple recipients with automatic tracking and reconciliation"
 ---
 
@@ -9,7 +10,7 @@
 
 ## Overview
 
 Streamline your payment operations with Request Network payouts. Send instant payments to multiple recipients, maintain complete payment records, and eliminate the complexity of manual crypto transfers.
 
 ## 🚀 Quickstart: Send Your First Payout
 
@@ -67,7 +68,7 @@
 - Multi-currency payment support
 - Real-time transaction tracking
 - Payment history and analytics
 - Crosschain payment capabilities
 
 ## Integration Options