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

Kết nối thanh toán stablecoin (USDT / USDC) theo bốn bước. Trước tiên, hãy định cấu hình Khóa API, bí mật Webhook và nhận ví cho các mạng được kích hoạt. Ví dụ bên phải kiểm tra Khóa API của bạn.

1

Tạo lệnh thanh toán

Phần phụ trợ của bạn

Gọi /api/v1/order/create từ chương trình phụ trợ của bạn với giá, đơn vị tiền tệ, mạng và đơn đặt hàng của người bán ID. Phản hồi chứa ví được định cấu hình của bạn và số tiền phải trả cuối cùng; nhiều đơn hàng có thể dùng chung một ví.

GET /api/v1/ping kiểm tra Khóa API của bạn. Việc tạo đơn hàng cũng cần có timestamp và chữ ký yêu cầu.
2

Hiển thị chi tiết thanh toán

Giao diện người dùng của bạn

Mở checkoutUrl từ phản hồi hoặc hiển thị số tiền, địa chỉ, mạng và loại tiền từ đối tượng payment. Tiền chuyển trực tiếp vào ví nhận đã cấu hình.

Sử dụng payment.amount hoàn chỉnh. payment.qrData chứa QR data, không phải hình ảnh.
3

Đợi xác nhận thanh toán

BoltUtil

BoltUtil khớp các giao dịch chuyển tiền theo mạng, tiền tệ, ví và số tiền, sau đó gửi thông báo đến notifyUrl được liên kết khi đáp ứng các yêu cầu xác nhận. Các trường hợp ngoại lệ thanh toán đủ điều kiện cần có sự xem xét của người bán.

Việc xác nhận và phân phối phụ thuộc vào điều kiện mạng và chuỗi khối. Việc chuyển hướng trang không chứng minh được khoản thanh toán.
4

Xác minh và thực hiện

Phần phụ trợ của bạn

Xác minh chữ ký của nội dung gốc và dấu thời gian, rồi liên kết sự kiện với đơn hàng. Kiểm tra số tiền phải trả, số tiền thực trả và loại quyết toán. Trả HTTP 2xx sau khi lưu sự kiện bền vững và không giao lại cùng một đơn hàng.

Nhận diện sự kiện trùng lặp bằng eventId và không giao cùng một đơn hàng nhiều lần. Khi chấp nhận thủ công khoản thanh toán thiếu, số tiền thực trả có thể thấp hơn số tiền phải trả.

Mạng và tiền tệ

Kiểm tra các loại tiền tệ được hỗ trợ, phiên bản mã thông báo và quy tắc xác nhận thanh toán.

Xem các mạng được hỗ trợ →