INXY payments
التسجيل
بعد التسجيل في الخدمة https://auth.inxy.io/ اذهب إلى قائمة واجهة برمجة تطبيقات بوابة الدفع واملأ المعلومات التالية:
اسم المحفظة ووصفها، والأيقونة.
يتم وضع رابط الموقع الإلكتروني حسب طلبك.
يجب تحديد جميع أنواع العملات المشفرة المقبولة ثم النقر على حفظ التغييرات
بعد الحفظ، سيفتح حقل بيانات الاتصال.
بعد ذلك، أنشئ مفتاح API بالنقر على Generate(1) وأدخل الرمز المرسل إلى بريدك الإلكتروني.
يجب حفظ المتغير الذي تم استلامه في مكان آمن. وانسخ هناك أيضًا Secret Key.
يمكن إعادة إنشاء المفاتيح في حالة فقدانها (إذا حدث ذلك، فلا تنسَ تغيير البيانات في المشروع).
في حقل Postback Url (2)، حدّد عنوان url للـ webhooks https://chatter.salebot.pro/inxy_callback/result
إعدادات الاتصال
ثم انتقل إلى Mavibot → قسم "Acquiring" → INXY وانقر على connect. أدخل مفاتيح API و Secret المستلمة في الحقول.
إنشاء رابط دفع
لإنشاء رابط دفع، تحتاج إلى تعيين قيمة المتغير payment_sum (على سبيل المثال، 1). بعد ذلك سيظهر المتغير inxy_pay_url. يمكن عرض هذا المتغير كرابط أو وضعه في زر "Pay".
انتبه!!! النظام يعمل بالدولار! سيتم قبول المبلغ المحدد في 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. وأسفل ذلك في إجمالي مبلغ العملات المشفرة - توجد القيمة بالعملة المشفرة المحددة. وتتغير كثيرًا حسب سعر الصرف الحالي. هذه هي القيمة التي يحتاج العميل إلى دفعها لك من محفظته.
انتبه!!! عنوان المحفظة للدفع، ضمن جلسة واحدة، محجوز للعميل لمدة ساعتين فقط. ننصح العميل بالتأكد من أن الوقت لم ينتهِ وأن عنوان المحفظة لا يزال صالحًا وقت الدفع. إذا انتهى وقت الجلسة، فستحتاج إلى إعادة بدء عملية الدفع.
معالجة نتيجة الدفع (callback الدفع)
بعد نجاح الدفع، سيتم إرسال callback إلى البوت، والذي سيخبرك بأن الدفع كان ناجحًا. سترى هذا الـ callback في النظام كرسالة من المستخدم، بحيث لا يمكن للمستخدم إرسالها. هذا الـ callback لا يراه المستخدم نفسه، بل يظهر فقط للمشغّل. لدى INXY عدة أنواع من الـ callbacks:
تتكون الـ callbacks الناجحة من أول 10 أحرف من الرمز واللاحقة success، على سبيل المثال: uc8zsjNN1x_success
يتم استلام هذا الـ callback إذا دفع العميل المبلغ بالكامل ولا توجد مشكلات في الدفع. مع هذا الـ callback، inxy_payment_completed سيتم إضافة المتغير إلى متغيرات المشروع، وسيكون مضبوطًا على True. وكذلك inxy_payment_status سيأخذ المتغير القيمة paid.
يمكن أن يغيّر المتغير inxy_payment_status قيمته طوال فترة معالجة الدفع بالكامل. بعد أن يفتح المستخدم النموذج، سيأخذ حالة waiting_payment، ثم أثناء معالجة دفعه سيأخذ القيمة waiting_confirmation، وبعد المعالجة الناجحة ستكون قيمته paid أو partially_paid.
عند معالجة callback، يجب أن يكون نوع المقارنة "Exact Match".
على سبيل المثال، يمكنك معالجة الدفع الناجح داخل كتلة شرطية وعرض الرسالة المناسبة للمستخدم:
2. توجد حالات يتغير فيها سعر صرف العملات المشفرة أو تقتطع المحفظة عمولة من العملية، ونتيجة لذلك يتم إيداع مبلغ غير كامل في حسابك. في هذه الحالة، سيأخذ المتغير inxy_payment_status القيمة partially_paid وسيتم إرسال callback إلى النظام.
في هذه الحالة، ستحتاج إلى إرسال إشعار إلى العميل يطلب دفع المبلغ المتبقي.
على سبيل المثال، يمكنك تعيين شرط لبدء الـ callback، وبعد الحصول عليه، إرسال الرابط الذي تم إنشاؤه مسبقًا مع رابط الدفع إلى العميل مرة أخرى، أو تعيين شرط يتم فيه تشغيل الكتلة عندما يكون المتغير 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 هو شهر افتراضيًا)
عند اتباع الرابط، سيرى المستخدم صفحة الدفع نفسها، ولكن مع بعض الاختلافات: أولًا، ستكون هناك ملاحظة على الجانب تشير إلى أن الدفع جزء من اشتراك بالتكرار المحدد؛ وثانيًا، ستعرض صفحة الدفع على العميل خيار دفع مبلغين أو ثلاثة مقدمًا.
Fميزات نظام الدفع INXY: إذا دفع العميل x2 أو x3 من المبلغ، فسيستلم Mavibot إشعارًا بالدفع لأحدها فقط. سيتم إرسال المبلغ المتبقي إلى رصيد العميل، ومن هناك سيتم خصم المبلغ في عمليات الخصم اللاحقة. وبما أن سعر صرف العملات المشفرة يتغير باستمرار، فقد لا يكون هذا المبلغ كافيًا للخصم اللاحق، مما سيؤدي إلى حالة اشتراك غير مدفوع بالكامل. في هذه الحالة، ستتلقى callback "fail" ويمكنك إعداد تذكير للعميل.
لا يمكن أن يكون هناك دفع جزئي وفقًا للجدول. يتم التحقق من الرصيد قبل الدفع، وإذا لم يكن الرصيد كافيًا، فإن المال لن يتم خصمه من حساب العميل.
بعد نجاح الاشتراك، سيظهر المتغير inxy_subscription_id في متغيرات العميل، مشيرًا إلى رقم الاشتراك و inxy_subscription_status مع حالته.
إلغاء الاشتراك
لإلغاء اشتراكك، استخدم الدالة inxy_remove_subscription(inxy_subscription_id). أدخل معرّف الاشتراك inxy_subscription_id في الدالة، وسيتم إلغاء الاشتراك.
في حالة النجاح، ستحصل على callback ‘Subscription status inxy_subscription_id - deleted’ و inxy_subscription_status سيتم تغيير المتغير إلى القيمة المناسبة.
آخر تحديث