หากต้องการใช้ Clip ใน MaviBot คุณต้องสร้างคู่ข้อมูลรับรองในบัญชี Clip ของคุณและป้อนข้อมูลดังกล่าวในการตั้งค่าระบบการชำระเงิน
Clip เป็นบริการชำระเงินของเม็กซิโก
การขอรับข้อมูลรับรอง
ลงนามข้อตกลงกับ Clip และรับสิทธิ์เข้าถึง แดชบอร์ดนักพัฒนา ในบัญชี Clip ของคุณ
ในส่วนข้อมูลรับรอง ให้คลิก Crear credencial (สร้างข้อมูลรับรอง) ป้อนชื่อ และยืนยันการสร้าง
คัดลอกข้อมูลรับรองต่อไปนี้:
- คีย์ API
- Clave secreta (คีย์ลับ)
สำคัญ! คีย์ลับจะแสดงเพียงครั้งเดียวทันทีหลังจากสร้างข้อมูลรับรอง โปรดบันทึกไว้ในที่ปลอดภัย คุณจะไม่สามารถดูอีกครั้งในบัญชี Clip ของคุณ หากทำหาย คุณจะต้องสร้างคู่ข้อมูลรับรองใหม่
ข้อมูลรับรองจะถูกสร้างแยกกันสำหรับสภาพแวดล้อมการใช้งานจริงและการทดสอบ คุณสามารถสร้างได้สูงสุด 6 แอปพลิเคชันต่อบัญชี
สำหรับการทดสอบการรวมระบบ ให้สร้างคู่ข้อมูลรับรองสำหรับการทดสอบ หากต้องการรับชำระเงินจริง ให้ใช้ข้อมูลรับรองสำหรับการใช้งานจริง
คุณไม่จำเป็นต้องกำหนดค่า URL การแจ้งเตือนการชำระเงินในบัญชี Clip ของคุณ MaviBot จะส่ง URL การแจ้งเตือนโดยอัตโนมัติเมื่อมีการสร้างการชำระเงินแต่ละครั้ง
การเชื่อมต่อ Clip
ในแท็บ การรับชำระเงิน ให้เลือก Clip และป้อน:
| ฟิลด์ | คำอธิบาย |
|---|---|
| คีย์ API | ตัวระบุแอปพลิเคชัน |
| คีย์ลับ (Clave secreta) | คีย์ลับของแอปพลิเคชัน |
การเชื่อมต่อเสร็จสมบูรณ์แล้ว
การสร้างลิงก์ชำระเงิน
ใช้ฟังก์ชันเครื่องคิดเลขต่อไปนี้:
get_clip_payment_url(amount, description, currency, customer_email, customer_phone, full_name, product_name, language)
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
amount |
จำนวนเงินที่ชำระ จำเป็น จำนวนเงินขั้นต่ำคือ 1 ในหน่วยสกุลเงินหลัก ระบุจำนวนเงินเป็น 100.55 ไม่ใช่ 10055
|
description |
คำอธิบายการชำระเงิน ไม่บังคับ ความยาวสูงสุด: 250 ตัวอักษร ลูกค้าสามารถดูได้ในหน้าชำระเงินและใบเสร็จ |
currency |
รหัสสกุลเงินสามตัวอักษร (MXN และสกุลเงินอื่นๆ ที่มีให้สำหรับบัญชี Clip ของคุณ) ไม่บังคับ ค่าเริ่มต้น: MXN
|
customer_email |
ที่อยู่อีเมลของลูกค้า ไม่บังคับ จะถูกแทรกลงในแบบฟอร์มชำระเงินโดยอัตโนมัติ |
customer_phone |
หมายเลขโทรศัพท์ของลูกค้า ไม่บังคับ จะถูกแทรกลงในแบบฟอร์มชำระเงินโดยอัตโนมัติ |
full_name |
ชื่อของลูกค้า ไม่บังคับ จะถูกแทรกลงในแบบฟอร์มชำระเงินโดยอัตโนมัติ |
product_name |
ชื่อผลิตภัณฑ์ ไม่บังคับ |
language |
ภาษาของหน้าชำระเงิน: es สำหรับภาษาสเปน (ค่าเริ่มต้น) หรือ en สำหรับภาษาอังกฤษ |
ฟังก์ชันจะส่งคืน URL การชำระเงิน
ปุ่มลิงก์ชำระเงิน
หากต้องการส่งปุ่มชำระเงินให้ลูกค้า:
- สร้างปุ่มด้วยฟังก์ชัน ชำระเงิน
- เลือก Clip เป็นระบบการชำระเงิน
- ระบุชื่อผลิตภัณฑ์ จำนวนเงิน และสกุลเงิน
- หากจำเป็น ให้ระบุตัวแปรที่มีชื่อ ที่อยู่อีเมล และหมายเลขโทรศัพท์ของลูกค้า
การแจ้งเตือนการชำระเงิน
หลังจากที่ลูกค้าตามลิงก์ชำระเงินและชำระเงินเสร็จสิ้น MaviBot จะได้รับการแจ้งเตือน
การชำระเงินสำเร็จ
ตัวอย่าง:
SDJ91MTKTT_success 100.55
โดยที่:
-
SDJ91MTKTT— 10 ตัวอักษรแรกของคีย์ API ของคุณ -
100.55— จำนวนเงินที่ชำระ
การชำระเงินล้มเหลว
หากการชำระเงินไม่สำเร็จ จะมีการส่งการแจ้งเตือนดังต่อไปนี้:
SDJ91MTKTT_fail 100.55
สำคัญ! การแจ้งเตือนการชำระเงินล้มเหลวจะถูกส่งหลังจากลิงก์ชำระเงินถูกปิดอย่างถาวรเท่านั้น: หลังจาก ความพยายามชำระเงินไม่สำเร็จ 5 ครั้ง หรือเมื่อลิงก์หมดอายุ
ตราบใดที่ลูกค้ายังมีโอกาสชำระเงินเหลืออยู่ ลิงก์จะยังคงทำงานอยู่และจะไม่มีการส่งการแจ้งเตือนการชำระเงินล้มเหลว
ตัวแปรของลูกค้าหลังการชำระเงินสำเร็จ
| ตัวแปร | คำอธิบาย |
|---|---|
clip_callback_data |
ข้อมูลการชำระเงินที่ได้รับจากระบบการชำระเงิน Clip |
clip_payment_completed |
"True" หากการชำระเงินดำเนินการสำเร็จ |
clip_payment_request_id |
ตัวระบุลิงก์ชำระเงินใน Clip |
clip_receipt_no |
หมายเลขใบเสร็จของ Clip |