นักพัฒนา
วิดเจ็ตแบบฝัง
ลูกค้าชำระเงินโดยไม่ต้องออกจากโดเมนของคุณ คุณสร้างใบแจ้งหนี้ผ่าน API และแสดงฟอร์มชำระเงินของ CryBit บนหน้าของคุณเอง
1. สร้างใบแจ้งหนี้
ใช้ POST /api/v1/payments เดิม ผลลัพธ์จะมี confirmation.confirmation_token เสมอ ซึ่งเท่ากับ uuid ของใบแจ้งหนี้ ฟิลด์ confirmation ในคำขอเป็นแบบไม่บังคับ
2. โหลดสคริปต์และเพิ่มคอนเทนเนอร์
HTML
<script src="https://pay.crybit.net/widget.js"></script>
<div id="payment-form"></div>3. แสดงฟอร์ม
JavaScript
const checkout = new CryBitCheckout({
confirmation_token: 'INVOICE-UUID',
return_url: 'https://merchant.example/thanks',
lang: 'en',
error_callback: (err) => console.log(err),
})
checkout.render('payment-form').then(() => { /* the form is shown */ })
checkout.on('success', () => { /* status paid: confirm the order by webhook or GET */ })
checkout.on('fail', () => { /* expired, cancelled or refunded */ })
checkout.on('complete', () => checkout.destroy())หน้าต่างโมดัล
หากไม่มีคอนเทนเนอร์ในหน้า ให้เปิดวิดเจ็ตทับเว็บไซต์ด้วย customization: { modal: true } (หรือ modal: true) และเรียก checkout.render() โดยไม่ใส่อาร์กิวเมนต์
ตัวเลือกและเหตุการณ์
| ตัวเลือก | ความหมาย |
|---|---|
confirmation_token | จำเป็น uuid ของใบแจ้งหนี้ (alias: uuid, invoice_uuid) |
return_url | ที่ที่ลูกค้าไปหลังชำระเงิน |
lang | ภาษาของอินเทอร์เฟซ หากไม่ระบุจะใช้ภาษาของเบราว์เซอร์ |
modal / customization.modal | true สำหรับป๊อปอัปแทนคอนเทนเนอร์ |
error_callback, success_callback | ถูกเรียกเมื่อเกิดข้อผิดพลาด (ไม่มีโทเคน ไม่มีคอนเทนเนอร์) และเมื่อสถานะเป็น paid |
เหตุการณ์: ready, status, success, fail, complete, close, error เมธอด: render(id), on(event, fn), destroy()
ยืนยันคำสั่งซื้อด้วย webhook หรือด้วยการอ่านสถานะ เหตุการณ์ของวิดเจ็ตใช้สำหรับส่วนติดต่อผู้ใช้เท่านั้น
FAQ
ทดสอบวิดเจ็ตได้ไหม?
ได้ ในร้านค้าทดสอบ วิดเจ็ตจะแสดงปุ่มสำหรับทำเครื่องหมายใบแจ้งหนี้ว่าชำระแล้ว และยอดคงเหลือจะไม่ถูกเครดิต
