Nhà phát triển
API thanh toán tiền điện tử
Ba lệnh gọi: tạo hóa đơn, đọc trạng thái, đọc số dư. Khách hàng thanh toán trên trang thanh toán và bạn nhận webhook cùng USDT.
Endpoint
| Phương thức | Chức năng |
|---|---|
POST /api/v1/payments | Tạo hóa đơn và nhận liên kết trang thanh toán |
GET /api/v1/payments/{uuid} | Trạng thái, địa chỉ và mã giao dịch |
GET /api/v1/wallet | Số dư USDT khả dụng và bị đóng băng |
Base URL: https://api.crybit.net · JSON · 60 yêu cầu mỗi phút · xác thực: header X-Public-Key và X-Private-Key.
Tạo hóa đơn
Chỉ có amount và currency là trường bắt buộc. Truyền order_id của riêng bạn để đối chiếu khoản thanh toán với đơn hàng, và ttl_minutes để đặt thời hạn.
curl -X POST https://api.crybit.net/api/v1/payments \
-H "X-Public-Key: pk_…" \
-H "X-Private-Key: sk_…" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"amount":1490,"currency":"RUB","order_id":"ORD-1048","purpose":"Order 1048"}'JavaScript
const invoice = await fetch('https://api.crybit.net/api/v1/payments', {
method: 'POST',
headers: {
'X-Public-Key': 'pk_…',
'X-Private-Key': 'sk_…',
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({ amount: 1490, currency: 'RUB', order_id: 'ORD-1048' }),
}).then((r) => r.json())
location.href = invoice.callback_url // the payment pageWebhook và widget
Khi hóa đơn được thanh toán, CryBit gọi URL webhook của merchant để bạn giao đơn hàng. Để giữ khách hàng trên website của bạn, hãy yêu cầu confirmation type embedded và mở biểu mẫu thanh toán bằng script widget.
Tham chiếu
FAQ
Xác thực như thế nào?
Gửi khóa công khai trong X-Public-Key và khóa riêng trong X-Private-Key. Cả hai header đều bắt buộc. Merchant được nhận diện qua khóa công khai nên không cần mã cửa hàng trong yêu cầu.
Có chế độ thử nghiệm không?
Có. Merchant ở chế độ thử nghiệm tạo hóa đơn sandbox: trang thanh toán có nút đánh dấu đã thanh toán, và các hóa đơn này không làm thay đổi số dư của bạn. Chuyển merchant sang chế độ hoạt động để nhận giao dịch thật.
Giới hạn là gì?
API chấp nhận 60 yêu cầu mỗi phút cho mỗi khóa. Số tiền hóa đơn tối thiểu từ 0.01 và thời hạn từ 5 đến 1440 phút.
