การเชื่อมต่อ 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 การชำระเงิน

สำคัญ! ลิงก์การชำระเงินจะใช้ได้ในช่วงเวลาจำกัด ส่งลิงก์ไปยังลูกค้าทันทีหลังจากสร้าง

ตัวอย่าง


ปุ่มลิงก์การชำระเงิน

ในการส่งปุ่มชำระเงิน:

  1. สร้างปุ่มด้วยฟังก์ชัน Pay
  2. เลือก Telr เป็นระบบชำระเงิน
  3. ระบุ:
    • ชื่อผลิตภัณฑ์
    • จำนวนเงินที่ชำระ
    • สกุลเงิน

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)