Chuyển tới nội dung chính

Giới thiệu PayerScan

PayerScan cho phép Merchant tích hợp thanh toán tiền mã hóa (USDT, BNB, ETH, v.v.) vào website hoặc ứng dụng. Khách hàng thanh toán bằng ví crypto hoặc tài khoản sàn giao dịch, hệ thống tự động xác minh giao dịch và thông báo cho Merchant qua API và Webhooks.

Tính năng chính​

  • Tạo hóa đơn thanh toán qua API với số tiền (USD), thời hạn, callback URL.
  • Trang thanh toán hiển thị mã QR, địa chỉ ví và số lượng crypto chính xác cần chuyển.
  • Đa mạng lưới — hỗ trợ nhiều phương thức thanh toán:
    • EVM Chains: BSC, Ethereum, Polygon, Base, Arbitrum, ...
    • Tron: Token TRC20
    • Solana: Token SPL
    • Sàn giao dịch: Binance Pay, OKX, Bybit, MEXC, Gate.io, Bitget, ... (không phí gas, xác nhận tức thì)
  • Tự động xác nhận khi phát hiện giao dịch khớp (đúng địa chỉ, đúng số tiền, trong khung thời gian).
  • Webhooks thông báo cho server Merchant khi thanh toán thành công hoặc hóa đơn hết hạn.
  • API tra cứu trạng thái hóa đơn theo trans_id.

Quy trình hoạt động​

  1. Tạo hóa đơn — Merchant gọi POST /payment/crypto với merchant_id, amount, callback_url, nhận về trans_id + url_payment.
  2. Chuyển hướng khách — Merchant chuyển hướng khách đến url_payment (trang thanh toán).
  3. Khách thanh toán — Khách chọn token/network, rồi chuyển đúng số tiền đến địa chỉ ví hiển thị (hoặc thanh toán qua sàn giao dịch).
  4. Tự động xác nhận — Hệ thống phát hiện và xác minh giao dịch → cập nhật hóa đơn thành completed → gửi POST webhook đến callback_url của Merchant.
  5. Hóa đơn hết hạn — Nếu khách không thanh toán trong khung thời gian, trạng thái hóa đơn chuyển thành expired và webhook cũng được gửi đến callback_url.
  6. Kiểm tra trạng thái — Merchant có thể gọi GET /invoice/:trans_id để kiểm tra trạng thái bất kỳ lúc nào.

Yêu cầu tích hợp​

  • API Key: Mỗi Store có một API Key, gửi qua header x-api-key trong mọi request.
  • Phương thức thanh toán: Cần cấu hình ít nhất một địa chỉ ví hoặc sàn giao dịch trong Store trước khi tạo hóa đơn.
  • Callback URL: URL HTTPS công khai nơi server Merchant nhận các sự kiện POST (webhook) cho hóa đơn completed/expired.
  • HTTPS: API PayerScan sử dụng HTTPS. Callback URL cũng nên dùng HTTPS để đảm bảo truyền dữ liệu an toàn.

Bước tiếp theo​