Tổng quan API

PayerScan là cổng thanh toán tiền mã hóa tự động, xác minh giao dịch trên nhiều mạng blockchain (EVM, Tron, Solana) và tích hợp trực tiếp với 8 sàn giao dịch hàng đầu thế giới — giúp merchant chấp nhận thanh toán crypto với xác minh real-time, khớp lệnh tự động và thông báo thanh toán tức thì.

Tính năng

• Tạo hóa đơn: Mở giao dịch bằng REST API, trả về link Checkout UI hoàn chỉnh.
• Xác thực đa chuỗi: Quét tự động giao dịch trên các mạng blockchain phổ biến — BNB Smart Chain (BEP20), Ethereum (ERC20), Base, Polygon, Arbitrum, Optimism, Tron (TRC20) — và chuyển khoản nội bộ qua Binance Pay / OKX UID,....
• Tích hợp sàn giao dịch: Kết nối API trực tiếp với 8 sàn giao dịch tiền mã hóa hàng đầu thế giới — Binance, OKX, Bybit, Bitget, Gate, MEXC, Upbit, Bitkub — để cập nhật giá theo thời gian thực và xác minh thanh toán.
• Hỗ trợ đa tiền tệ: Chấp nhận thanh toán bằng nhiều loại token — USDT, USDC, BNB, ETH và nhiều token khác — trên tất cả các mạng được hỗ trợ.
• Tự động hết hạn: Hóa đơn tự động hết hạn sau khoảng thời gian có thể cấu hình, đảm bảo các yêu cầu thanh toán cũ được xử lý đúng cách.
• Khớp chính xác số tiền: Loại bỏ lỗi làm tròn của JS nhờ BigInt precision matching.
• Callback thông minh: Chủ động thông báo Merchant qua Webhook (callback_url) khi thanh toán hoàn tất hoặc hết hạn, kèm cơ chế tự động thử lại (5 lần).
• Idempotency: Gửi lại cùng request_id sẽ trả về hóa đơn đã tạo thay vì tạo trùng, đảm bảo logic retry an toàn.
• Giới hạn tần suất: Cơ chế giới hạn request nhiều tầng bảo vệ API khỏi lạm dụng và đảm bảo sử dụng công bằng giữa các merchant.
• Chống trùng lặp: Ngăn một transaction hash (txHash) được dùng để thanh toán nhiều hóa đơn.
• Thông báo real-time: Cảnh báo thanh toán tức thì qua Telegram, Lark hoặc Email để merchant luôn nắm thông tin.
• Tùy chỉnh giao diện thanh toán: Nhiều theme checkout có sẵn, cho phép merchant tùy chỉnh trang thanh toán phù hợp với thương hiệu.

📖 Xem chi tiết các mạng và sàn được hỗ trợ tại Hướng dẫn Mạng & Sàn giao dịch.

Các thành phần hệ thống chính

Để bắt đầu, hãy tham khảo các phần sau:

1. Bắt đầu nhanh: Chạy thử thanh toán chỉ trong 10 phút.
2. Xác thực: Cách quản lý và sử dụng API Key.
3. Tạo hóa đơn: Chi tiết cấu trúc dữ liệu POST.
4. Lấy hóa đơn: Truy vấn trạng thái hóa đơn và chi tiết thanh toán.
5. Sự kiện Webhook: Lắng nghe trạng thái hoàn tất.
6. Mã lỗi: Danh sách đầy đủ mã lỗi API và ý nghĩa.
7. Giới hạn tần suất: Chính sách giới hạn và điều tiết request.
8. Ví dụ mã nguồn: Mẫu tích hợp sẵn sàng sử dụng.