Wallet pay
الاتصال بنظام الدفع
الاتصال من جهة تيليغرام
الخطوة 1. سجّل الدخول إلى حساب الشريك الخاص بك
في الصفحة التي تفتح، انقر على "تسجيل الدخول عبر تيليغرام"، ثم أدخل رقم هاتفك في النافذة المنبثقة "يظهر oauth.telegram.org" وانقر على "تطبيق".
من الضروري توصيل نظام الدفع عبر متصفح الويب وعبر التطبيق أيضًا:
ستتلقى رسالة من تيليغرام تطلب التفويض - انقر "تطبيق".
تحتاج أيضًا إلى النقر على "تطبيق" في النافذة المنبثقة "oauth.telegram.org" في متصفح الويب.
يُنصح باستخدام حساب يمكن لمسؤول المالية الوصول إليه. بالنسبة للكيانات القانونية – ممثل مخوّل.
الخطوة 2. أجرِ استطلاعًا قصيرًا
إذا كنت تسجّل الدخول لأول مرة أو كنت بحاجة إلى بعض المعلومات الإضافية، فإن WalletPay يتيح لك الإجابة عن بعض الأسئلة للحصول على معلومات أكثر تفصيلاً. هناك خطوتان:
1. الاستبيان
2. فحوصات KYB (اعرف عملك) أو KYC (اعرف عميلك)
بعد الانتهاء، ستتم مراجعة طلبك قريبًا وسيتم إخطارك بالنتائج. إذا تمت العملية بنجاح، فسترى العمولة التي يفرضها الخِدمة وستحصل على إمكانية الوصول إلى حسابك حيث يمكنك بدء التكامل.
بالنسبة للكيانات القانونية، لا يمكن تعبئة النموذج إلا من قبل شخص موثوق: مدير أو موظف بتوكيل.
الخطوة 3. أنشئ "المتجر" الأول.
بعد إكمال "الاستبيان" بنجاح، سيُقترح عليك إنشاء متجرك الأول.
الخطوة 4. أنشئ "مفتاح API"
بعد اسم المتجر الأول، سيُقترح عليك إعداده:
قم بإنشاء مفتاح API.
انسخ مفتاح API الخاص بك وابدأ التكامل مع Mavibot.
الخطوة 5. أنشئ طلبًا وتلقَّ رابط دفع
إذا أردت وضع رابط داخل زر، فاستخدم زرًا مضمّنًا.
يرجى ملاحظة أن "customerTelegramUserId" المحدد فقط يمكنه فتح صفحة الدفع.
الخطوة 6. سحب الأموال
بعد أن يؤكد العميل الدفع، تُقيد الأموال في أصولك وتُحتجز افتراضيًا لمدة 48 ساعة. بعد هذه المدة، ستتمكن من سحب الأموال إلى رصيد محفظتك، التي استخدمتها لتسجيل الدخول إلى خدمة محفظة Paypal.
الخطوة 7. إرجاع الأموال
حاليًا، سحب الأموال متاح من حساب محفظتك، الذي تستخدمه لتسجيل الدخول إلى WalletPay. لكنه سيكون متاحًا في حساب التاجر الخاص بك قريبًا.
كيف يبدو زر الدفع؟
عند دمج روبوت تيليغرام الخاص بك مع "Wallet Pay API"، تأكد من أن زر الدفع يتوافق مع التوصيات التالية:
يُسمّى بإحدى طريقتين:
:purse: Wallet Pay
:purse: الدفع عبر Wallet
يوضع أعلى الأزرار الأخرى (إن وجدت).
ملاحظة. :purse: — هذه إيموجي (انظر https://emojipedia.org/purse/).
انظر المثال في [Demo Store Bot].
الاتصال بـ Mavibot
سجّل الدخول إلى المشروع وانقر على الزر "اتصال" الخاصة بـ Wallet Pay في قسم "أنظمة الدفع".
في النافذة التي تفتح، أدخل مفتاح API الذي تم إنشاؤه لمتجر WalletPay الخاص بك.
كيفية إنشاء رابط دفع
أنشئ كتلة منشئ القمع واستدعِ "wallet_pay_generate_payment_url" في الحاسبة، مع تمرير المعلمات اللازمة إليها:
amount
مبلغ الدفع بالعملة المشفرة أو بأي عملة ورقية أخرى متاحة للتحويل إلى "TON".
رمز العملة
عملة الدفع الافتراضية هي "RUB". قائمة العملات المتاحة: "TON" "BTC" "USDT" "EUR" "USD" "RUB"
description
وصف قصير للطلب من 5 إلى 100 حرف.
timeout_seconds
مدة صلاحية الرابط بالثواني، والافتراضي هو 3600 ثانية.
عند تشغيل الكتلة في محادثة مع روبوت، سيتلقى العميل رابط دفع، و wallet_pay_payment_completed بالقيمة False.
يمكن فتح هذا الرابط فقط في محادثة مع روبوت متصل بحساب فوترة WalletPay.
التحقق من الدفع
بعد نجاح الدفع، سيتم تعيين متغير العميل إلى wallet_pay_payment_completed سيُعيَّن المتغير إلى True، وسيتلقى البائع ردًا آليًا على شكل 4690FE98_success، والذي يتكون من:
"4690FE98" - هذه هي أول 8 أحرف من مفتاح Wallet Pay API.
كلمات عن النجاح
! إذا حدث خطأ في الدفع، فستتلقى callback مع اللاحقة "_fail".
عنوان الإشعارات (callbacks): https://chatter.salebot.pro/wallet_pay/payment_callback - يُدرج في إعدادات نظام الدفع
يمكن تضمين رد آلي في شرط الكتلة لإرسال رسالة إلى العميل بشأن نجاح الدفع (أو خطأ في الدفع):
إذا كنت لا تريد إخراج العميل من المخطط الرئيسي للروبوت الدردشة، فاستخدم كتلة "شرط الحالة غير النشطة". لا يمكنك الانتقال إلى هذه الكتلة، لذلك لن يتم إخراج العميل من القمع الرئيسي بعد الدفع وسيتلقى إشعارًا بنجاح الدفع. إشعار بنجاح الدفع.
وإذا كنت بحاجة إلى متابعة القمع مع تفاعل على الدفع الناجح، فاستخدم كتلة "شرط البدء"، ثم سينتقل العميل من كتلة الدفع إلى كتلة "شرط البدء"، ومن خلالها يمكنك متابعة القمع.
مزيد من المعلومات حول الكتل الشرطية موضحة في المقالة التي تحمل الاسم نفسه. ссылкаблоках с условием рассказали
روابط مفيدة
آخر تحديث