API Overview

PayerScan is an automated cryptocurrency payment gateway that verifies transactions across multiple blockchain networks (EVM, Tron, Solana) and integrates directly with 8 leading global exchanges — enabling merchants to accept crypto payments with real-time verification, automatic matching, and instant settlement notifications.

Features

• Invoice Creation: Open a transaction via REST API, returning a complete Checkout UI link.
• Multi-Chain Verification: Automatically scans transactions across popular blockchain networks — BNB Smart Chain (BEP20), Ethereum (ERC20), Base, Polygon, Arbitrum, Optimism, Tron (TRC20) — and internal transfers via Binance Pay / OKX UID,....
• Exchange Integration: Direct API connection with 8 major global cryptocurrency exchanges — Binance, OKX, Bybit, Bitget, Gate, MEXC, Upbit, Bitkub — for real-time price feeds and payment verification.
• Multi-Currency Support: Accept payments in multiple tokens — USDT, USDC, BNB, ETH, and more — across all supported networks.
• Auto Expiration: Invoices automatically expire after a configurable time period, ensuring stale payment requests are properly handled.
• Exact Amount Matching: Eliminates JS rounding errors with BigInt precision matching.
• Smart Callbacks: Proactively notifies Merchants via Webhook (callback_url) when payment is completed or expired, with automatic retry mechanism (5 attempts).
• Idempotency: Sending the same request_id returns the existing invoice instead of creating a duplicate, ensuring safe retry logic.
• Rate Limiting: Multi-layer request throttling protects the API from abuse and ensures fair usage across all merchants.
• Deduplication: Prevents a single transaction hash (txHash) from being used to settle multiple invoices.
• Real-time Notifications: Instant payment alerts delivered via Telegram, Lark, or Email to keep merchants informed.
• Customizable Checkout: Multiple checkout themes available, allowing merchants to match the payment page with their brand identity.

📖 For detailed supported networks and exchanges, see the Networks & Exchanges Guide.

Core System Components

To get started, navigate to the following sections:

1. Quick Start: Run a test payment in just 10 minutes.
2. Authentication: How to manage and use API Keys.
3. Create Invoice: POST data structure details.
4. Get Invoice: Query invoice status and payment details.
5. Webhook Events: Listen for completion status.
6. Error Codes: Complete list of API error codes and their meanings.
7. Rate Limits: Request limits and throttling policies.
8. Code Examples: Ready-to-use integration samples.