Skip to main content
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 or contact support.

​
Welcome to Request Network

Get started with Request Network in just a few minutes. This guide will walk you through setting up your account, obtaining API keys, and making your first API call.

​
Quick Setup

1

Create Account

Sign up for a free Request Network account at portal.request.network
2

Get API Keys

Generate your API keys for both testnet (development) and mainnet (production)
3

Choose Integration

Select your integration approach based on your use case
4

Make First Call

Test your setup with a simple API call

​
Account Setup

​
Request Portal Registration

Developer Account

For Developers:
  • Free account with generous limits
  • Access to testnet for development
  • API documentation and tools
  • Community support
Sign Up →

Enterprise Account

For Enterprises:
  • Higher rate limits
  • Priority support
  • Custom integrations
  • SLA guarantees
Contact Sales →

​
API Key Generation

  • Testnet Keys
  • Production Keys
Development Environment:
  1. Log in to Request Portal
  2. Navigate to “API Keys” section
  3. Click “Generate New Key”
  4. Select “Testnet” environment
  5. Name your key (e.g., “Development”)
  6. Copy and securely store the key
Testnet vs MainnetAlways start development on testnet. Testnet uses test cryptocurrencies with no real value.

​
Choose Your Path

Select the integration approach that best fits your needs:

📄 Invoicing

Best for: Professional invoicing, B2B paymentsGet started with invoice creation and payment collection in under 5 minutes.

💰 Payouts

Best for: Vendor payments, contractor payoutsSend instant crypto payments to multiple recipients with batch processing.

🛒 Checkout

Best for: E-commerce, digital goodsAccept crypto payments in your online store with 80+ wallet support.

💼 Payroll

Best for: Employee payments, bulk processingAutomate payroll with batch payments and recurring schedules.

🔄 Subscriptions

Best for: SaaS billing, recurring revenueSet up automated subscription billing with flexible payment cycles.

​
Quick Test

Verify your setup with a simple API call: 
curl -X POST https://api.request.network/v2/requests \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "USD",
    "expectedAmount": "100",
    "payeeIdentity": "0x627306090abaB3A6e1400e9345bC60c78a8BEf57",
    "reason": "Test invoice"
  }'

​
Environment Configuration

​
Environment Variables

Set up your environment variables for secure API key management: 
# Request Network Configuration
REQUEST_NETWORK_API_KEY=your_api_key_here
REQUEST_NETWORK_ENVIRONMENT=testnet

# Webhook Configuration (optional)
REQUEST_WEBHOOK_SECRET=your_webhook_secret_here
REQUEST_WEBHOOK_URL=https://your-domain.com/webhooks/request-network

# Application Configuration
PORT=3000
NODE_ENV=development

​
Development Tools

​
Request Portal Features

API Explorer

Interactive Testing:
  • Test API endpoints directly in browser
  • Real-time response preview
  • Code generation for multiple languages
  • Request/response logging

Webhook Testing

Webhook Development:
  • Test webhook delivery
  • Inspect webhook payloads
  • Retry failed webhooks
  • Webhook logs and analytics

Transaction Monitor

Real-time Monitoring:
  • Live transaction tracking
  • Payment status updates
  • Error monitoring and alerts
  • Performance metrics

Analytics Dashboard

Usage Analytics:
  • API usage statistics
  • Payment volume tracking
  • Success/failure rates
  • Performance insights

​
Troubleshooting

​
Common Issues

401 Unauthorized:
  • Verify API key is correct
  • Check environment (testnet vs mainnet)
  • Ensure API key has required permissions
  • Verify Authorization header format
429 Too Many Requests:
  • Implement exponential backoff
  • Check your current rate limits
  • Consider upgrading to higher limits
  • Optimize API call frequency
Connection Problems:
  • Check network connectivity
  • Verify API endpoint URLs
  • Test with different networks
  • Check firewall settings

​
What’s Next?

Now that you’re set up, explore the features that matter most to your use case:

📚 API Reference

Detailed API endpoint documentation

⚙️ API Features

Learn about payment types and advanced capabilities

🛠️ Payment Types

Learn about payment types and integration options