Query Requests

Request status monitoring, lifecycle management, and information retrieval

Overview

Query requests provides comprehensive request status monitoring and information retrieval, enabling real-time tracking of payment requests throughout their lifecycle.

Request Status Lifecycle

Active States

Created, pending, partially paid

Final States

Paid, cancelled, expired

How It Works

Query Process:

1. Identify: Use request ID for lookup
2. Retrieve: Get current request information
3. Analyze: Check payment status and history
4. Update: Reflect latest blockchain state

Status Types

Request States

• created - Request initialized and stored
• pending - Awaiting payment completion
• paid - Full payment received and confirmed
• cancelled - Request cancelled by creator
• expired - Past due date without payment

Payment States

• no_payment - No payment transactions detected
• partially_paid - Partial payment received
• paid - Full payment amount received
• overpaid - Payment exceeds requested amount

Query Methods

Single Request

Detailed status for specific request

Batch Queries

Multiple request status in one call

Information Retrieved

• Basic Details: Amount, currency, participants
• Payment History: Transaction details and confirmations
• Status Timeline: Creation, updates, completion dates
• Network Data: Blockchain and transaction information

Real-time Monitoring

Automatic Updates

Combine with Payment Detection for automatic status updates

Event Integration

Use Webhooks & Events for instant notifications

Advanced Filtering

Filter requests by:

• Date Range: Creation or due date periods
• Status: Current request or payment state
• Participants: Payee or payer addresses
• Amount Range: Minimum and maximum values

Used In

Dashboard Apps

Real-time payment tracking

Accounting Systems

Invoice status reconciliation

Implementation Details

See API Reference - Query Requests for complete technical documentation.