برنامج الولاء للرمز الترويجي "Mavibot":

التعرفة 5%، بدون حد زمني وبدون الحاجة لتأكيد حالة العمل الحر.

من بين أمور أخرى، بدون رسوم إضافية وبدون عمولات، يمكنك الوصول فورًا إلى جميع ميزات الخدمة: الفواتير، الإيصالات، الاشتراك، تسليم الملفات بعد الدفع، أدوات البث المباشر، البرنامج التابع.

سيربط البرنامج التابع العملاء ويحقق إيرادات إضافية بنسبة 0.2% من معاملاتهم.

التسجيل

بعد التسجيل في الخدمة https://capusta.space/ ستظهر في إعدادات مشروعك البيانات التي تحتاجها:

رمز المشروع (project_code) - في المثال

هذا هو رمز testmavibot لواجهة API - 71b7d77f-7c77-77cb-7f7a-bbc7a17c1e77

بريدك الإلكتروني (الذي سجلت به) - [email protected]

بالإضافة إلى هذه البيانات، ستحتاج أيضًا إلى ملء النموذج في قسم "الإشعارات وإعادة التوجيه" تحت الرابط https://dev.capusta.space/#rec167335038 

بالنقر على الرابط، قم بالتمرير لأسفل قليلاً وستجد النافذة التالية:

!!!!!

استخدم الزر "تحديد URL" واملأ البيانات التالية في النموذج:

!!!!!!

إعداد الاتصال

لتوصيل نظام الدفع Capusta، ستحتاج إلى إدخال رمزك ورمز المشروع في إعدادات Mavibot. في mavibot نفتح قسم أنظمة الدفع، نختار capusta وندخل البيانات المستلمة.

إنشاء رابط الدفع

لإنشاء رابط الدفع، تحتاج إلى تعيين قيمة المتغير payment_sum (على سبيل المثال، 1000)، ثم يظهر المتغير capusta_pay_url. يمكن عرض هذا المتغير مع رابط أو وضعه على زر مع نص "دفع". يظهر الرابط على النحو التالي: https://capu.st/billfb22c773-3a0f أيضًا، قبل تعيين قيمة payment_sum، يمكنك تحديد المتغيرات الاختيارية التالية لتكوين الدفع: payment_description - وصف الدفع link_expired - عمر الرابط. يمكنك إدخال التاريخ بتنسيق dd.mm.yyyy hh:mm، على سبيل المثال: 03.04.2022 19:34. انتبه! يتم تشكيل الوقت حسب المنطقة الزمنية للمشروع. payment_comment - يمكنك السماح للمستخدم الدافع بترك تعليق على التحويل. test_payments - يمكنك إجراء دفعة اختبارية في Capusta إذا قمت بتعيين قيمة هذا المتغير إلى True. يمكنك معرفة المزيد حول البطاقات التي يمكنك تحديدها للمعاملات الاختبارية على الصفحة https://dev.capusta.space/#rec240878484

!!!!!!

مثال على رابط الدفع

إنشاء رابط لدفع 1 دولار (انتبه - المبلغ الأقل من 10 روبل لا يمر للدفع!)

!!!!!

ملاحظة: يتم تحديد المتغيرات الإضافية أولاً للإعدادات، ثم payment_sum.

يمكنك تعريف المتغيرات في وقت سابق في سلسلة، وليس في كتلة واحدة، هذا مثال.

بعد ذلك، في المكان المناسب، اطبع المتغير capusta_pay_url الذي يحتوي على الرابط

!!!!!

معالجة نتيجة الدفع (استدعاء حول الدفع)

بعد الدفع الناجح، سيصل في البوت استدعاء يمكنك من خلاله فهم أن هناك دفعة ناجحة. ترى هذه الاستدعاءات في النظام كرسائل من المستخدم، بحيث لا يمكن إرسالها من قبل المستخدم، وتتكون من أول 10 أحرف من الرمز وصفحة النجاح الرئيسية، على سبيل المثال: 71b7d77f-7_success هذه الاستدعاءات لا يراها المستخدم، بل تظهر فقط للمشغل. يجب أن يكون نوع المقارنة "مطابقة تامة" أيضًا، بعد الدفع الناجح، يتم تعيين المتغير capusta_payment_completed إلى true. على سبيل المثال، يمكنك إنشاء كتلة معالجة دفع ناجحة بشرط وطباعة الرسالة المناسبة للمستخدم:

!!!!!!

عند اكتمال الدفع، سيتم إضافة متغير capusta_callback_data إلى العميل يحتوي على بيانات استجابة نظام الدفع للمعاملة المكتملة. يمكنك استخراج البيانات اللازمة من القاموس باستخدام طريقة get.

إنشاء اشتراك

إنشاء الاشتراك متاح في capusta. للقيام بذلك، يجب عليك تعيين أي قيمة للمتغير capusta_subscription_payment، ثم سيتم إنشاء اشتراك شهري. إذا كنت ترغب في تحديد فترة أخرى، قم بإنشاء المتغير capusta_subscription_period وقم بتعيين إحدى القيم التالية: يوميًا - "DAILY"، أسبوعيًا - "WEEKLY"، شهريًا - "MONTHLY"، "SELECTIVELY" - اختيار المستخدم (في هذه الحالة، يختار الدافع تكرار الخصم) مثال (كيف يبدو الدفع عند استخدام القيمة "SELECTIVELY")

!!!!!

بعد اشتراك ناجح، سيظهر متغير العميل capusta_subscriber_id، مشيرًا إلى رقم المشترك في نظام Capusta.

!!!!!

إلغاء الاشتراك

لإلغاء اشتراك موجود، يجب عليك استخدام الدالة capusta_remove_subscription(capusta_subscriber_id)، التي تأخذ كمدخل نفس رقم مشترك capusta. بعد تشغيل الدالة، سيتم مسح المتغير capusta_subscriber_id وسيتم إلغاء الاشتراك.

!!!!!