Skip to content

create-requests-query-status.mdx

Latest commit

 

History

History
83 lines (62 loc) · 2.1 KB

create-requests-query-status.mdx

File metadata and controls

83 lines (62 loc) · 2.1 KB
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

graph TD
    A[Create Request] --> B[Generate ID]
    B --> C[Store on IPFS]
    C --> D[Index on Blockchain]
    D --> E[Return Request]
Loading

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 for instant status notifications.

Implementation Details

See API Reference - Requests for complete technical documentation.