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ứcChức năng
POST /api/v1/paymentsTạ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/walletSố 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 page

Webhook 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.

Liên quan