นักพัฒนา

วิดเจ็ตแบบฝัง

ลูกค้าชำระเงินโดยไม่ต้องออกจากโดเมนของคุณ คุณสร้างใบแจ้งหนี้ผ่าน 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.modaltrue สำหรับป๊อปอัปแทนคอนเทนเนอร์
error_callback, success_callbackถูกเรียกเมื่อเกิดข้อผิดพลาด (ไม่มีโทเคน ไม่มีคอนเทนเนอร์) และเมื่อสถานะเป็น paid

เหตุการณ์: ready, status, success, fail, complete, close, error เมธอด: render(id), on(event, fn), destroy()

ยืนยันคำสั่งซื้อด้วย webhook หรือด้วยการอ่านสถานะ เหตุการณ์ของวิดเจ็ตใช้สำหรับส่วนติดต่อผู้ใช้เท่านั้น

FAQ

ทดสอบวิดเจ็ตได้ไหม?

ได้ ในร้านค้าทดสอบ วิดเจ็ตจะแสดงปุ่มสำหรับทำเครื่องหมายใบแจ้งหนี้ว่าชำระแล้ว และยอดคงเหลือจะไม่ถูกเครดิต

เพิ่มเติม

รับ API key