# Capusta.space {% hint style="info" %} برنامج ولاء للرمز الترويجي **"Salebot"**: التعرفة 5 بالمئة، دون حدّ زمني ودون الحاجة إلى تأكيد حالة العمل الحر. ومن بين أمور أخرى، يمكنك دون رسوم إضافية ودون أي رسوم الوصول فورًا إلى جميع ميزات الخدمة: الفواتير، والفواتير الضريبية، والاشتراك، وتسليم الملفات بعد الدفع، وودجات البث، وبرنامج الشركاء. سيقوم برنامج الإحالة بربط العملاء وتوليد إيراد إضافي بنسبة 0.2% من معاملاتهم. {% endhint %} ## تسجيل بعد التسجيل في الخدمة في إعدادات مشروعك ستظهر البيانات التي تحتاجها: **رمز المشروع (project\_code)** - في المثال **هذا هو رمز testsalebot لـ API** - 71b7d77f-7c77-77cb-7f7a-bbc7a17c1e77 **بريدك الإلكتروني (الذي سجلت به)** - بالإضافة إلى هذه البيانات، ستحتاج أيضًا إلى تعبئة النموذج في قسم "الإشعارات وإعادة التوجيه" عبر الرابط ; عند النقر على الرابط، مرّر قليلًا إلى الأسفل وابحث عن النافذة التالية: !!!!! استخدم الزر "تحديد الرابط" واملأ البيانات التالية في النموذج: * بريد تسجيل الدخول الخاص بك في حساب Capusta.space * آخر 4 أرقام من البطاقة المرتبطة * - رابط callback * - رابط النجاح * - رابط الفشل !!!!!! ## إعداد الاتصال للاتصال بنظام الدفع Capusta، ستحتاج إلى إدخال الرمز المميز ورمز المشروع في إعدادات Salebot. في Salebot نفتح قسم أنظمة الدفع، ونختار Capusta، وندخل البيانات المستلمة. ![](/files/e3bd4c049a6cfb3a5d94e1c028da349d6492fc2a) ## إنشاء رابط للدفع لإنشاء رابط للدفع، تحتاج إلى تعيين قيمة المتغير payment\_sum (على سبيل المثال، 1000)، وبعد ذلك سيظهر المتغير capusta\_pay\_url. يمكن عرض هذا المتغير كرابط أو وضعه على زر بالنص "ادفع". يظهر الرابط كما يلي: . كذلك، قبل تعيين قيمة payment\_sum، يمكنك تحديد المتغيرات الاختيارية التالية لإعداد الدفع: payment\_description - وصف الدفع، link\_expired - مدة صلاحية الرابط. يمكنك إدخال التاريخ بالتنسيق dd.mm.yyyyyyyyyyyyyyyyy hh:mm، على سبيل المثال: â 03.04.2022 19:34'. انتباه! يتم احتساب الوقت وفق المنطقة الزمنية للمشروع. payment\_comment - يمكنك السماح للمستخدم الدافع بترك تعليق على الترجمة. test\_payments - يمكنك إجراء دفعة تجريبية في Capusta إذا عيّنت قيمة هذا المتغير إلى True. يمكنك معرفة المزيد حول البطاقات التي يمكنك تحديدها للمعاملات التجريبية على صفحة https\:/dev.capusta.space/#rec240878484 !!!!!! ### مثال على رابط للدفع إنشاء رابط لدفع 1 دولار (انتبه - المبالغ الأقل من 10 روبلات لا تمر إلى الدفع!) !!!!! {% hint style="info" %} ملاحظة: أولًا تُحدَّد المتغيرات الإضافية للإعدادات، ثم payment\_sum. {% endhint %} يمكنك تعريف المتغيرات مسبقًا في سلسلة، وليس في كتلة واحدة، هذا مثال. بعد ذلك، في المكان المناسب، اطبع المتغير capusta\_pay\_url، الذي يحتوي على الرابط !!!!! ## معالجة نتيجة الدفع (callback حول الدفع) بعد الدفع الناجح في البوت سيصل callback، وبواسطته يمكنك فهم أنه حدث دفع ناجح. هذه callbacks في النظام تراها كرسائل من المستخدم، لذلك لا يمكن أن يرسلها المستخدم، وهي تتكون من أول 10 أحرف من الرمز المميز وكلمة success في البداية، على سبيل المثال: 71b7d77f-7\_success. هذه callbacks لا يراها المستخدم، بل تُعرض فقط للمشغّل. يجب أن يكون نوع المطابقة "تطابق كامل". كذلك، بعد الدفع الناجح، يتم تعيين المتغير capusta\_payment\_completed إلى true. على سبيل المثال، يمكنك إنشاء كتلة لمعالجة الدفع الناجح بشرط وطباعة الرسالة المناسبة للمستخدم: !!!!!! عند اكتمال الدفع، ستتم إضافة المتغير capusta\_callback\_data إلى العميل، وهو يحتوي على بيانات استجابة نظام الدفع للمعاملة المكتملة. يمكنك استخراج البيانات المطلوبة من القاموس باستخدام طريقة get. ## إنشاء اشتراك إنشاء الاشتراك متاح في Capusta. للقيام بذلك، يجب أن تعيّن أي قيمة للمتغير capusta\_subscription\_payment، وبعد ذلك سيتم إنشاء اشتراك شهري. إذا كنت تريد تحديد فترة أخرى، فأنشئ المتغير capusta\_subscription\_period وعيّن له أحد القيم التالية: daily - "DAILY"، weekly - "WEEKLY"، monthly - "MONTHLY"، و"SELECTIVELY" هو خيار المستخدم (في هذه الحالة، يختار الدافع وتيرة الخصم) مثال (كيف يبدو الدفع عند استخدام القيمة "SELECTIVELY") !!!!! بعد اشتراك ناجح، سيظهر متغير العميل capusta\_subscriber\_id، والذي يشير إلى رقم المشترك في نظام Capusta. !!!!! ## إلغاء الاشتراك من أجل إلغاء اشتراك موجود، يجب استخدام الدالة capusta\_remove\_subscription(capusta\_subscriber\_id)، التي تأخذ كمدخل نفس رقم المشترك في cabbage. بعد تشغيل الدالة، سيتم تفريغ المتغير capusta\_subscriber\_id وسيتم إلغاء الاشتراك. !!!!! --- # 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/capusta.space.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.