การเชื่อมต่อระบบชำระเงิน
การเชื่อมต่อฝั่ง Telegram
ขั้นตอนที่ 1. เข้าสู่ระบบบัญชีพาร์ทเนอร์ของคุณ
ในหน้าที่เปิดขึ้น ให้คลิก "เข้าสู่ระบบผ่าน Telegram" จากนั้นป้อนหมายเลขโทรศัพท์ของคุณในหน้าต่างป๊อปอัป "Appears oauth.telegram.org" และคลิก "สมัคร"
จำเป็นต้องเชื่อมต่อระบบชำระเงินทั้งผ่านเว็บเบราว์เซอร์และผ่านแอปพลิเคชัน:
- คุณจะได้รับข้อความ Telegram ขออนุญาต - คลิก "สมัคร"
- คุณต้องคลิก "สมัคร" ในหน้าต่างป๊อปอัป "oauth.telegram.org" ในเว็บเบราว์เซอร์
ขอแนะนำให้ใช้บัญชีที่ผู้รับผิดชอบด้านการเงินสามารถเข้าถึงได้ สำหรับนิติบุคคล – ตัวแทนที่ได้รับอนุญาต
ขั้นตอนที่ 2. ทำแบบสำรวจสั้นๆ
หากคุณเข้าสู่ระบบครั้งแรกหรือต้องการข้อมูลเพิ่มเติม WalletPay จะเสนอให้คุณตอบคำถามสองสามข้อเพื่อรับข้อมูลโดยละเอียดเพิ่มเติม มีสองขั้นตอน:
1. แบบสอบถาม
2. การตรวจสอบ KYB (Know Your Business) หรือ KYC (Know Your Customer)
หลังจากเสร็จสิ้น แอปพลิเคชันของคุณจะได้รับการตรวจสอบในเร็วๆ นี้ และคุณจะได้รับแจ้งผลลัพธ์ หากสำเร็จ คุณจะเห็นค่าคอมมิชชันที่เรียกเก็บโดยบริการและสามารถเข้าถึงบัญชีของคุณเพื่อเริ่มการรวมระบบ
สำหรับนิติบุคคล แบบฟอร์มสามารถกรอกได้โดยผู้มีอำนาจเท่านั้น: ผู้อำนวยการหรือพนักงานที่ได้รับมอบอำนาจ
ขั้นตอนที่ 3. สร้าง "ร้านค้า" แรก
หลังจากทำ "แบบสำรวจ" สำเร็จ คุณจะได้รับคำแนะนำให้สร้างร้านค้าแรกของคุณ
ขั้นตอนที่ 4. สร้าง "คีย์ API"
หลังจากตั้งชื่อร้านค้าแรก คุณจะได้รับคำแนะนำให้ตั้งค่า:
- สร้างคีย์ API
- คัดลอกคีย์ API ของคุณและเริ่มรวมระบบกับ Mavibot
ขั้นตอนที่ 5. สร้างคำสั่งซื้อและรับลิงก์ชำระเงิน
หากคุณต้องการใส่ลิงก์ในปุ่ม ให้ใช้ Inline Button
โปรดทราบว่าเฉพาะ "customerTelegramUserId" ที่ระบุเท่านั้นที่สามารถเปิดหน้าชำระเงินได้
ขั้นตอนที่ 6. ถอนเงิน
หลังจากที่ลูกค้ายืนยันการชำระเงิน เงินจะถูกโอนเข้าสินทรัพย์ของคุณและถูกระงับไว้เป็นเวลา 48 ชั่วโมงตามค่าเริ่มต้น หลังจากเวลานี้ คุณจะสามารถถอนเงินไปยังยอดคงเหลือใน Wallet ของคุณ ซึ่งคุณใช้ในการเข้าสู่ระบบบริการ Wallet Pay
ขั้นตอนที่ 7. คืนเงิน
ปัจจุบัน การถอนเงินสามารถทำได้จากบัญชี Wallet ของคุณ ซึ่งคุณใช้ในการเข้าสู่ระบบ WalletPay แต่จะสามารถใช้ได้ในบัญชี Merchant ของคุณเร็วๆ นี้
ปุ่มชำระเงินมีลักษณะอย่างไร?
เมื่อรวมระบบ Telegram Bot ของคุณกับ "Wallet Pay API" ตรวจสอบให้แน่ใจว่าปุ่มชำระเงินเป็นไปตามคำแนะนำต่อไปนี้:
- ตั้งชื่อด้วยวิธีใดวิธีหนึ่งจากสองวิธี:
- 👛 Wallet Pay
- 👛 ชำระเงินผ่าน Wallet
- วางไว้เหนือปุ่มอื่นๆ (ถ้ามี)
หมายเหตุ 👛 — คืออิโมจิ (ดู https://emojipedia.org/purse/)
ดูตัวอย่างใน [Demo Store Bot]
การเชื่อมต่อกับ Mavibot
เข้าสู่ระบบโปรเจกต์และคลิกปุ่ม “เชื่อมต่อ” สำหรับ Wallet Pay ในส่วน “ระบบชำระเงิน”
ในหน้าต่างที่เปิดขึ้น ให้ป้อนคีย์ API ที่สร้างขึ้นสำหรับร้านค้า WalletPay ของคุณ
- พร้อมแล้ว! ตอนนี้ลูกค้าสามารถชำระค่าสินค้าในร้านค้าของคุณด้วยสกุลเงินดิจิทัล (USDT, Toncoin และ Bitcoin) โดยใช้บริการ Wallet Pay
วิธีสร้างลิงก์ชำระเงิน
สร้างบล็อกตัวสร้างฟันเนลและเรียกใช้ฟังก์ชัน “wallet_pay_generate_payment_url” ในเครื่องคิดเลข โดยส่งพารามิเตอร์ที่จำเป็นให้:
| พารามิเตอร์ | คำอธิบายพารามิเตอร์ |
|---|---|
| amount | จำนวนเงินที่ชำระในสกุลเงินดิจิทัลหรือสกุลเงินคำสั่งอื่นที่สามารถแปลงเป็น “TON” ได้ |
| сurrency_code | สกุลเงินเริ่มต้นคือ “RUB" รายการสกุลเงินที่ใช้ได้: "TON" "BTC" "USDT" "EUR" "USD" "RUB" |
| description | คำอธิบายสั้นๆ ของคำสั่งซื้อ ตั้งแต่ 5 ถึง 100 ตัวอักษร |
| timeout_seconds | ระยะเวลาที่ลิงก์ใช้งานได้ในหน่วยวินาที ค่าเริ่มต้นคือ 3600 วินาที |
เมื่อบล็อกถูกเรียกใช้ในแชทกับบอท ลูกค้าจะได้รับลิงก์ชำระเงิน และตัวแปรลูกค้า wallet_pay_payment_completed จะถูกสร้างขึ้นโดยมีค่าเป็น False
ลิงก์นี้สามารถเปิดได้เฉพาะในแชทกับบอทที่เชื่อมต่อกับบัญชีการเรียกเก็บเงิน WalletPay เท่านั้น
การยืนยันการชำระเงิน
หลังจากชำระเงินสำเร็จ ตัวแปร wallet_pay_payment_completed ของลูกค้าจะถูกตั้งค่าเป็น True และผู้ขายจะได้รับ callback ในรูปแบบ 4690FE98_success ซึ่งประกอบด้วย:
- “4690FE98” - คือ 8 ตัวอักษรแรกของคีย์ API Wallet Pay
- คำว่า "สำเร็จ"
! หากมีข้อผิดพลาดในการชำระเงิน คุณจะได้รับ callback ที่มีคำต่อท้าย “_fail”
ที่อยู่สำหรับการแจ้งเตือน (callbacks): https://chatter.salebot.pro/wallet_pay/payment_callback - ใส่ในการตั้งค่าระบบชำระเงิน
สามารถฝัง callback ในเงื่อนไขของบล็อกเพื่อส่งข้อความถึงลูกค้าเกี่ยวกับการชำระเงินที่สำเร็จ (หรือข้อผิดพลาดในการชำระเงิน):
หากคุณไม่ต้องการให้ลูกค้าหลุดออกจากแผนผังบอทหลัก ให้ใช้บล็อก "Non state condition" คุณไม่สามารถไปที่บล็อกนี้ได้ ดังนั้นลูกค้าจะไม่หลุดออกจากฟันเนลหลักหลังการชำระเงิน และจะได้รับการแจ้งเตือนการชำระเงินสำเร็จ
และหากคุณต้องการดำเนินการฟันเนลต่อโดยมีการตอบสนองต่อการชำระเงินที่สำเร็จ ให้ใช้บล็อก "Start condition" จากนั้นลูกค้าจะย้ายจากบล็อกการชำระเงินไปยังบล็อก "Start condition" ซึ่งคุณสามารถดำเนินการฟันเนลต่อได้
ข้อมูลเพิ่มเติมเกี่ยวกับบล็อกเงื่อนไขมีอยู่ในบทความชื่อเดียวกัน บล็อกที่มีเงื่อนไขได้อธิบายไว้