การเชื่อมต่อ Telr
ในการใช้ระบบชำระเงิน Telr ใน MaviBot คุณต้องได้รับข้อมูลประจำตัวร้านค้าจากบัญชี Telr ของคุณและป้อนข้อมูลเหล่านั้นในการตั้งค่าระบบชำระเงิน
การขอข้อมูลประจำตัวร้านค้า
ลงนามข้อตกลงกับ Telr และรับสิทธิ์เข้าถึงบัญชีผู้ค้าของคุณ
ใน Stores → Store details ให้คัดลอกค่าต่อไปนี้:
| ฟิลด์ Telr | ฟิลด์ MaviBot |
|---|---|
| Store ID | Store ID |
| Authentication key | Authentication Key |
การกำหนดค่าการแจ้งเตือนการชำระเงิน
เปิด Payment Page (หรือ Security) → Transaction advice และระบุ URL การแจ้งเตือนต่อไปนี้:
https://chatter.mavibot.ai/telr_callback/result
เลือกประเภทธุรกรรมที่คุณต้องการรับการแจ้งเตือน
ในส่วนเดียวกัน ให้คัดลอก Secret key คีย์นี้ใช้เพื่อตรวจสอบลายเซ็นการแจ้งเตือน
สำคัญ! การกำหนดค่า Transaction advice เป็นสิ่งจำเป็น หากไม่มี MaviBot จะไม่ได้รับการแจ้งเตือนการชำระเงิน และจะไม่มีการส่ง callback ไปยังบอท
การเชื่อมต่อ Telr ใน MaviBot
เปิด Payment Systems ในการตั้งค่าโปรเจกต์ของคุณ เลือก Telr และกรอกข้อมูลในฟิลด์ต่อไปนี้:
| ฟิลด์ | คำอธิบาย |
|---|---|
| Store ID | ตัวระบุตัวเลขของร้านค้า Telr ของคุณ |
| Authentication Key | ใช้เพื่อสร้างลิงก์การชำระเงิน |
| Secret Key | ใช้เพื่อตรวจสอบลายเซ็นการแจ้งเตือนการชำระเงิน หากไม่มี การแจ้งเตือนการชำระเงินจะถูกปฏิเสธ |
| Test Mode | เปิดใช้งานการชำระเงินทดสอบโดยใช้บัตรทดสอบของ Telr โดยไม่ต้องเรียกเก็บเงินจริง ปิดตัวเลือกนี้เพื่อรับการชำระเงินจริง |
เมื่อกรอกข้อมูลครบทุกฟิลด์แล้ว การผสานรวมก็พร้อมใช้งาน
การสร้างลิงก์การชำระเงิน
ใช้ฟังก์ชัน Calculator ต่อไปนี้:
get_telr_payment_url(amount, description, currency, product_name)
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
amount |
จำนวนเงินที่ชำระ จำเป็น |
description |
คำอธิบายการชำระเงิน ไม่บังคับ ความยาวสูงสุด: 63 ตัวอักษร |
currency |
รหัสสกุลเงินสามตัวอักษร (AED, SAR, USD, EUR, GBP และสกุลเงินอื่นๆ ที่มีให้สำหรับบัญชี Telr ของคุณ) ไม่บังคับ ค่าเริ่มต้น: AED
|
product_name |
ชื่อผลิตภัณฑ์ ไม่บังคับ |
ฟังก์ชันจะส่งคืน URL การชำระเงิน
สำคัญ! ลิงก์การชำระเงินจะใช้ได้ในช่วงเวลาจำกัด ส่งลิงก์ไปยังลูกค้าทันทีหลังจากสร้าง
ตัวอย่าง

ปุ่มลิงก์การชำระเงิน
ในการส่งปุ่มชำระเงิน:
- สร้างปุ่มด้วยฟังก์ชัน Pay
- เลือก Telr เป็นระบบชำระเงิน
- ระบุ:
- ชื่อผลิตภัณฑ์
- จำนวนเงินที่ชำระ
- สกุลเงิน
Callback การชำระเงิน
หลังจากลูกค้าชำระเงินเสร็จสิ้น MaviBot จะได้รับ callback โดยอัตโนมัติ
การชำระเงินสำเร็จ
ตัวอย่าง:
SDJ91MTKTT_success 100
โดยที่:
-
SDJ91MTKTT— 10 ตัวอักษรแรกของ Authentication Key ของคุณ -
100— จำนวนเงินที่ชำระ
การชำระเงินล้มเหลวหรือถูกยกเลิก
ตัวอย่าง:
SDJ91MTKTT_fail 100
การชำระเงินที่อยู่ระหว่างการตรวจสอบของธนาคาร
หากการชำระเงินได้รับอนุมัติแต่ถูกระงับโดยธนาคารเพื่อการตรวจสอบเพิ่มเติม จะไม่มีการส่ง callback จนกว่าการตรวจสอบจะเสร็จสิ้น
เมื่อธนาคารอนุมัติหรือปฏิเสธธุรกรรม Telr จะส่งการแจ้งเตือน และ callback จะถูกส่งไปยัง MaviBot โดยอัตโนมัติ
ตัวแปรของลูกค้าหลังการชำระเงินสำเร็จ
| ตัวแปร | คำอธิบาย |
|---|---|
telr_callback_data |
ข้อมูลการชำระเงินที่ได้รับจากระบบชำระเงิน Telr |
telr_payment_completed |
"True" หากการชำระเงินได้รับการประมวลผลสำเร็จ |
telr_tran_ref |
ข้อมูลอ้างอิงธุรกรรม Telr (tran_ref) |