Bắt đầu nhanh

Hướng dẫn tích hợp thanh toán PayerScan từng bước cho nền tảng của bạn.

Bước 1: Tạo tài khoản

Truy cập Trang đăng ký để tạo tài khoản Merchant mới trên hệ thống PayerScan.

Bước 2: Tạo Store

Sau khi đăng nhập, tạo Store mới trong Merchant Dashboard để bắt đầu nhận thanh toán.

1. Ở thanh bên, nhấn API Crypto để mở danh sách Store.
2. Nhấn nút + Create Store.
3. Điền thông tin Store và nhấn Create.

📖 Xem hướng dẫn chi tiết tại Tạo Store.

Bước 3: Lấy Merchant ID & API Key

Sau khi tạo Store, bạn sẽ thấy Merchant ID và API Key trong danh sách Store.

• Merchant ID — Mã định danh Store duy nhất (ví dụ: MID-XXXXXXXXXX). Sử dụng trong các lệnh gọi API.
• API Key — Dùng để xác thực các yêu cầu API. Nhấn biểu tượng sao chép để copy.

cảnh báo

Giữ API Key an toàn. Không để lộ trong mã nguồn phía client hoặc repository công khai.

Bước 4: Cấu hình địa chỉ ví

Trước khi tạo hoá đơn, hãy thêm địa chỉ ví để nhận thanh toán tiền mã hóa:

• Thêm địa chỉ ví nhận token TRC20/BEP20/...
• Bạn có thể thêm nhiều địa chỉ cho cùng một loại coin và network.

📖 Xem hướng dẫn chi tiết tại Thêm ví.

mẹo

Nếu bạn muốn nhận thanh toán qua Binance Pay, xem Thiết lập Binance Pay.

Bước 5: Thiết lập logic Backend

Thiết lập logic backend của bạn để xử lý hai phần chính: tạo hóa đơn và xử lý webhook.

5.1 — API Tạo hóa đơn

Gọi API Tạo hóa đơn để tạo đường link thanh toán:

curl -X POST "https://api.payerscan.com/payment/crypto" \
     -H "Content-Type: application/json" \
     -H "x-api-key: YOUR_API_KEY" \
     -d '{
        "merchant_id": "MID-XXXXXXXXXX",
        "amount": 100,
        "name": "Order #123456",
        "description": "Payment for shop order",
        "callback_url": "https://your-server.com/webhook/payment",
        "completed_url": "https://your-website.com/thank-you",
        "expired_url": "https://your-website.com/",
        "request_id": "ORDER_123456"
     }'

Tiếp theo, chuyển hướng người dùng tới đường link url_payment được tạo ra trong response.

5.2 — Theo dõi trạng thái thanh toán

Có 2 phương án để theo dõi trạng thái thanh toán hóa đơn:

• Webhook (⭐ Khuyến nghị): PayerScan tự động gửi POST request tới callback_url của bạn khi hóa đơn được thanh toán hoặc hết hạn. Đây là phương thức push theo thời gian thực — server của bạn nhận thông báo ngay lập tức mà không cần polling. Bạn chỉ cần expose một endpoint public và xử lý payload nhận được.

  📖 Xem hướng dẫn chi tiết tại Hướng dẫn Webhook.

• Get Invoice API: Nếu bạn muốn dùng phương thức pull, bạn có thể gọi API Get Invoice để kiểm tra trạng thái hiện tại của bất kỳ hóa đơn nào bất cứ lúc nào bằng trans_id. Hữu ích cho việc kiểm tra trạng thái theo yêu cầu, đối soát đơn hàng, hoặc dùng dự phòng khi webhook bị trễ.

  📖 Xem hướng dẫn chi tiết tại Get Invoice.

Bước 6: Tạo hóa đơn đầu tiên

Khi backend đã sẵn sàng, hãy tạo hóa đơn đầu tiên để kiểm tra toàn bộ luồng thanh toán. Xác minh rằng:

• Trang thanh toán hiển thị chính xác qua đường link url_payment.
• Webhook endpoint nhận đúng callback khi thanh toán hoàn tất hoặc hết hạn.
• Hệ thống của bạn cập nhật trạng thái đơn hàng tương ứng.