​
Overview

Request Network supports multiple payment types to accommodate different business needs and transaction patterns. From simple direct payments to complex cross-chain transactions, our payment infrastructure provides the flexibility to handle any payment scenario.

​
Standard Payments

​
Direct Payments (Payouts)

Send payments immediately without creating a request first. Perfect for vendor payments, contractor payouts, and one-time transfers.

Single Payouts

Use Case: Individual vendor payments, contractor feesFeatures:
  • Instant payment execution
  • Real-time confirmation
  • Automatic payment records
Best For: Payouts, Payroll

Batch Payouts

Use Case: Payroll processing, multiple vendor paymentsFeatures:
  • Multiple recipients in one transaction
  • Gas cost optimization
  • Atomic transaction processing
Best For: Payroll, bulk Payouts

​
Request-Based Payments (Invoicing)

Create payment requests first, then allow customers to pay. Ideal for invoicing, e-commerce checkout, and formal payment collection.

Invoice Payments

Use Case: Professional invoicing, B2B paymentsFeatures:
  • Payment request creation
  • Customer payment portal
  • Payment tracking and reconciliation
Best For: Invoicing, formal payment collection

Checkout Payments

Use Case: E-commerce, digital goods, servicesFeatures:
  • Embedded payment widgets
  • Real-time payment confirmation
  • Order reconciliation
Best For: Checkout, e-commerce integration

​
Advanced Payment Types

​
Cross-Chain Payments

Enable payments across different blockchain networks with automatic routing and optimization.
Cross-Chain Payment Flow:
  1. Customer selects preferred payment chain
  2. Request Network routes payment optimally
  3. Merchant receives payment on their preferred chain
  4. Automatic bridging and conversion handled transparently
Supported Networks:
  • Ethereum, Polygon, Arbitrum, Optimism
  • Base, BSC, Avalanche, Fantom
  • Gnosis Chain, Celo

​
Conversion Payments (Crypto-to-Fiat)

Accept payments in crypto while receiving fiat currency, or invoice in fiat while accepting crypto payments.

​
Recurring Payments

Automate subscription billing and recurring payment collection with flexible scheduling.

Subscription Billing

Frequency Options:
  • Weekly, bi-weekly, monthly
  • Quarterly, semi-annual, annual
  • Custom intervals
Perfect For: Subscriptions, SaaS billing

Recurring Payouts

Automation Features:
  • Scheduled vendor payments
  • Automated payroll processing
  • Recurring retainer payments
Perfect For: Payroll, vendor management

Flexible Scheduling

Advanced Options:
  • Pro-rated billing periods
  • Grace periods for failed payments
  • Automatic retry logic
Perfect For: Complex billing scenarios

​
Payment Implementation Patterns

​
Payment Request Lifecycle

1

Request Creation

Create payment request with amount, currency, and metadata
2

Customer Notification

Share payment link or embed payment widget
3

Payment Execution

Customer completes payment using their preferred method
4

Confirmation & Reconciliation

Automatic payment detection and business system updates

​
Direct Payout Flow

1

Payout Initiation

Specify recipient address, amount, and payment currency
2

Transaction Execution

Payment sent immediately to recipient’s wallet
3

Confirmation

Real-time transaction confirmation and record creation
4

Record Keeping

Automatic payment record creation for accounting

​
Technical Implementation

import { RequestNetwork } from '@requestnetwork/request-client.js';

// Create a payment request
const paymentRequest = await requestNetwork.createRequest({
  requestInfo: {
    currency: 'USD',
    expectedAmount: '1000',
    payee: {
      type: 'ethereumAddress',
      value: merchantAddress
    },
    payer: {
      type: 'ethereumAddress',
      value: customerAddress
    }
  },
  paymentNetwork: {
    id: 'erc20-fee-proxy-contract',
    parameters: {
      paymentNetworkName: 'matic',
      paymentAddress: merchantAddress,
      feeAddress: platformFeeAddress,
      feeAmount: '50' // 5% platform fee
    }
  },
  contentData: {
    reason: 'Invoice #INV-001',
    dueDate: '2025-10-01'
  }
});

​
Currency Support

553+ Currencies Across 10 EVM ChainsMajor Cryptocurrencies:
  • ETH, BTC, USDC, USDT, DAI
  • MATIC, AVAX, BNB, FTM
  • Hundreds of ERC-20 tokens
Fiat Currencies:
  • USD, EUR, GBP, JPY
  • 150+ international currencies
View Complete List →

​
What’s Next?

🔧 Advanced Features

Explore webhooks, fees, and metadata capabilities

🛠️ Integration Patterns

Learn common integration patterns and best practices

📚 API Reference

Detailed API endpoint documentation