التسجيل
بعد التسجيل في الخدمة https://auth.inxy.io/ انتقل إلى قائمة واجهة برمجة تطبيقات بوابة الدفع واملأ المعلومات التالية:
- اسم المحفظة ووصفها وأيقونتها.
- يتم وضع رابط الموقع الإلكتروني حسب طلبك.
يجب تحديد جميع أنواع العملات المشفرة المقبولة والنقر على حفظ التغييرات
بعد الحفظ، سيتم فتح حقل بيانات الاتصال.
بعد ذلك، قم بإنشاء مفتاح API بالنقر على إنشاء(1) وأدخل الرمز المرسل إلى بريدك الإلكتروني.
يجب تخزين المتغير المستلم في مكان آمن. قم أيضًا بنسخ المفتاح السري هناك.
يمكن إعادة إنشاء المفاتيح في حالة فقدانها (إذا حدث ذلك، لا تنس تغيير البيانات في المشروع).
في حقل Postback Url (2)، حدد عنوان url للويبهوكس https://chatter.salebot.pro/inxy\\_callback/result
إعدادات الاتصال
ثم انتقل إلى Mavibot → قسم "الاستحواذ" → INXY وانقر على اتصال. أدخل مفاتيح API والسرية المستلمة في الحقول.
إنشاء رابط الدفع
لإنشاء رابط دفع، تحتاج إلى تعيين قيمة متغير payment_sum (على سبيل المثال، 1). بعد ذلك، سيظهر متغير inxy_pay_url. يمكن عرض هذا المتغير مع رابط أو وضعه في زر "الدفع".
انتبه!!! النظام يعمل بالدولار! سيتم اعتبار المبلغ المحدد في payment_sum من قبل نظام دفع INXY كدولار.
يبدو الرابط كالتالي: https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1
أيضًا، قبل تعيين قيمة متغير payment_sum، يمكنك تعيين المتغيرات الاختيارية التالية لإعداد الدفع:
inxy_currency - العملة المشفرة التي سيتم بها الدفع.
يمكنك تحديد إحدى العملات المشفرة الممكنة التي حددتها عند إنشاء مفتاح API. إذا تركتها فارغة، فسيختار الدافع العملة المشفرة من تلك التي تم وضع علامة عليها..
القيم المتاحة: 'BTC', 'ETH', 'LTC', 'DOGE', 'USDT', 'USDC', 'DAI'
inxy_description – وصف الدفع
انتبه! أولاً، يتم تعيين المتغيرات الإضافية للإعدادات، ثم payment_sum.
يمكن تعيين المتغيرات في وقت مبكر في السلسلة، وليس كلها في كتلة واحدة. ويجب عرض متغير inxy_pay_url، الذي يحتوي على الرابط، في المكان المناسب. عند النقر عليه، سيتم فتح نموذج الدفع.
انتبه! يحتوي سطر المبلغ الإجمالي على قيمة دولارية تساوي payment_sum. أدناه في إجمالي المبلغ بالعملة المشفرة - هي القيمة بالعملة المشفرة المحددة. تتغير بشكل متكرر اعتمادًا على سعر الصرف الحالي. هذه هي القيمة التي يحتاج العميل إلى دفعها لك من محفظته.
انتبه!!! عنوان المحفظة للدفع، خلال جلسة واحدة، محجوز للعميل لمدة ساعتين فقط. نوصي العميل بالتأكد من أن الوقت لم ينته وأن عنوان المحفظة محدث وقت الدفع. إذا انتهت مدة الجلسة، فأنت بحاجة إلى إعادة تشغيل عملية الدفع.
معالجة نتيجة الدفع (رد الاتصال بالدفع)
بعد الدفع الناجح، سيتم إرسال رد اتصال إلى البوت، والذي سيخبرك بأن الدفع كان ناجحًا. ترى رد الاتصال هذا في النظام كرسالة من المستخدم، بحيث لا يمكن للمستخدم إرسالها. رد الاتصال هذا غير مرئي للمستخدم نفسه، يتم عرضه فقط للمشغل. لدى INXY عدة أنواع من ردود الاتصال:
- تتكون ردود الاتصال الناجحة من أول 10 أحرف من الرمز المميز والملحق الناجح، على سبيل المثال: uc8zsjNN1x_success
يتم استلام رد الاتصال هذا إذا قام العميل بدفع المبلغ بالكامل ولا توجد مشاكل في الدفع. إلى جانب رد الاتصال هذا، سيتم إضافة متغير inxy_payment_completed إلى متغيرات المشروع، والذي يتم تعيينه على True. وسيأخذ متغير inxy_payment_status القيمة paid.
يمكن لمتغير inxy_payment_status تغيير قيمته طوال فترة معالجة الدفع. بعد أن يفتح المستخدم النموذج، سيأخذ حالة waiting_payment، ثم أثناء معالجة دفعه سيأخذ قيمة waiting_confirmation، وبعد المعالجة الناجحة سيكون له القيمة paid أو partially_paid.
عند معالجة رد الاتصال، يجب أن يكون نوع المقارنة "مطابقة تامة".
على سبيل المثال، يمكنك معالجة الدفع الناجح في كتلة شرطية وعرض الرسالة المقابلة للمستخدم:
2. هناك حالات يتغير فيها سعر صرف العملة المشفرة أو تسحب المحفظة عمولة من العملية، ونتيجة لذلك يتم إيداع مبلغ غير كامل في حسابك. في هذه الحالة، سيأخذ متغير inxy_payment_status القيمة partially_paid وسيتم إرسال رد اتصال إلى النظام.
في هذه الحالة، ستحتاج إلى إرسال إشعار إلى العميل يطلب دفعة إضافية.
على سبيل المثال، يمكنك تعيين شرط لبدء رد الاتصال وبعد الحصول عليه، إرسال الرابط الذي تم إنشاؤه بالفعل مع رابط الدفع إلى العميل مرة أخرى، أو تعيين شرط يتم تشغيل الكتلة عندما يكون متغير inxy_payment_status مساويًا لـ partially_paid.
يرجى ملاحظة أن رابط الدفع صالح فقط لمدة ساعتين! إذا لم يكن لدى العميل الوقت لدفع الجزء المتبقي، فلن يتمكن من فتحه بعد الآن. نظرًا لأن INXY ستعالج بالفعل الدفعة الأولى غير المكتملة في هذه المرحلة، فلن يتم رد الأموال إلى العميل. لإعادتها، ستحتاج إلى الانتقال إلى حسابك الشخصي في INXY وإجراء عملية رد.
إنشاء اشتراك
يمكن إنشاء الاشتراكات في نظام INXY. للقيام بذلك، قم بتعيين أي قيمة لمتغير inxy_subscription_payment، ثم سيتم إنشاء اشتراك شهري.
إذا كنت تريد تحديد فترة مختلفة، استخدم المتغيرات التالية: inxy_subscription_interval يساوي 'day' - يحدد الفاصل الزمني بالأيام (افتراضيًا، هو شهر)
inxy_subscription_period - حدد متغيرًا من 1 إلى 30 لتعيين التكرار.
على سبيل المثال، لإنشاء رسوم اشتراك مرة كل 15 يومًا، تحتاج إلى تعيين inxy_subscription_interval =’day’ و inxy_subscription_period=15، ولتحصيل الدفع كل ستة أشهر، تحتاج فقط إلى تحديد inxy_subscription_period=6 (نظرًا لأن inxy_subscription_interval هو شهر افتراضيًا)
عند اتباع الرابط، سيرى المستخدم نفس صفحة الدفع، ولكن مع بعض الاختلافات: أولاً، سيكون هناك ملاحظة على الجانب تشير إلى أن الدفع جزء من اشتراك بالتكرار المحدد؛ وثانيًا، ستقدم صفحة الدفع للعميل خيار دفع مبلغين أو ثلاثة مقدمًا.
ميزات نظام دفع INXY: إذا دفع العميل x2 أو x3 من المبلغ، سيتلقى Mavibot إشعارًا بالدفع لواحد منهم فقط. سيتم إرسال المبلغ المتبقي إلى رصيد العميل، حيث سيتم سحب المبلغ في الخصومات اللاحقة. نظرًا لأن سعر صرف العملة المشفرة يتغير باستمرار، ونتيجة لذلك، قد لا يكون هذا المبلغ كافيًا للخصم اللاحق، مما سيؤدي إلى حالة اشتراك غير مدفوع بالكامل. في هذه الحالة، ستتلقى رد اتصال "fail" ويمكنك إعداد تذكير للعميل.
لا يمكن أن يكون هناك دفع جزئي وفقًا للجدول الزمني. يتم التحقق من الرصيد قبل الدفع، وإذا لم يكن الرصيد كافيًا، لن يتم خصم الأموال من حساب العميل.
بعد الاشتراك الناجح، سيظهر متغير inxy_subscription_id في متغيرات العميل، مشيرًا إلى رقم الاشتراك و inxy_subscription_status مع حالته.
إلغاء الاشتراك
لإلغاء اشتراكك، استخدم الوظيفة inxy_remove_subscription(inxy_subscription_id). أدخل معرف الاشتراك inxy_subscription_id في الوظيفة، وسيتم إلغاء الاشتراك.
في حالة النجاح، ستتلقى رد اتصال ‘حالة الاشتراك inxy_subscription_id - تم الحذف’ وسيتغير متغير inxy_subscription_status إلى القيمة المناسبة.
