Skip to content

Latest commit

 

History

History
148 lines (115 loc) · 5.8 KB

File metadata and controls

148 lines (115 loc) · 5.8 KB
title Payment Detection
icon credit-card
description Automatically detect and verify crypto payments with real-time blockchain monitoring and webhooks

Overview

Traditional crypto payments lack business context. You receive a transaction hash, but don't know which customer, invoice, or order it's for. Manual reconciliation is error-prone and doesn't scale.

Request IDs solve this by attaching business context to every payment. Each request gets a unique Request ID that connects payments back to your specific invoice, order, or subscription with cryptographic certainty.

What you get:

  • Automatic attribution - Every payment linked to its request via Request ID
  • Multi-chain monitoring - Track payments across 10+ EVM chains and Tron in 500+ currencies
  • Real-time notifications - Webhooks for instant payment confirmations
  • Zero manual work - No spreadsheets, no guessing, no payment collisions

See how Request IDs prevent payment collisions (welcome page demo) →

When to Use Payment Detection

Multiple payments of the same amount create attribution problems - you can't tell which customer paid Processing hundreds or thousands of crypto payments where manual tracking doesn't scale Managing separate wallets for each customer or transaction creates operational complexity Accepting payments across multiple blockchains and need unified detection without managing multiple APIs

Common Scenarios

E-commerce Checkout

Accept crypto payments at scale without generating unique addresses for each customer.

Example: An e-commerce platform processes 10,000+ crypto orders per day. Each order gets a unique Request ID - customers pay to a single wallet address, and every payment is automatically attributed to the correct order.

SaaS Subscriptions

Add crypto as a payment option for recurring billing alongside traditional payment methods.

Example: A SaaS company uses Stripe for card payments but offers USDC for monthly subscriptions. Payment Detection automatically confirms renewals and updates subscription status without manual tracking.

Manual Invoices with Crypto Settlement

Send invoices through existing channels (email, PDF) and accept crypto payments with automatic reconciliation.

Example: A freelancer emails invoices as PDFs with a Request ID. When clients pay in crypto, the accounting software automatically marks invoices as paid via webhook - no manual checking required.

These scenarios all use automatic payment detection. [See technical details on detection methods and configuration →](/api-features/payment-detection)

How Payment Detection Works

When you create a request, it gets a unique Request ID for tracking Customer sends payment to your wallet address - the Request ID is connected to the transaction Request Network monitors blockchains and matches payments to your requests When a payment is detected, you receive a webhook notification with payment details Payment Detection powers all Request Network use cases: [invoicing](/use-cases/invoicing), [payouts](/use-cases/payouts), [payroll](/use-cases/payroll), [checkout](/use-cases/checkout), and [subscriptions](/use-cases/subscriptions). [See technical details on detection methods, confirmation thresholds, and implementation →](/api-features/payment-detection)

Key API Features for Payment Detection

Monitor blockchain transactions and match payments to requests automatically

<Card title="Webhooks" href="/api-features/webhooks-events" icon="webhook"

Real-time notifications when payments are detected, confirmed, or failed

<Card title="Query Requests" href="/api-features/query-requests" icon="magnifying-glass"

Check request status and payment history on demand

<Card title="Query Payments" href="/api-features/query-payments" icon="circle-check"

Retrieve detailed payment information including confirmations and amounts

What's Next?

Set up your account and get API credentials

<Card title="Payment Detection Details" href="/api-features/payment-detection" icon="code"

Technical deep dive on detection methods and configuration

<Card title="Supported Chains & Currencies" href="/resources/supported-chains-and-currencies" icon="globe"

See which networks and tokens you can use