跳到主要内容

PayerScan 简介

PayerScan 允许商户将加密货币支付（USDT、BNB、ETH 等）集成到其网站或应用程序中。客户通过加密钱包或交易所账户付款，系统自动验证交易并通过 API 和 Webhooks 通知商户。

主要功能​

  • 通过 API 创建支付发票，包含金额（USD）、到期时间、回调 URL。
  • 结账页面显示二维码、钱包地址和需转账的精确加密货币数量。
  • 多网络 — 支持多种支付方式：
    • EVM 链：BSC、Ethereum、Polygon、Base、Arbitrum、...
    • Tron：TRC20 代币
    • Solana：SPL 代币
    • 交易所平台：Binance Pay、OKX、Bybit、MEXC、Gate.io、Bitget、...（无 gas 费，即时确认）
  • 自动确认：检测到匹配交易时（正确地址、正确金额、在时间窗口内）。
  • Webhooks 在支付成功或发票过期时通知商户服务器。
  • 状态查询 API：通过 trans_id 查询发票。

工作流程​

  1. 创建发票 — 商户调用 POST /payment/crypto，传入 merchant_id、amount、callback_url，获得 trans_id + url_payment。
  2. 重定向客户 — 商户将客户重定向到 url_payment（结账页面）。
  3. 客户付款 — 客户选择代币/网络，然后将精确金额转账到显示的钱包地址（或通过交易所平台付款）。
  4. 自动确认 — 系统检测并验证交易 → 将发票更新为 completed → 向商户的 callback_url 发送 POST webhook。
  5. 发票过期 — 如果客户未在时间窗口内付款，发票状态变为 expired，同样会向 callback_url 发送 webhook。
  6. 检查状态 — 商户可随时调用 GET /invoice/:trans_id 查看当前状态。

集成要求​

  • API Key：每个商店都有一个 API Key，通过 x-api-key 请求头在每个请求中发送。
  • 支付方式：创建发票前，必须在商店中配置至少一个钱包地址或交易所平台。
  • 回调 URL：商户服务器接收 completed/expired 发票 POST（webhook）事件的公共 HTTPS URL。
  • HTTPS：PayerScan API 专用 HTTPS。回调 URL 也应使用 HTTPS 以确保安全数据传输。

下一步​