การชำระเงินและยอดคงเหลือ

GetMyBot มีสองวงจร «การชำระเงิน» ที่แตกต่างกัน: ยอดคำร้อง ของแพลตฟอร์ม (สำหรับการทำงานของบอท) และ การรับการชำระเงินจากผู้ใช้ ของบอทผ่าน Telegram ส่วน การเรียกเก็บเงิน (เรียกอีกว่า «การรับการชำระเงิน») จัดการแพ็กเกจและยอดคงเหลือ

วิธีคำนวณค่าใช้จ่ายของบอท

แพลตฟอร์มนับการทำงานเป็น คำร้อง: ข้อความที่บอทส่งสำเร็จแต่ละครั้งจะหักหนึ่งคำร้องจากยอดคงเหลือของบัญชี ยอดคงเหลือคือตัวนับจำนวนเต็ม โดยแหล่งข้อมูลที่แท้จริงคือบันทึกการเครดิตและการหักที่ไม่เปลี่ยนแปลง (โบนัสเมื่อลงทะเบียน, การเครดิตแพ็กเกจ, การเติมยอด, การใช้จ่าย)

แพ็กเกจและยอดคงเหลือ

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

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

บันทึกการเครดิต (Ledger)

ยอดคำร้องคือตัวนับจำนวนเต็ม แต่ แหล่งข้อมูลที่แท้จริง ของมันคือบันทึกการดำเนินการที่ไม่เปลี่ยนแปลง (Ledger) ทุกการเปลี่ยนแปลงยอดคงเหลือถูกบันทึกที่นั่น:

  • โบนัสเมื่อลงทะเบียน — ปริมาณคำร้องเริ่มต้นสำหรับบัญชีใหม่
  • การเครดิตแพ็กเกจ — คำร้องที่ได้รับเมื่อสมัครแพ็กเกจ
  • การเติมยอด — คำร้องที่ซื้อเพิ่ม
  • การใช้จ่าย — การหักหนึ่งคำร้องสำหรับข้อความที่บอทส่งสำเร็จแต่ละครั้ง

บันทึกเพียงแต่เพิ่ม (ระเบียนเก่าไม่เปลี่ยน) ดังนั้นประวัติการใช้จ่ายและการเครดิตสามารถตรวจสอบย้อนหลังได้เสมอ ยอดคงเหลือปัจจุบันคือผลรวมของบันทึก

การเติมยอด

การเติมยอดสร้างการชำระเงินสำหรับปริมาณคำร้องที่ต้องการ หลังจากผู้ให้บริการยืนยัน ยอดคงเหลือจะถูกเครดิตโดยอัตโนมัติและแบบ Idempotent (Callback ซ้ำจะไม่เครดิตซ้ำ) ผู้ให้บริการการชำระเงินเฉพาะขึ้นอยู่กับการกำหนดค่าของ Instance

การรับการชำระเงินจากผู้ใช้ (Telegram Payments)

บอทสามารถ รับและบันทึก การชำระเงิน Telegram ได้:

  • คำร้อง pre_checkout_query ได้รับการยืนยันโดยอัตโนมัติ
  • การชำระเงินที่สำเร็จ (successful_payment) ถูกบันทึก (จำนวน, สกุลเงิน, ID ธุรกรรม, Payload) จากนั้นสามารถเรียกใช้รีแอคชัน — เช่น มอบสิทธิ์เข้าถึง, ตั้งป้ายกำกับ «ชำระเงิน» และบันทึกออร์เดอร์ใน คอลเลกชัน

ยอดรวมการชำระเงินที่สำเร็จสามารถดูได้ใน การวิเคราะห์ («การชำระเงิน»)

การออกใบแจ้งหนี้ (sendInvoice) และปุ่ม «รับการชำระเงิน» / «การแจ้งเตือน» ใน Builder ปุ่มอยู่ในสถานะ «เร็วๆ นี้»: บอทบันทึกการชำระเงินขาเข้า แต่ปัจจุบันยังไม่สามารถเริ่มต้นออกใบแจ้งหนี้จากรีแอคชันได้

ขั้นตอนถัดไป