วิธีเชื่อมต่อ
ในการเชื่อมต่อระบบการชำระเงิน Fondy คุณจะต้องมีรหัสผู้ค้า (Merchant ID) และคีย์ลับ (Secret Key) หลังจากได้รับข้อมูลดังกล่าวแล้ว ให้ไปที่การตั้งค่าใน Mavibot
ใน Mavibot ให้เปิดส่วนของระบบการชำระเงิน เลือก Fondy คุณต้องป้อนข้อมูลที่ได้รับ
ในการสร้างลิงก์สำหรับการชำระเงิน คุณต้องตั้งค่าของตัวแปร payment_sum (เช่น 150 หรือ 100.55 (ใช้จุด!)) ทันทีหลังจากนั้น ตัวแปร fondy_pay_url จะปรากฏขึ้น ตัวแปรนี้สามารถแสดงเป็นลิงก์หรือวางบนปุ่มที่มีข้อความ "ชำระเงิน" ได้
ลิงก์มีรูปแบบดังนี้:
นอกจากนี้ ก่อนที่จะตั้งค่าของ payment_sum คุณสามารถระบุตัวแปรเสริมต่อไปนี้เพื่อกำหนดค่าการชำระเงิน
การตั้งค่าเริ่มต้นคือ UAH หากคุณต้องการสกุลเงินอื่น คุณต้องตั้งค่าของตัวแปร currency
currency - สกุลเงินของคำสั่งซื้อ
ค่าที่ถูกต้อง:
UAH - ฮรีฟเนียยูเครน
RUB - รูเบิลรัสเซีย
USD - ดอลลาร์สหรัฐ
EUR - ยูโร
GBP - ปอนด์สเตอร์ลิง (จำเป็น)
CZK - โครนเช็ก
payment_description - คำอธิบายคำสั่งซื้อ
session_timeout - อายุของคำสั่งซื้อในหน่วยวินาที
ค่าเริ่มต้น (36000 วินาที = 10 ชั่วโมง)
language - ภาษาของหน้าชำระเงิน:
ru - รัสเซีย
uk - ยูเครน
en - อังกฤษ
lv - ลัตเวีย
fr - ฝรั่งเศส
cs - เช็ก
ro - โรมาเนีย
it - อิตาลี
sk - สโลวัก
pl - โปแลนด์
es - สเปน
hu - ฮังการี
de - เยอรมัน
วิธีสร้างลิงก์
สร้างลิงก์สำหรับการชำระเงิน 122 ฮรีฟเนีย (ค่าเริ่มต้นคือฮรีฟเนีย)
โปรดทราบ:
- ระบุพารามิเตอร์เสริม payment_description ก่อน เป็นต้น
- และสุดท้าย กำหนดค่าของตัวแปร payment_sum
โปรดทราบ ก่อนอื่นเราตั้งค่าตัวแปรเพิ่มเติมสำหรับการตั้งค่า จากนั้นจึงตั้งค่า payment_sum คุณสามารถกำหนดตัวแปรก่อนหน้านี้ในเชน ไม่จำเป็นต้องอยู่ในบล็อกเดียว นี่เป็นเพียงตัวอย่าง
ถัดไป ในตำแหน่งที่เหมาะสม ให้พิมพ์ตัวแปร fondy_pay_url ซึ่งมีลิงก์อยู่
วิธีประมวลผลผลลัพธ์
หลังจากชำระเงินสำเร็จ ในบอทจะมีการเรียกกลับ (callbacks) ซึ่งคุณสามารถเข้าใจได้ว่ามีการชำระเงินสำเร็จ การเรียกกลับเหล่านี้ในระบบคุณจะเห็นเป็นข้อความจากผู้ใช้ เพื่อให้ผู้ใช้ไม่สามารถส่งได้ ประกอบด้วยอักขระ 5 ตัวแรกของคีย์ลับและคำว่า success เช่น: h4fd56_success
หากรหัสผ่านสั้นกว่า 5 ตัวอักษร รหัสผ่านจะถูกใช้ทั้งหมด เช่น สำหรับการชำระเงินทดสอบ รหัสผ่านคือ test ดังนั้นการเรียกกลับจะมาเป็น test_success
การเรียกกลับเหล่านี้ผู้ใช้จะไม่เห็น แสดงเฉพาะกับผู้ปฏิบัติงานเท่านั้น
ประเภทการเปรียบเทียบควรเป็น "ตรงกันทั้งหมด"
นอกจากนี้ หลังจากชำระเงินสำเร็จ ตัวแปร fondy_payment_completed จะถูกตั้งค่าเป็น True
ตัวอย่างเช่น คุณสามารถสร้างบล็อกการประมวลผลการชำระเงินสำเร็จพร้อมเงื่อนไขและพิมพ์ข้อความที่เกี่ยวข้องให้กับผู้ใช้:
หลังจากชำระเงินเสร็จสิ้น ตัวแปร fondy_callback_data จะถูกเพิ่มให้กับลูกค้า ซึ่งมีข้อมูลการตอบกลับของระบบการชำระเงินสำหรับธุรกรรมที่เสร็จสมบูรณ์ คุณสามารถดึงข้อมูลที่จำเป็นจากพจนานุกรมโดยใช้เมธอด get
หากต้องการชำระเงินซ้ำ คุณต้องรีเซ็ต payment_sum ลิงก์ที่สร้างไว้ก่อนหน้านี้ และหลังจากรีเซ็ตตัวแปร payment_sum แล้วจึงจะได้รับลิงก์ใหม่ คุณสามารถระบุค่าก่อนหน้าได้
วิธีทดสอบการชำระเงิน
ข้อมูลทดสอบ ณ เวลาที่เผยแพร่เอกสาร:
รหัสผู้ค้า: 1396424
รหัสผ่าน: test
หมายเลขบัตรทดสอบ
44445566661111 - สำเร็จ
4444111166665555 - ปฏิเสธ
ระยะเวลาที่ใช้ได้และ CVV2 ใดก็ได้
หากมีสิ่งใดไม่ทำงาน ให้เปรียบเทียบข้อมูลกับข้อมูลในเว็บไซต์ทางการ: https://docs.fondy.eu/ru/docs/page/2/2