Hướng dẫn tích hợp nhanh

Thực hiện theo bốn bước sau để tích hợp liền mạch cổng thanh toán tiền điện tử BoltUtil vào logic kinh doanh hiện tại của bạn.

1

Khởi tạo Backend: Tạo đơn hàng

Backend

Gọi điểm cuối /api/v1/orders/create. Cổng thanh toán của chúng tôi sẽ ánh xạ địa chỉ người nhận đã cấu hình trước đó của bạn với giao dịch cụ thể.

Mẹo bảo mật: Đảm bảo X-Bolt-Key và chữ ký được bao gồm trong HTTP Header.
2

Hướng dẫn Frontend: Giao diện thanh toán

Frontend

Sử dụng checkoutUrl từ phản hồi để chuyển hướng người dùng đến trang thanh toán tối giản của chúng tôi hoặc hiển thị mã QR trực tiếp. Người dùng sẽ chuyển tiền từ ví cá nhân của họ trực tiếp đến địa chỉ độc quyền của bạn.

Hoàn toàn tương thích với TRON (TRC20) và các ví phổ biến có hỗ trợ gọi ứng dụng (App-invocation) gốc.
3

Đẩy tin hệ thống: Lắng nghe Callback

Webhook

Các cụm nút (node clusters) của chúng tôi giám sát sổ cái blockchain theo thời gian thực. Sau khi phát hiện xác nhận giao dịch, hệ thống sẽ gửi ngay yêu cầu POST đến notifyUrl của bạn với đầy đủ chi tiết thanh toán, bao gồm cả txHash.

Để xử lý sự biến động của mạng, hãy đảm bảo điểm cuối của bạn triển khai tính lũy đẳng (idempotency) để xử lý an toàn các thông báo trùng lặp có thể xảy ra.
4

Hoàn tất nghiệp vụ: Xác minh & Giao hàng

Backend

Khi nhận được Webhook, hãy xác minh nguồn dữ liệu bằng thuật toán chữ ký của chúng tôi. Sau khi số tiền callback khớp với đơn hàng, hãy cập nhật trạng thái hệ thống và hoàn tất việc giao hàng cho người dùng.

Zero Trust: Không bao giờ hoàn tất đơn hàng nếu chưa xác minh chữ ký HMAC thành công và khớp số tiền.