From 19d9cbfc2cdf9650954822ee7a0f21bc271c1e8e Mon Sep 17 00:00:00 2001 From: MantisClone Date: Fri, 21 Nov 2025 16:10:40 -0500 Subject: [PATCH 1/4] docs: cleanup and improve Invoicing use case page - Remove AI-generated warning - Improve overview with benefits-focused copy - Fix quickstart steps (payment processing clarity) - Update demo section with correct EasyInvoice URL - Convert integration approaches from tabs to card layout - Add Info callout linking to integration comparison - Update Key API Features (8 features, proper links, reordered) - Improve What's Next section (3 focused cards) - Replace emojis with proper icons in title - Fix all em-dashes to normal dashes - Add missing features: Query Requests, Payment Types Overview - Update all other use case pages to use icons instead of emojis --- api-features/create-requests-query-status.mdx | 83 ------- use-cases/checkout.mdx | 3 +- use-cases/invoicing.mdx | 213 ++++++++++-------- use-cases/payment-detection.mdx | 3 +- use-cases/payouts.mdx | 3 +- use-cases/payroll.mdx | 3 +- use-cases/subscriptions.mdx | 3 +- 7 files changed, 125 insertions(+), 186 deletions(-) delete mode 100644 api-features/create-requests-query-status.mdx diff --git a/api-features/create-requests-query-status.mdx b/api-features/create-requests-query-status.mdx deleted file mode 100644 index 393239c..0000000 --- a/api-features/create-requests-query-status.mdx +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: "Create Requests & Query Status" -description: "Request creation, management, and real-time status monitoring" ---- - -## Overview - -Request creation and status querying form the foundation of Request Network operations, enabling invoice generation and payment tracking throughout the lifecycle. - -## Request Creation - - - - Traditional invoicing workflows - - - - Direct payment collection - - - -## How It Works - -```mermaid -graph TD - A[Create Request] --> B[Generate ID] - B --> C[Store on IPFS] - C --> D[Index on Blockchain] - D --> E[Return Request] -``` - -**Process:** -1. **Create:** Submit request with payee, payer, and amount details -2. **Store:** Decentralized storage on IPFS -3. **Index:** Blockchain indexing for discovery -4. **Track:** Real-time status monitoring - -## Request Properties - -### Core Information -- **Payee:** Request creator/recipient -- **Payer:** Payment sender (optional) -- **Amount:** Payment amount and currency -- **Due Date:** Payment deadline - -### Payment Configuration -- **Payment Network:** ERC20, ETH, or custom -- **Accepted Tokens:** Supported payment currencies -- **Conversion:** Fiat-denominated crypto payments - -## Status Lifecycle - -### Request States -- `created` - Request initialized -- `pending` - Awaiting payment -- `paid` - Payment completed -- `cancelled` - Request cancelled - -### Payment States -- `no_payment` - No payment detected -- `partially_paid` - Partial payment received -- `paid` - Full payment completed -- `overpaid` - Payment exceeds requested amount - -## Query Methods - - - - Get specific request by ID - - - - Multiple requests in one call - - - -## Real-time Updates - -Combine with [Webhooks & Events](/api-features/webhooks-events) for instant status notifications. - -## Implementation Details - -See [API Reference - Requests](/api-reference/requests) for complete technical documentation. \ No newline at end of file diff --git a/use-cases/checkout.mdx b/use-cases/checkout.mdx index 88d4edc..6b4c24b 100644 --- a/use-cases/checkout.mdx +++ b/use-cases/checkout.mdx @@ -1,5 +1,6 @@ --- -title: "🛒 Checkout" +title: "Checkout" +icon: "cart-shopping" description: "Add crypto payment checkout to your e-commerce platform with seamless customer experience" --- diff --git a/use-cases/invoicing.mdx b/use-cases/invoicing.mdx index 20d5659..a399be2 100644 --- a/use-cases/invoicing.mdx +++ b/use-cases/invoicing.mdx @@ -1,157 +1,174 @@ --- -title: "📄 Invoicing" +title: "Invoicing" +icon: "file-invoice" description: "Create crypto invoices with automatic payment detection and reconciliation" --- - -**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). - - ## 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. +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. -## 🚀 Quickstart: Create Your First Invoice +**What you get:** +- **Permanent records** - Invoices stored on IPFS 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 on-chain payment +- **Cross-chain support** - Accept payments across 9 networks in 150+ currencies +- **Webhook automation** - Real-time payment confirmations for backend integration - -**Get your first invoice paid in under 1 minute** - -*Interactive quickstart experience coming soon* - +## Quickstart - Generate a payment request with amount, recipient, and payment terms - - - Send the secure payment link to your customer + Call the [Create Request endpoint](/api-reference/request/create-request) with invoice details - - Customer pays with their preferred wallet and currency + + Use the returned payment call data to prompt the payer to sign and submit the transaction on-chain - Real-time payment detection and automatic reconciliation + Use [webhooks](/api-features/webhooks-events) for real-time payment notifications -## EasyInvoice Demo +## Invoicing Demo + +Try the complete invoicing workflow with EasyInvoice: + + + Create invoices, accept crypto payments, and track payment status - all powered by Request Network API + + +**What you'll see:** +- Invoice creation with Request Network +- Multiple payment currencies and chains +- Automatic payment detection +- Real-time status updates via webhooks + +## Integration Approaches -See the complete invoicing workflow in action with our demo application: + +Not sure which approach fits your needs? [See our detailed comparison of integration approaches →](/resources/integration-approaches) + - 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) - Experience the full EasyInvoice application - - - -**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: - - - - **Best for:** Quick deployment, immediate invoicing capabilities + **Customize for your brand** - Deploy EasyInvoice directly for your business: - - Ready-to-use invoicing interface - - No development required - - Hosted solution with custom domain support + Clone and modify the open-source application to match your needs. - [Deploy EasyInvoice →](#) - - - - **Best for:** Custom branding, workflow modifications + - Full source code access + - Custom branding + - Add your own features - Customize EasyInvoice for your specific needs: - - Clone the repository - - Modify UI/UX to match your brand - - Add custom business logic - - Requires API key setup + [Forking guide →](#) + + + + + **Complete control** - [Fork Repository →](#) | [Setup Guide →](#) - - - - **Best for:** White-label solutions, full control + Build a custom solution integrated with your existing systems. - Build your own invoicing system using Request Network API: - - Complete customization freedom - - Integrate with existing systems - - Pure API integration + - White-label ready + - Full customization + - Add fee layers + - Non-custodial architecture - [API Documentation →](/api-features/payment-types) - - + [API docs →](/api-features/create-requests) + ## Key API Features for Invoicing - Generate payment requests with flexible parameters and metadata + Generate payment requests with amount, recipient, and payment terms - Invoice in USD, get paid in crypto with automatic conversion + Fiat-denominated invoices settled in crypto with real-time price conversion + + + + Pay multiple invoices in a single transaction + + + + Accept payments across 9 different blockchain networks - Set up subscription billing and automated recurring invoices + Automate recurring invoice generation for ongoing vendor relationships - Real-time payment notifications for instant reconciliation + Automatic detection and verification of payments across chains - Accept installment payments and partial settlements + Build invoicing dashboards with historical invoice data and status tracking - Add invoice numbers, tax info, and business data + Explore all available payment methods and configurations @@ -159,7 +176,7 @@ Choose the approach that best fits your needs: @@ -167,18 +184,18 @@ Choose the approach that best fits your needs: - Learn about payment types and advanced capabilities + See code examples for common invoicing workflows - Review supported chains and currencies + See which networks and tokens you can use diff --git a/use-cases/payment-detection.mdx b/use-cases/payment-detection.mdx index b51f94b..04d7c84 100644 --- a/use-cases/payment-detection.mdx +++ b/use-cases/payment-detection.mdx @@ -1,5 +1,6 @@ --- -title: "💳 Payment Detection" +title: "Payment Detection" +icon: "credit-card" description: "Automatically detect and verify crypto payments with real-time blockchain monitoring and webhooks" --- diff --git a/use-cases/payouts.mdx b/use-cases/payouts.mdx index 9f518b9..bb8a084 100644 --- a/use-cases/payouts.mdx +++ b/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" --- diff --git a/use-cases/payroll.mdx b/use-cases/payroll.mdx index 2adff37..d1aefe5 100644 --- a/use-cases/payroll.mdx +++ b/use-cases/payroll.mdx @@ -1,5 +1,6 @@ --- -title: "💼 Payroll" +title: "Payroll" +icon: "briefcase" description: "Pay your team in crypto with automated payroll runs and compliance tracking" --- diff --git a/use-cases/subscriptions.mdx b/use-cases/subscriptions.mdx index 35e3f3e..0607483 100644 --- a/use-cases/subscriptions.mdx +++ b/use-cases/subscriptions.mdx @@ -1,5 +1,6 @@ --- -title: "🔄 Subscriptions" +title: "Subscriptions" +icon: "rotate" description: "Implement recurring crypto payments for subscription-based business models" --- From cccee43beb4609222b714c22700a731047e694d9 Mon Sep 17 00:00:00 2001 From: MantisClone Date: Fri, 21 Nov 2025 16:31:36 -0500 Subject: [PATCH 2/4] refine: simplify Quickstart Step 2 wording for clarity --- use-cases/invoicing.mdx | 18 +----------------- 1 file changed, 1 insertion(+), 17 deletions(-) diff --git a/use-cases/invoicing.mdx b/use-cases/invoicing.mdx index a399be2..bbc9345 100644 --- a/use-cases/invoicing.mdx +++ b/use-cases/invoicing.mdx @@ -22,7 +22,7 @@ Bring instant, verifiable payments to your invoicing flow. Generate invoices in Call the [Create Request endpoint](/api-reference/request/create-request) with invoice details - Use the returned payment call data to prompt the payer to sign and submit the transaction on-chain + Use the payment data to show payment options, then guide the payer through wallet signature and submission Use [webhooks](/api-features/webhooks-events) for real-time payment notifications @@ -131,14 +131,6 @@ Not sure which approach fits your needs? [See our detailed comparison of integra Pay multiple invoices in a single transaction - - Accept payments across 9 different blockchain networks - - Build invoicing dashboards with historical invoice data and status tracking - - - Explore all available payment methods and configurations - ## What's Next? From 4d6af66002df02f06df63f69d633be5fecbb8154 Mon Sep 17 00:00:00 2001 From: MantisClone Date: Fri, 21 Nov 2025 16:35:41 -0500 Subject: [PATCH 3/4] enhance: add tooltips for technical terms and Check callout after demo --- use-cases/invoicing.mdx | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/use-cases/invoicing.mdx b/use-cases/invoicing.mdx index bbc9345..c6f0508 100644 --- a/use-cases/invoicing.mdx +++ b/use-cases/invoicing.mdx @@ -9,9 +9,9 @@ description: "Create crypto invoices with automatic payment detection and reconc 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. **What you get:** -- **Permanent records** - Invoices stored on IPFS create a tamper-proof audit trail +- **Permanent records** - Invoices stored on IPFS 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 on-chain payment +- **Instant reconciliation** - Every invoice automatically linked to its on-chain payment - **Cross-chain support** - Accept payments across 9 networks in 150+ currencies - **Webhook automation** - Real-time payment confirmations for backend integration @@ -47,6 +47,10 @@ Try the complete invoicing workflow with EasyInvoice: - Automatic payment detection - Real-time status updates via webhooks + +**Ready to integrate?** If EasyInvoice meets your needs, you can start using it immediately. For custom requirements, explore the integration options below. + + ## Integration Approaches @@ -99,7 +103,7 @@ Not sure which approach fits your needs? [See our detailed comparison of integra - White-label ready - Full customization - Add fee layers - - Non-custodial architecture + - Non-custodial architecture [API docs →](/api-features/create-requests) From 557868d2f6303f045070d453d7064e41d4b49a41 Mon Sep 17 00:00:00 2001 From: MantisClone Date: Fri, 21 Nov 2025 18:38:21 -0500 Subject: [PATCH 4/4] fix: address CodeRabbit review comments - indentation and links --- use-cases/invoicing.mdx | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/use-cases/invoicing.mdx b/use-cases/invoicing.mdx index c6f0508..467a0d2 100644 --- a/use-cases/invoicing.mdx +++ b/use-cases/invoicing.mdx @@ -19,7 +19,7 @@ Bring instant, verifiable payments to your invoicing flow. Generate invoices in - Call the [Create Request endpoint](/api-reference/request/create-request) with invoice details + Call the [Create Request endpoint](/api-features/create-requests) with invoice details Use the payment data to show payment options, then guide the payer through wallet signature and submission @@ -91,22 +91,22 @@ Not sure which approach fits your needs? [See our detailed comparison of integra - - **Complete control** - - Build a custom solution integrated with your existing systems. - - - White-label ready - - Full customization - - Add fee layers - - Non-custodial architecture - - [API docs →](/api-features/create-requests) - + + **Complete control** + + Build a custom solution integrated with your existing systems. + + - White-label ready + - Full customization + - Add fee layers + - Non-custodial architecture + + [API docs →](/api-features/create-requests) + ## Key API Features for Invoicing @@ -137,7 +137,7 @@ Not sure which approach fits your needs? [See our detailed comparison of integra Automate recurring invoice generation for ongoing vendor relationships