Nhà phát triển
Tạo hóa đơn
Một yêu cầu POST tạo hóa đơn và trả về liên kết đến trang thanh toán. Khách hàng chọn coin và mạng tại đó.
Yêu cầu
curl
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"}'| Trường | Ý nghĩa |
|---|---|
amount | Bắt buộc. Một số từ 0.01. Có mức tối thiểu tính bằng USDT vì phí mạng không được vượt quá số tiền hóa đơn khi merchant là bên trả phí: hãy gọi GET /api/payments/quote để biết mức tối thiểu hiện tại. |
currency | Bắt buộc. Tiền pháp định (RUB, USD, EUR, CNY, GBP, CHF, JPY, KZT và các loại tiền chính khác) hoặc USDT/USDC. Số tiền được quy đổi theo tỷ giá thời gian thực. |
order_id | order id của riêng bạn, tối đa 80 ký tự. Nếu để trống, CryBit tự tạo CB-…. |
purpose | Mô tả, tối đa 240 ký tự. |
ttl_minutes | Thời hạn từ 5 đến 1440 phút, mặc định 30. |
return_url | Nơi khách hàng quay lại sau khi thanh toán (http hoặc https, tối đa 500 ký tự). Nếu không có, dùng URL quay lại của merchant. |
crypto, network | Tùy chọn. Truyền cả hai để nhận ngay địa chỉ, số tiền và mã QR trong phản hồi, ví dụ USDT và TRC-20. |
confirmation | Tùy chọn. {"type":"embedded"} cho widget nhúng. Token luôn có trong phản hồi. |
Phản hồi
Phản hồi là 201 kèm đối tượng hóa đơn. Chuyển khách hàng đến callback_url (trang thanh toán). Nếu không có crypto và network, needs_method là true và khách hàng chọn trên trang đó.
JSON
{
"uuid": "28d0ff38-949c-435e-ad41-c81c219b3597",
"order_id": "ORD-1048",
"amount": 1490,
"currency": "RUB",
"status": "waiting",
"sandbox": true,
"needs_method": true,
"callback_url": "https://pay.crybit.net/28d0ff38-949c-435e-ad41-c81c219b3597",
"confirmation": { "type": "embedded", "confirmation_token": "28d0ff38-…", "widget_url": "https://pay.crybit.net/widget.js" },
"expires_at": "2026-09-21T13:41:42+00:00"
}Trạng thái
GET /api/v1/payments/{uuid} trả về cùng đối tượng đó. Trạng thái là waiting, paid, expired hoặc cancelled. Sau khi khách hàng chọn mạng, đối tượng có crypto, network, address và phí; sau khi thanh toán có status paid, txid và paid_at. Hóa đơn waiting quá thời hạn sẽ chuyển thành expired khi bạn truy vấn. fee_payer là shop khi merchant trả phí và buyer khi số tiền cần thanh toán đã bao gồm phí.
FAQ
Tôi cần gửi những header nào?
X-Public-Key và X-Private-Key, cả hai đều bắt buộc. Khóa riêng thiếu, sai hoặc cũ sẽ trả về 401.
Có giới hạn tần suất không?
60 yêu cầu mỗi phút cho mỗi khóa.