💳 Payment Detection

Automatically detect and verify crypto payments with real-time blockchain monitoring and webhooks

Overview

Payment Detection monitors blockchain networks to automatically identify and verify when payments are completed. Add crypto payment acceptance to your existing systems without rebuilding your entire infrastructure.

When to Use Payment Detection

Existing Business Logic

You already have invoicing, billing, or business systems and just need crypto payment acceptance

Single Wallet, Many Payments

Collect payments at scale to one wallet address and automatically attribute each payment

Real-time Verification

Need instant payment confirmation without manual blockchain checking

Multi-chain Support

Accept payments across Ethereum, Polygon, BSC, and 10+ EVM chains

Common Scenarios

Donations with Attribution

Accept crypto donations to a single wallet and automatically attribute each to the correct donor, campaign, or cause.

Example: A nonprofit collects donations from hundreds of donors to one Ethereum address. Each donation includes a Request ID, enabling automatic attribution and thank-you emails.

SaaS Adding Crypto Payments

Existing subscription or billing platform adds crypto as a payment option alongside credit cards.

Example: A SaaS company uses Stripe for card payments but wants to offer USDC payments. Payment Detection monitors for crypto payments and updates subscription status automatically.

Manual Invoices + Crypto Detection

Send invoices through existing channels (email, PDF) and let customers pay in crypto with automatic detection.

Example: A freelancer emails invoices as PDFs with a Request ID. Clients pay in crypto, and the freelancer’s accounting software automatically marks invoices as paid via webhook.

High-Volume Payment Collection

Collect thousands of payments without creating new wallet addresses for each transaction.

Example: An e-commerce platform processes 10,000+ crypto orders per day. Instead of generating unique addresses, each order gets a Request ID for attribution.

---

How Payment Detection Works

1. Payment Initiated

   Customer sends crypto payment including the Request ID in the transaction reference

2. Blockchain Monitoring

   Request Network continuously scans supported blockchains for transactions matching your requests

3. Payment Detected

   When a matching payment is found, Request Network verifies amount, currency, and confirmations

4. Webhook Notification

   Your system receives a real-time webhook with payment details and status

5. Automatic Reconciliation

   Your business logic updates invoice status, triggers fulfillment, or sends receipts

---

Detection Features

Real-time Blockchain Scanning

• Multi-chain monitoring: Ethereum, Polygon, Arbitrum, Optimism, BSC, Gnosis, Fantom, Avalanche, and more
• Sub-minute detection: Typically detect payments within seconds of blockchain confirmation
• Confirmation tracking: Configurable confirmation thresholds for different security requirements

Payment Verification

• Amount matching: Verify exact payment amount or accept partial payments
• Currency validation: Support for 553+ tokens across all supported chains
• Smart contract verification: Detect payments through ERC20, native tokens, and conversion proxies

Webhook Integration

• Event notifications: payment.detected, payment.confirmed, payment.failed
• Retry logic: Automatic webhook retries with exponential backoff
• Signature verification: Cryptographically signed webhooks for security

---

API Integration

Webhooks

Real-time payment notifications sent to your server

Query Payments

Poll for payment status on demand

Payment Detection API

Technical details on detection methods and configuration

Request Status

Check request status including payment state

---

Detection-Only vs Full Workflows

Understanding when to use standalone payment detection versus integrated workflows:

Payment Detection Only

Best for: Existing systems that just need crypto payment acceptance

What you handle:

• Create invoices/requests in your existing system
• Generate Request IDs via API
• Include Request ID in payment instructions
• Receive webhooks when payments are detected
• Update your system based on payment status

What Request Network handles:

• Blockchain monitoring across all chains
• Payment verification and confirmation tracking
• Webhook delivery with retry logic
• Permanent on-chain payment records

Example: QuickBooks + crypto payments via Request Network detection

---

Implementation Example

Here’s a minimal example of using payment detection with webhooks:

Node.js - Create Request

const response = await fetch('https://api.request.network/requests', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    currency: 'USDC-matic',
    expectedAmount: '100.00',
    paymentAddress: '0x...your-wallet',
    reason: 'Invoice #12345'
  })
});

const { requestId } = await response.json();
// Include requestId in payment instructions to customer

---

Supported Networks & Currencies

Mainnet Networks

• Ethereum: ETH, USDC, USDT, DAI, and 200+ ERC20 tokens
• Polygon: MATIC, USDC, USDT, DAI, and 150+ tokens
• Arbitrum, Optimism, BSC, Gnosis, Fantom, Avalanche: Full ERC20 support

Detection Speed

• Ethereum: ~15 seconds per confirmation
• Polygon: ~2 seconds per confirmation
• Layer 2s: Sub-second to ~2 seconds

Testnet Support

Available on Sepolia, Mumbai, and other testnets for development

View all supported chains and currencies →

---

Next Steps

Get API Keys

Set up authentication and create your first request

Configure Webhooks

Set up real-time payment notifications

Query API

Learn how to check payment status programmatically

View Portal

Manage API keys and monitor requests in real-time