التسجيل
بعد التسجيل في خدمة https://auth.inxy.io/، انتقل إلى بوابة API للمدفوعات في القائمة الجانبية اليسرى واملأ البيانات التالية - اسم المحفظة ووصفها وأيقونتها. الرابط إلى موقعك اختياري. حدد جميع العملات المشفرة التي ترغب في قبولها باستخدام مربعات الاختيار وانقر على حفظ التغييرات
بعد الحفظ، ستظهر نافذة تحتوي على بيانات الاتصال. بعد ذلك، قم بإنشاء مفتاح API بالضغط على زر إنشاء (1) وأدخل الرمز المرسل إلى بريدك الإلكتروني. احفظ المتغير الناتج في مكان آمن. انسخ المفتاح السري الذي تم إنشاؤه في نفس المكان. يمكن إعادة إنشاء المفاتيح في حالة فقدانها (في هذه الحالة، تذكر تغيير البيانات في المشروع). أدخل عنوان URL للويبهوك https://chatter.salebot.pro/inxy\_callback/result في حقل عنوان URL للإرجاع (2).
إعداد الاتصال
ثم انتقل إلى Mavibot — أنظمة الدفع — INXY وانقر على زر الاتصال. أدخل مفاتيح API والمفتاح السري المستلمة في الحقول.
لقطة شاشة للاتصال من Mavibot
إنشاء رابط الدفع
لإنشاء رابط الدفع، أدخل قيمة متغير 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 رموز من الرمز المميز متبوعة بـ 'success'، مثال: 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: إذا دفع العميل ×2 أو ×3 من المبلغ، سيتلقى Mavibot رسالة حول مبلغ واحد. سيتم إيداع الباقي في رصيد العميل، وسيتم استخدامه للدفعات القادمة. نظرًا لأن سعر صرف العملة المشفرة يختلف، في النهاية قد لا يكون هذا المبلغ كافيًا لإحدى الدفعات التالية مما يؤدي إلى اشتراك غير مدفوع. في هذه الحالة، ستتلقى رد اتصال ينص على 'fail' ويمكنك إعداد تذكير لعميلك.
لا يمكن دفع الاشتراك جزئيًا. يتم التحقق من رصيد العميل قبل الدفع. إذا لم يكن هناك أموال كافية، لا يتم الدفع على الإطلاق.
بعد الاشتراك الناجح، ستتضمن متغيرات العميل inxy_subscribtion_id (الرقم المرجعي) و inxy_subscription_status.
إلغاء الاشتراك
لإلغاء اشتراك، استخدم الوظيفة التالية inxy_remove_subscription(inxy_subscription_id). أدخل رقم معرف الاشتراك كـ inxy_subscribtion_id في الوظيفة وسيتم إلغاء الاشتراك.
في حالة النجاح، ستتلقى رد اتصال 'Subscription status inxy_subscription_id - deleted' وسيتغير متغير inxy_subscription_status إلى القيمة المناسبة.
