วารสาร
API รับชำระเงินคริปโตใน 3 คำสั่ง: สร้าง invoice เช็คสถานะ และดูยอดคงเหลือ
API สำหรับร้านค้าของ CryBit อธิบายแบบเข้าใจง่าย ตั้งแต่การยืนยันตัวตน ฟิลด์ต่าง ๆ ของใบแจ้งหนี้ สถานะ โหมดทดสอบ ไปจนถึงสิ่งที่ต้องทำเมื่อลูกค้าชำระเงินแล้ว
API สำหรับร้านค้ามีสามเมธอดหลัก คือสร้างใบแจ้งหนี้ อ่านสถานะของใบแจ้งหนี้ และอ่านยอดคงเหลือของคุณ ลูกค้าจะชำระเงินบนหน้าชำระเงิน ส่วนคุณจะรู้ผลผ่าน webhook หรือด้วยการเรียกขอสถานะ
การยืนยันตัวตน
ทุกคำขอต้องแนบสองเฮดเดอร์คือ X-Public-Key และ X-Private-Key คีย์สาธารณะใช้ระบุร้านค้า คุณจึงไม่ต้องส่ง shop id แนบมาในบอดี้อีก ส่วนคีย์ส่วนตัวจะแสดงให้เห็นเพียงครั้งเดียวตอนออกคีย์ หากทำหาย ให้ออกคีย์ใหม่ทันที คีย์เก่าจะใช้งานไม่ได้ทันที ลิมิตอยู่ที่ 60 คำขอต่อนาที
การสร้างใบแจ้งหนี้
ส่งคำขอ POST /api/v1/payments พร้อม amount และ currency โดยยอดขั้นต่ำเริ่มที่ 0.01 ส่วน currency เลือกได้ทั้งสกุลเงินฟิอาต เช่น RUB, USD, EUR, CNY, GBP, CHF, JPY หรือ KZT หรือจะเป็น USDT และ USDC ก็ได้ ฟิลด์เสริมที่มีประโยชน์ได้แก่ order_id (เลขออเดอร์ของคุณเอง ยาวได้ถึง 80 ตัวอักษร) purpose (คำอธิบายรายการ) ttl_minutes (อายุใบแจ้งหนี้ ตั้งได้ตั้งแต่ 5 ถึง 1440 นาที ค่าเริ่มต้นคือ 30) return_url (หน้าที่จะพาลูกค้ากลับไปหลังชำระเงิน) และ crypto คู่กับ network หากคุณรู้อยู่แล้วว่าลูกค้าจะจ่ายด้วยอะไร
คำตอบที่ได้กลับมาจะมีลิงก์หน้าชำระเงินอยู่ใน callback_url ให้ส่งลูกค้าไปที่ลิงก์นั้น หากคุณระบุ crypto และ network มาด้วย คำตอบจะมีที่อยู่ ยอดที่ต้องโอน และ QR โค้ดมาให้ด้วยเลย
สถานะต่าง ๆ
ใบแจ้งหนี้มีสถานะเป็น waiting, paid, expired หรือ cancelled หลังลูกค้าเลือกเครือข่ายแล้ว ออบเจกต์จะมีที่อยู่ เหรียญ และค่าธรรมเนียมเพิ่มเข้ามา และเมื่อชำระเงินสำเร็จจะมีสถานะ paid พร้อมหมายเลขธุรกรรมและเวลาที่ชำระ ใบแจ้งหนี้ที่ยังเป็น waiting แต่หมดอายุแล้วจะเปลี่ยนเป็น expired ในครั้งถัดไปที่คุณเรียกดู
ยอดคงเหลือ
GET /api/v1/wallet จะคืนค่ายอด USDT ที่ใช้ได้และยอดที่ถูกอายัดไว้ ยอดคงเหลือมีเพียงชุดเดียวสำหรับทุกร้านค้าในบัญชี และการชำระเงินในโหมดทดสอบจะไม่มีผลกับยอดนี้เลย
ทดสอบก่อนใช้งานจริง
ร้านค้าที่อยู่ในโหมดทดสอบจะสร้างใบแจ้งหนี้แบบทดสอบ (sandbox) หน้าชำระเงินจะมีปุ่มสำหรับกดทำเครื่องหมายว่าชำระแล้ว โดยยอดคงเหลือจริงจะไม่ถูกเติมเข้ามา เมื่อพร้อมแล้วให้เปลี่ยนร้านค้าเป็นโหมดใช้งานจริงเพื่อรับการโอนเงินจริง
เอกสารอ้างอิงฉบับเต็มพร้อมตัวอย่างโค้ดใน curl, JavaScript และ PHP อยู่ที่หน้าสำหรับนักพัฒนา
รับคริปโต ได้รับ USDT
สร้างร้านค้า ออกใบแจ้งหนี้ ลองโหมดทดสอบ การรับชำระจริงเปิดหลังการตรวจสอบ