ربط نظام الدفع
الربط من جانب Telegram
الخطوة 1. تسجيل الدخول إلى حساب الشريك الخاص بك
في الصفحة التي تفتح، انقر على "تسجيل الدخول عبر Telegram"، ثم أدخل رقم هاتفك في النافذة المنبثقة "تظهر oauth.telegram.org" وانقر على "تطبيق".
من الضروري ربط نظام الدفع من خلال متصفح الويب ومن خلال التطبيق:
- ستتلقى رسالة Telegram تطلب الإذن - انقر على "تطبيق".
- تحتاج أيضًا إلى النقر على "تطبيق" في النافذة المنبثقة "oauth.telegram.org" في متصفح الويب.
يُوصى باستخدام حساب يمكن للشخص المسؤول عن المالية الوصول إليه. بالنسبة للكيانات القانونية – ممثل مفوض.
الخطوة 2. إجراء استبيان صغير
إذا كنت تسجل الدخول لأول مرة أو كنت بحاجة إلى بعض المعلومات الإضافية، يعرض عليك WalletPay الإجابة على بعض الأسئلة للحصول على معلومات أكثر تفصيلاً. هناك خطوتان:
1. الاستبيان
2. فحوصات KYB (اعرف عملك) أو KYC (اعرف عميلك)
بعد الانتهاء، ستتم مراجعة طلبك قريبًا وسيتم إعلامك بالنتائج. إذا نجحت، سترى العمولة التي يفرضها الخدمة وستحصل على وصول إلى حسابك حيث يمكنك بدء التكامل.
بالنسبة للكيانات القانونية، يمكن فقط لشخص موثوق به ملء النموذج: مدير أو موظف بتوكيل.
الخطوة 3. إنشاء أول "متجر".
بعد إكمال "الاستبيان" بنجاح، سيُقترح عليك إنشاء أول متجر لك.
الخطوة 4. إنشاء "مفتاح API"
بعد اسم المتجر الأول، سيُقترح عليك إعداده:
- إنشاء مفتاح API.
- انسخ مفتاح API الخاص بك وابدأ التكامل مع Mavibot.
الخطوة 5. إنشاء طلب والحصول على رابط الدفع
إذا كنت ترغب في وضع رابط في زر، استخدم الزر المضمن (Inline Button).
يرجى ملاحظة أنه يمكن فقط لـ "customerTelegramUserId" المحدد فتح صفحة الدفع.
الخطوة 6. سحب الأموال
بعد تأكيد العميل للدفع، تُضاف الأموال إلى أصولك وتُحتجز لمدة 48 ساعة افتراضيًا. بعد هذا الوقت، ستتمكن من سحب الأموال إلى رصيد محفظتك (Wallet) التي استخدمتها لتسجيل الدخول إلى خدمة Paypal Wallet.
الخطوة 7. إعادة الأموال
حاليًا، سحب الأموال متاح من حساب محفظتك (Wallet) الذي تستخدمه لتسجيل الدخول إلى WalletPay. لكنه سيكون متاحًا قريبًا في حساب التاجر الخاص بك.
كيف يبدو زر الدفع؟
عند دمج بوت Telegram الخاص بك مع "Wallet Pay API"، تأكد من أن زر الدفع يتوافق مع التوصيات التالية:
- يُسمى بإحدى طريقتين:
- 👛 Wallet Pay
- 👛 Pay via Wallet
- يقع فوق الأزرار الأخرى (إذا كان لديك أي منها).
ملاحظة. 👛 — هذا رمز تعبيري (انظر https://emojipedia.org/purse/).
انظر المثال في [بوت المتجر التجريبي].
الربط مع Mavibot
سجل الدخول إلى المشروع وانقر على زر "اتصال" لـ Wallet Pay في قسم "أنظمة الدفع".
في النافذة التي تفتح، أدخل مفتاح API الذي تم إنشاؤه لمتجر WalletPay الخاص بك.
- جاهز! الآن يمكن للعملاء الدفع مقابل المشتريات في متجرك بالعملات المشفرة (USDT و Toncoin و Bitcoin) باستخدام خدمة Paypal Wallet.
كيفية إنشاء رابط الدفع
أنشئ كتلة منشئ القمع واستدعِ الدالة "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.
- كلمة النجاح
! إذا كان هناك خطأ في الدفع، ستتلقى رد اتصال باللاحقة "_fail".
عنوان الإشعارات (ردود الاتصال): https://chatter.salebot.pro/wallet_pay/payment_callback - يتم إدراجه في إعدادات نظام الدفع
يمكن تضمين رد الاتصال في شرط الكتلة لإرسال رسالة إلى العميل حول الدفع الناجح (أو خطأ الدفع):
إذا كنت لا ترغب في إخراج العميل من مخطط البوت الرئيسي، استخدم كتلة "شرط غير حال". لا يمكنك الانتقال إلى هذه الكتلة، لذلك لن يتم إخراج العميل من القمع الرئيسي بعد الدفع وسيتلقى إشعارًا بالدفع الناجح.\
وإذا كنت بحاجة إلى متابعة القمع مع رد فعل على الدفع الناجح، فاستخدم كتلة "شرط البدء"، ثم سينتقل العميل من كتلة الدفع إلى كتلة "شرط البدء"، حيث يمكنك متابعة القمع.
مزيد من المعلومات حول الكتل الشرطية متوفرة في المقالة التي تحمل الاسم نفسه. تم شرح الكتل الشرطية