Thông tin chung

Chào mừng bạn đến với tài liệu API của 2328.io. Tài liệu tham chiếu này mô tả cách tích hợp xử lý thanh toán và rút tiền điện tử vào ứng dụng của bạn.

Bắt đầu

Để bắt đầu tích hợp:

1. Tạo tài khoản merchant và project tại 2328.io
2. Lấy project UUID và API key từ phần cài đặt project
3. Tạo riêng một Payout API key nếu bạn dự định sử dụng tính năng rút tiền
4. Đọc phần Authentication để tìm hiểu cách ký yêu cầu
5. Thực hiện cuộc gọi Create Payment đầu tiên

Base URL

Tất cả yêu cầu API trong môi trường production đều sử dụng base URL sau:

https://api.2328.io/api

Bạn có thể làm gì

Với 2328.io API bạn có thể:

• Nhận thanh toán bằng tiền điện tử — tạo phiên thanh toán và chuyển hướng khách hàng đến trang checkout được hosted hoặc Telegram MiniApp
• Rút tiền — gửi rút tiền theo chương trình từ số dư merchant đến bất kỳ địa chỉ blockchain nào
• Kiểm tra số dư — xem số dư tài khoản merchant theo từng tiền tệ, giá trị tương đương USD và số tiền bị khóa do AML
• Sử dụng ví tĩnh — tạo địa chỉ nạp tiền vĩnh viễn gắn với một người dùng hoặc đơn hàng
• Lấy tỷ giá — lấy tỷ giá theo thời gian thực cho các cặp tiền pháp định và tiền điện tử
• Nhận webhook — được thông báo ngay lập tức khi trạng thái thanh toán thay đổi

Giới hạn tần suất

API cho phép tối đa 10 yêu cầu mỗi giây cho mỗi project. Các yêu cầu vượt quá giới hạn sẽ nhận phản hồi HTTP 429 Too Many Requests — hãy chờ một chút (back off) và thử lại.