การเชื่อมต่อ PayTabs กับ Mavibot
ในการเชื่อมต่อ PayTabs กับ Mavibot คุณต้องกำหนดค่าต่างๆ ในบัญชี PayTabs ของคุณ
1. สร้าง API Key
ในแดชบอร์ด PayTabs ของคุณ ไปที่:
Developers → API Keys
สร้าง API Key ใหม่
หลังจากสร้าง API Key แล้ว ให้บันทึกรายละเอียดต่อไปนี้:
- Server Key — จำเป็นสำหรับการตั้งค่าการรวมระบบ
- Profile ID — จำเป็นสำหรับการตั้งค่าการเชื่อมต่อเช่นกัน
2. กำหนดค่าการแจ้งเตือนการชำระเงิน
ไปที่:
Developers → Configuration
เปิดใช้งานการแจ้งเตือนการชำระเงิน (callbacks)
คลิก "+" และเพิ่ม URL callback ต่อไปนี้:
https://chatter.mavibot.ai/paytabs_callback/result
URL นี้ใช้สำหรับส่งการอัปเดตสถานะการชำระเงินไปยัง Mavibot
3. กำหนดค่า PayTabs ใน Mavibot
ในการตั้งค่า Mavibot:
- ไปที่ส่วน Acquiring
- เลือก PayTabs เป็นผู้ให้บริการชำระเงิน
- ป้อนรายละเอียดต่อไปนี้:
- Profile ID
- Server Key
- เลือก ภูมิภาคบัญชี PayTabs ของคุณ
โปรดทราบ!
ภูมิภาคที่เลือกต้องตรงกับภูมิภาคที่บัญชี PayTabs ของคุณลงทะเบียนไว้
เมื่อบันทึกการตั้งค่าแล้ว การตั้งค่าการรวมระบบจะเสร็จสมบูรณ์
การสร้างลิงก์ชำระเงิน
ในการสร้างลิงก์ชำระเงิน ให้ใช้ฟังก์ชันต่อไปนี้:
get_paytabs_payment_url(amount, description, currency, customer_email, customer_phone, full_name, language)
พารามิเตอร์ของฟังก์ชัน
| พารามิเตอร์ | คำอธิบาย |
|---|---|
| ! amount | จำนวนเงินที่ชำระ พารามิเตอร์ที่จำเป็น |
| description | คำอธิบายการชำระเงิน พารามิเตอร์ที่ไม่บังคับ |
| currency | สกุลเงินที่ชำระ พารามิเตอร์ที่ไม่บังคับ |
| customer_email | ที่อยู่อีเมลของลูกค้า พารามิเตอร์ที่ไม่บังคับ |
| customer_phone | หมายเลขโทรศัพท์ของลูกค้า พารามิเตอร์ที่ไม่บังคับ |
| full_name | ชื่อเต็มของลูกค้า พารามิเตอร์ที่ไม่บังคับ |
| language | ภาษาของหน้าชำระเงิน พารามิเตอร์ที่ไม่บังคับ |
สกุลเงินที่รองรับ
รหัสสกุลเงินต่อไปนี้รองรับ:
SAR, AED, BHD, EGP, EUR, GBP, HKD, IDR,INR, IQD, JOD, JPY, KWD, MAD, OMR,PKR, QAR, USD
ภาษาที่รองรับ
en — อังกฤษar — อาหรับfr — ฝรั่งเศส
ฟังก์ชันจะส่งคืน URL การชำระเงิน
หากไม่ได้ระบุพารามิเตอร์ currency สกุลเงินจะถูกเลือกโดยอัตโนมัติตามภูมิภาคที่กำหนดค่าไว้
การใช้ลิงก์ชำระเงินในปุ่ม
ในการส่งปุ่มชำระเงินให้กับลูกค้า:
- สร้างปุ่มด้วยประเภท Payment
- เลือก PayTabs เป็นผู้ให้บริการชำระเงิน
- ระบุ:
- คำอธิบายการชำระเงิน;
- จำนวนเงินที่ชำระ;
- สกุลเงิน
การจัดการสถานะการชำระเงิน
หลังจากที่ลูกค้าเปิดลิงก์ชำระเงินและชำระเงินเสร็จสิ้น เหตุการณ์ callback จะถูกส่งไปยังการสนทนา
การชำระเงินสำเร็จ
ตัวอย่าง:
SDJ91MTKTT_success 100
โดยที่:
- SDJ91MTKTT — 10 ตัวอักษรแรกของ Server Key
- 100 — จำนวนเงินที่ชำระ
ในการสร้างการดำเนินการสำหรับการชำระเงินที่สำเร็จ ให้ไปที่ Builder และสร้างบล็อกที่มีทริกเกอร์ (ซึ่งอาจเป็นบล็อก Start หรือบล็อก Trigger)
จากนั้น ในฟิลด์ Trigger ให้ป้อน:
- ค่า callback เต็ม (หากคุณต้องการให้ทริกเกอร์การดำเนินการสำหรับจำนวนเงินที่ชำระเฉพาะเท่านั้น) หรือ
- เฉพาะค่า callback ก่อนจำนวนเงินที่ชำระ (หากคุณต้องการให้ทริกเกอร์การดำเนินการสำหรับการชำระเงินที่สำเร็จทั้งหมด)
การชำระเงินล้มเหลว
ตัวอย่าง:
SDJ91MTKTT_fail 100
การจัดการการชำระเงินที่ล้มเหลวจะกำหนดค่าในลักษณะเดียวกับการจัดการการชำระเงินที่สำเร็จ
สร้างบล็อกที่มีทริกเกอร์และป้อนค่า callback ในฟิลด์ Trigger ซึ่งช่วยให้คุณกำหนดการดำเนินการที่จะดำเนินการเมื่อการชำระเงินล้มเหลว
ตัวแปรที่บันทึกหลังจากการชำระเงินสำเร็จ
หลังจากการชำระเงินสำเร็จ ตัวแปรต่อไปนี้จะถูกบันทึกโดยอัตโนมัติสำหรับลูกค้า:
paytabs_callback_data
มี payload webhook เต็มที่ได้รับจากระบบการชำระเงิน
paytabs_payment_completed
ค่า:
True
บ่งชี้ว่าการชำระเงินเสร็จสมบูรณ์แล้ว