นักพัฒนา
สร้างใบแจ้งหนี้
คำขอ POST หนึ่งครั้งสร้างใบแจ้งหนี้และคืนลิงก์ไปยังหน้าชำระเงิน ลูกค้าเลือกเหรียญและเครือข่ายที่นั่น
คำขอ
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"}'| ฟิลด์ | ความหมาย |
|---|---|
amount | จำเป็น ตัวเลขตั้งแต่ 0.01 มียอดขั้นต่ำเป็น USDT เพราะค่าธรรมเนียมเครือข่ายต้องไม่เกินยอดใบแจ้งหนี้เมื่อร้านค้าเป็นผู้จ่าย: เรียก GET /api/payments/quote เพื่อดูยอดขั้นต่ำปัจจุบัน |
currency | จำเป็น สกุลเงินเฟียต (RUB, USD, EUR, CNY, GBP, CHF, JPY, KZT และสกุลเงินหลักอื่น ๆ) หรือ USDT/USDC ยอดจะถูกแปลงตามอัตราสด |
order_id | order id ของคุณเอง ไม่เกิน 80 ตัวอักษร หากเว้นว่าง CryBit จะสร้าง CB-… ให้ |
purpose | คำอธิบาย ไม่เกิน 240 ตัวอักษร |
ttl_minutes | อายุตั้งแต่ 5 ถึง 1440 นาที ค่าเริ่มต้น 30 |
return_url | ที่ที่ลูกค้ากลับไปหลังชำระเงิน (http หรือ https ไม่เกิน 500 ตัวอักษร) หากไม่ระบุจะใช้ return URL ของร้านค้า |
crypto, network | ไม่บังคับ ส่งทั้งสองค่าเพื่อรับที่อยู่ จำนวนเงิน และ QR code ในผลลัพธ์ทันที เช่น USDT และ TRC-20 |
confirmation | ไม่บังคับ {"type":"embedded"} สำหรับวิดเจ็ตแบบฝัง โทเคนจะอยู่ในผลลัพธ์เสมอ |
ผลลัพธ์
ผลลัพธ์เป็น 201 พร้อมออบเจ็กต์ใบแจ้งหนี้ ส่งลูกค้าไปที่ callback_url (หน้าชำระเงิน) หากไม่ระบุ crypto และ network ค่า needs_method จะเป็น true และลูกค้าเลือกในหน้านั้น
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"
}สถานะ
GET /api/v1/payments/{uuid} คืนออบเจ็กต์เดียวกัน สถานะคือ waiting, paid, expired หรือ cancelled หลังจากลูกค้าเลือกเครือข่าย ออบเจ็กต์จะมี crypto, network, address และค่าธรรมเนียม หลังชำระจะมี status paid, txid และ paid_at ใบแจ้งหนี้ waiting ที่เกินอายุจะกลายเป็น expired เมื่อคุณเรียกดู fee_payer เป็น shop เมื่อร้านค้าจ่ายค่าธรรมเนียม และเป็น buyer เมื่อยอดที่ต้องชำระรวมค่าธรรมเนียมไว้แล้ว
FAQ
ต้องส่ง header อะไรบ้าง?
X-Public-Key และ X-Private-Key ต้องมีทั้งสอง หากคีย์ส่วนตัวหายไป ผิด หรือหมดอายุ จะได้รับ 401
มีการจำกัดอัตราไหม?
60 คำขอต่อนาทีต่อคีย์