|
| 1 | +--- |
| 2 | +title: "Create Requests & Query Status" |
| 3 | +description: "Request creation, management, and real-time status monitoring" |
| 4 | +--- |
| 5 | + |
| 6 | +## Overview |
| 7 | + |
| 8 | +Request creation and status querying form the foundation of Request Network operations, enabling invoice generation and payment tracking throughout the lifecycle. |
| 9 | + |
| 10 | +## Request Creation |
| 11 | + |
| 12 | +<CardGroup cols={2}> |
| 13 | + <Card title="Invoice Requests" icon="file-invoice"> |
| 14 | + Traditional invoicing workflows |
| 15 | + </Card> |
| 16 | + |
| 17 | + <Card title="Payment Requests" icon="money-bill"> |
| 18 | + Direct payment collection |
| 19 | + </Card> |
| 20 | +</CardGroup> |
| 21 | + |
| 22 | +## How It Works |
| 23 | + |
| 24 | +```mermaid |
| 25 | +graph TD |
| 26 | + A[Create Request] --> B[Generate ID] |
| 27 | + B --> C[Store on IPFS] |
| 28 | + C --> D[Index on Blockchain] |
| 29 | + D --> E[Return Request] |
| 30 | +``` |
| 31 | + |
| 32 | +**Process:** |
| 33 | +1. **Create:** Submit request with payee, payer, and amount details |
| 34 | +2. **Store:** Decentralized storage on IPFS |
| 35 | +3. **Index:** Blockchain indexing for discovery |
| 36 | +4. **Track:** Real-time status monitoring |
| 37 | + |
| 38 | +## Request Properties |
| 39 | + |
| 40 | +### Core Information |
| 41 | +- **Payee:** Request creator/recipient |
| 42 | +- **Payer:** Payment sender (optional) |
| 43 | +- **Amount:** Payment amount and currency |
| 44 | +- **Due Date:** Payment deadline |
| 45 | + |
| 46 | +### Payment Configuration |
| 47 | +- **Payment Network:** ERC20, ETH, or custom |
| 48 | +- **Accepted Tokens:** Supported payment currencies |
| 49 | +- **Conversion:** Fiat-denominated crypto payments |
| 50 | + |
| 51 | +## Status Lifecycle |
| 52 | + |
| 53 | +### Request States |
| 54 | +- `created` - Request initialized |
| 55 | +- `pending` - Awaiting payment |
| 56 | +- `paid` - Payment completed |
| 57 | +- `cancelled` - Request cancelled |
| 58 | + |
| 59 | +### Payment States |
| 60 | +- `no_payment` - No payment detected |
| 61 | +- `partially_paid` - Partial payment received |
| 62 | +- `paid` - Full payment completed |
| 63 | +- `overpaid` - Payment exceeds requested amount |
| 64 | + |
| 65 | +## Query Methods |
| 66 | + |
| 67 | +<CardGroup cols={2}> |
| 68 | + <Card title="Single Request" icon="magnifying-glass"> |
| 69 | + Get specific request by ID |
| 70 | + </Card> |
| 71 | + |
| 72 | + <Card title="Batch Queries" icon="list"> |
| 73 | + Multiple requests in one call |
| 74 | + </Card> |
| 75 | +</CardGroup> |
| 76 | + |
| 77 | +## Real-time Updates |
| 78 | + |
| 79 | +Combine with [Webhooks & Events](/api-features/webhooks-events) for instant status notifications. |
| 80 | + |
| 81 | +## Implementation Details |
| 82 | + |
| 83 | +See [API Reference - Requests](/api-reference/requests) for complete technical documentation. |
0 commit comments