ปุ่มชำระเงิน

ปุ่มที่มีฟังก์ชันการชำระเงินช่วยให้การทำงานกับระบบชำระเงินที่เชื่อมต่ออยู่ง่ายขึ้น โดยการให้ลิงก์ชำระเงิน

รูปภาพ

โปรดทราบว่าในแอปส่งข้อความหลายแอป ลิงก์สามารถวางได้เฉพาะในปุ่มอินไลน์ภายในข้อความเท่านั้น อย่าลืมเลือกประเภทปุ่มที่เหมาะสมในการตั้งค่าบล็อกหลังจากสร้างปุ่ม

ปุ่มฟังก์ชันการชำระเงินพร้อมใช้งานสำหรับระบบชำระเงินต่อไปนี้:

• Stripe

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

หากไม่มีระบบชำระเงินใดเชื่อมต่อกับโปรเจกต์ ปุ่มประเภทนี้จะไม่สามารถใช้งานได้

รูปภาพ

ฟิลด์หลักของปุ่มชำระเงิน:

• ฟิลด์ข้อความ: ข้อความนี้จะปรากฏบนปุ่มพร้อมลิงก์ชำระเงินในข้อความ
• ฟังก์ชัน: เลือกประเภทปุ่ม ชำระเงิน
• ฟิลด์ฟังก์ชัน: หากต้องการสร้างปุ่มที่ให้ลิงก์ชำระเงิน ให้เลือกฟังก์ชัน ชำระเงิน
• ฟิลด์ระบบชำระเงิน: รายการจะแสดงระบบชำระเงินที่เชื่อมต่อกับโปรเจกต์

ขึ้นอยู่กับระบบชำระเงินที่เลือก ฟิลด์ที่จำเป็นสำหรับการสร้างลิงก์และการสร้างใบเสร็จจะแตกต่างกันไป

คุณสามารถดูการตั้งค่าสำหรับปุ่มฟังก์ชันการชำระเงินสำหรับระบบชำระเงินต่างๆ ได้ที่นี่:

ฟิลด์ที่จำเป็นสำหรับการสร้างลิงก์ชำระเงิน คือ จำนวนเงิน และ ชื่อผลิตภัณฑ์/คำอธิบายผลิตภัณฑ์

• ฟิลด์จำนวนเงิน: ป้อนจำนวนเงินที่ต้องชำระที่นี่
• ฟิลด์ชื่อผลิตภัณฑ์: ป้อนชื่อผลิตภัณฑ์ที่จะแสดงบนหน้าชำระเงิน

ไม่สามารถใช้เครื่องหมายคำพูดคู่ในชื่อผลิตภัณฑ์

คุณสามารถแทนที่ด้วยเครื่องหมายอะพอสทรอฟีหรือเครื่องหมายคำพูดเดี่ยว

ขึ้นอยู่กับระบบชำระเงินที่เลือก เมนูแบบเลื่อนลงที่มีป้ายกำกับ "ข้อมูลใบเสร็จ" และ/หรือ "ข้อมูลเพิ่มเติม" จะปรากฏในการตั้งค่าปุ่ม การคลิกที่เมนูเหล่านี้จะแสดงฟิลด์เพิ่มเติม:

รูปภาพ

ตัวแปรเมื่อใช้ปุ่มฟังก์ชันการชำระเงิน

ทันทีที่ผู้ใช้ได้รับบล็อกที่มีปุ่ม "ชำระเงิน" ตัวแปรไคลเอนต์ต่อไปนี้จะถูกสร้างขึ้นโดยอัตโนมัติ:

• ตัวแปรไคลเอนต์ระบบ __payments – ตัวแปรนี้เก็บจำนวนเงินที่ชำระและตัวระบุของลิงก์ชำระเงินที่สร้างขึ้น ใช้เพื่อระบุการตอบกลับ webhook จากระบบชำระเงิน

ตัวแปรไคลเอนต์ระบบ __payments ต้องไม่ถูกลบหรือแก้ไข!

ตัวแปรไคลเอนต์ error_payment_button จะถูกสร้างขึ้นหากเกิดข้อผิดพลาดขณะสร้างปุ่มชำระเงิน

ค่าของมันจะประกอบด้วยข้อความแสดงข้อผิดพลาดหรือการตอบกลับข้อผิดพลาดที่ส่งคืนโดยระบบชำระเงิน

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

วิธีจัดการกับผลลัพธ์

การชำระเงินสำเร็จ

หลังจากการชำระเงินสำเร็จ บอทจะได้รับ callback ที่ประกอบด้วยอักขระ 10 ตัวแรกของคีย์ลับของระบบชำระเงิน คำว่า _success และจำนวนเงินที่ชำระ โดยคั่นด้วยช่องว่าง ตัวอย่าง: ovg58keefc_success 44 โดยที่:

• ovg58keefc: อักขระ 10 ตัวแรกของคีย์ลับของระบบชำระเงิน
• _success: ระบุผลลัพธ์ของคำขอ (การชำระเงินสำเร็จ)
• 44: จำนวนเงินที่ชำระ

Callbacks (การแจ้งเตือน) จากระบบชำระเงิน ไม่ปรากฏให้ผู้ใช้เห็น จะแสดงเฉพาะในแท็บ ลูกค้า และมองเห็นได้เฉพาะ ผู้ปฏิบัติงาน เท่านั้น

ตัวอย่างการใช้งาน: ขั้นตอนที่ 1. ในบล็อกที่มีปุ่ม ชำระเงิน ให้เพิ่มปุ่มที่มีฟังก์ชัน ชำระเงิน ขั้นตอนที่ 2. ในฟิลด์ เงื่อนไขการเชื่อมต่อ จากบล็อกนี้ไปยังบล็อก การชำระเงินสำเร็จ ให้ระบุ callback วิธีนี้ทำงานเหมือนกันหากคุณระบุ callback การชำระเงินสำเร็จในฟิลด์ เงื่อนไข ของบล็อก ตรวจสอบเงื่อนไขหลัก

หมายเหตุ! การเลือกประเภทการจับคู่ — จับคู่แบบตรงทั้งหมด หรือ จับคู่คำสำคัญ

เคล็ดลับที่เป็นประโยชน์

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

การชำระเงินที่มีข้อผิดพลาด

หาก เกิดข้อผิดพลาดในการชำระเงิน บอทจะได้รับ callback ที่ประกอบด้วยอักขระ 10 ตัวแรกของคีย์ลับของระบบชำระเงิน คำว่า _fail และจำนวนเงินที่ชำระ โดยคั่นด้วยช่องว่าง ตัวอย่าง: ovg58keefc_fail 44 โดยที่:

• ovg58keefc: อักขระ 10 ตัวแรกของคีย์ลับของระบบชำระเงิน
• _fail: ผลลัพธ์ของการประมวลผลคำขอ — การชำระเงินล้มเหลวหรือพบข้อผิดพลาด
• 44: จำนวนเงินที่ชำระ

ขึ้นอยู่กับระบบชำระเงิน ไม่ใช่ทุกระบบชำระเงินที่จะส่ง callback สำหรับข้อผิดพลาดในการชำระเงิน

หากจำนวนเงินที่ระบุในการตั้งค่าปุ่มแตกต่างจาก จำนวนเงินที่ลูกค้าชำระจริง บอทจะได้รับ callback ที่ประกอบด้วยอักขระ 10 ตัวแรกของคีย์ลับของระบบชำระเงิน วลี _different_amounts และรหัสการชำระเงินที่ไม่ซ้ำ โดยคั่นด้วยช่องว่าง ตัวอย่าง: ovg58keefc_different_amounts 123456 โดยที่:

• ovg58keefc: อักขระ 10 ตัวแรกของคีย์ลับของระบบชำระเงิน
• _different_amounts: ผลลัพธ์ของการประมวลผลคำขอ (จำนวนเงินที่ชำระแตกต่างจากจำนวนเงินในลิงก์)
• 123456: รหัสการชำระเงินที่ไม่ซ้ำ