跳到主要内容

API 概览

PayerScan 是一个自动化加密货币支付网关,可跨多个区块链网络(EVM、Tron、Solana)验证交易,并与全球 8 大交易所直接集成 — 帮助商户实现实时验证、自动匹配和即时结算通知的加密支付收款。

功能特性

  • 创建发票:通过 REST API 发起交易,返回完整的 Checkout UI 链接。
  • 多链验证:自动扫描多个热门区块链网络的交易 — BNB Smart Chain (BEP20)Ethereum (ERC20)BasePolygonArbitrumOptimismTron (TRC20) — 以及通过 Binance Pay / OKX UID,... 的内部转账。
  • 交易所集成:与全球 8 大加密货币交易所直接 API 连接 — BinanceOKXBybitBitgetGateMEXCUpbitBitkub — 提供实时价格数据和支付验证。
  • 多币种支持:接受多种代币支付 — USDTUSDCBNBETH 等 — 涵盖所有支持的网络。
  • 自动过期:发票在可配置的时间段后自动过期,确保过期的支付请求被妥善处理。
  • 精确金额匹配:使用 BigInt 精度匹配,消除 JS 舍入误差。
  • 智能回调:当支付完成过期时,主动通过 Webhook(callback_url)通知商户,并自动重试机制(5 次)。
  • 幂等性:发送相同的 request_id 将返回已有发票,避免重复创建,确保重试逻辑的安全性。
  • 频率限制:多层请求限流保护 API 免受滥用,确保所有商户的公平使用。
  • 去重:防止单个交易哈希(txHash)被用于结算多张发票。
  • 实时通知:通过 Telegram、Lark 或 Email 即时推送支付提醒,让商户随时掌握动态。
  • 自定义结账页面:提供多种结账主题,允许商户自定义支付页面以匹配品牌形象。

📖 有关支持的网络和交易所的详细信息,请参阅网络与交易所指南

核心系统组件

开始使用,请导航至以下部分:

  1. 快速开始:只需 10 分钟即可运行测试支付。
  2. 认证:如何管理和使用 API Key。
  3. 创建发票:POST 数据结构详情。
  4. 获取发票:查询发票状态和支付详情。
  5. Webhook 事件:监听完成状态。
  6. 错误代码:API 错误代码完整列表及其含义。
  7. 频率限制:请求限制和限流策略。
  8. 代码示例:即用型集成示例。