# WalletOne * [كيفية إعداد WalletOne ](#how-to-configure-walletone) * [كيفية إعداد Salebot ](#how-to-configure-salebot) * [مثال](#example) ## كيفية إعداد WalletOne للاتصال بـ walletone ستحتاج إلى معرّف متجر ومفتاح سري. يمكن العثور على معرّف المتجر في الزاوية العلوية اليمنى من حسابك: !!!!! لكي يتلقى الروبوت إشعارات الدفع، من الضروري أيضًا ضبط ذلك في الحساب الشخصي لـ Unified Cashier ضمن قسم «الإعدادات» وفي علامة التبويب «التكامل» وملء الحقل: بيانات إرسال نتيجة المعاملة: وإنشاء «مفتاح سري» كما هو موضح في الصورة: !!!! {% hint style="info" %} بعد إنشاء المفتاح السري، تأكد من النقر على «حفظ» في أسفل الصفحة. هذا شرط أساسي لعمله بشكل صحيح. {% endhint %} للمزيد من المعلومات حول شروط العمل، تفضل بزيارة . ## كيفية إعداد Salebot ### كيفية الربط للاتصال بـ wallenone تحتاج إلى الانتقال إلى قسم "أنظمة الدفع" !!!! بعد ذلك، ما عليك سوى إدخال البيانات المذكورة أعلاه في النموذج. !!!! اكتمل الاتصال. والآن لنتعرف على كيفية استخدام هذه الميزة. #### تحديد المبلغ لإنشاء رابط للدفع، تحتاج إلى تعيين قيمة المتغير payment\_sum، ثم يظهر المتغير walletone\_pay\_url. يمكن عرض هذا المتغير كرابط أو وضعه على الزر مع النص "ادفع". الرابط هو: ; #### تحديد العملة يقبل Walletone المدفوعات بعدة عملات، وبشكل افتراضي يتم إنشاء الدفع بالروبل. لتحديد عملة أخرى، تحتاج إلى تعيين قيمة المتغير currency. يقبل المتغير القيم التالية: UAH RUB BYN USD TJS KZT EUR PLN ZAR على سبيل المثال، كما في لقطة الشاشة أدناه، لتحديد عملة الهريفنيا، يمكنك تعيين هذا المتغير في إعدادات المشروع. !!!! #### وصف الدفع يمكنك إضافة وصف للدفع، وسيتم عرضه في رأس نموذج الدفع. !!!! الوصف مأخوذ من المتغير payment\_description {% hint style="warning" %} يجب أن يكون الوصف باللغة اللاتينية فقط! {% endhint %} #### معالجة النتيجة {% hint style="info" %} بعد الدفع الناجح أو غير الناجح، سيتم ملء الروبوتات بردود نداء، حتى تتمكن من فهم أن عملية الدفع تمت بنجاح. هذه الردود في النظام تراها كرسائل من المستخدم بحيث لا يمكن للمستخدم إرسالها، وهي تتكون من مفتاح walletone وسجل بالحالة، على سبيل المثال: 793638786d31756066695a7a7b42673939684e4e74493233444353\_success أو 793638786d317566665c5a7b42673968684e4e74493233444353\_fail. كذلك، بعد الدفع الناجح، يتم تعيين المتغير walletone\_payment\_completed إلى True. هذه الردود لا يراها المستخدم، بل تُعرض فقط للمشغّل {% endhint %} {% hint style="danger" %} يجب أن يكون نوع المطابقة "Full match" {% endhint %} {% hint style="warning" %} لإجراء دفعة متكررة، يجب إعادة تعيين payment\_sum، والرابط الذي تم إنشاؤه مسبقًا، وبعد إعادة تعيين المتغير payment\_sum ستحصل على رابط جديد {% endhint %} بعد اكتمال الدفع، ستتم إضافة المتغير walletone\_callback\_data إلى العميل، وهو يحتوي على بيانات استجابة نظام الدفع للمعاملة المكتملة. يمكنك استخراج البيانات المطلوبة من القاموس باستخدام طريقة get. ## مثال مثال على مخطط سيسمح لك بالبدء السريع في اختبار العمل مع Walletone. !!! يوضح الشكل مثالًا للكتلة الأولى، حيث يسأل المستخدم عن المبلغ الذي يريد دفعه. أسفل إعداد السهم، يجب تفعيل المفتاح "المستخدم يدخل البيانات" وإدخال المتغير payment\_sum في الحقل. !!!! لاحظ أن المتغير #{walletone\_pay\_url} يتم إدراجه تحت "إعداد المرفقات". !!! ثم يمكنك إنشاء تفرّع إلى كتلتين (أو إنشاء كتل خضراء بشروط). في إحدى الحالتين، في الشرط الذي يتم فيه تحديد qxgZ7zkNX4HnG8UpZ61\_success، وفي الثانية: qxgZ7zkNX4HnG8UpZ61\_ - فشل فشل الدفع الناجح. {% hint style="info" %} تحقق من النوع، وتأكد من وضع "تطابق كامل"، وإلا فإن الشروط ستعمل على كلا الردين callback. {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/ar/integrations/payment/walletone.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.