INXY Payments

منصة معالجة العملات المشفرة مع ميزات متكررة

التسجيل

بعد التسجيل في خدمة https://auth.inxy.io/ انتقل إلى Payment gateway API في قائمة الجانب الأيسر واملأ البيانات التالية - اسم ووصف المحفظة والأيقونة. الرابط إلى موقعك اختياري. حدّد جميع العملات المشفّرة التي تريد قبولها باستخدام مربع اختيار ثم انقر حفظ التغييرات

بعد الحفظ، ستفتح النافذة التي تحتوي على بيانات الاتصال. بعد ذلك أنشئ مفتاح API بالضغط على زر Generate (1) وأدخل الرمز الذي تم إرساله إلى بريدك الإلكتروني. احفظ المتغير الناتج في مكان آمن. انسخ Secret Key المُنشأ في المكان نفسه. يمكن إعادة إنشاء المفاتيح في حال فقدانها (في هذه الحالة، تذكّر تغيير البيانات في المشروع). أدخل عنوان URL الخاص بالويب هوكس https://chatter.salebot.pro/inxy_callback/result في حقل Postback URL (2).

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

ثم انتقل إلى Salebot — أنظمة الدفع — INXY واضغط على زر Connect. أدخل مفاتيح API وSecret المستلمة في الحقول.

لقطة شاشة للاتصال من Salebot

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

لإنشاء رابط الدفع أدخل قيمة المتغير payment_sum (مثلاً: 1)، وبعد ذلك سيظهر المتغير inxy_pay_url. يمكنك إضافة هذا المتغير على الشاشة كرابط أو وضعه في زر الدفع.

ملاحظة! النظام يعمل بالدولار الأمريكي USD! المبلغ في المتغير 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، الذي يتضمن الرابط، فيجب أن يُعرض في المكان الصحيح. هذا الرابط يفتح نموذج الدفع.

ملاحظة! يعرض سطر Total amount القيمة بالدولار الأمريكي، وهي مساوية لـ payment_sum. ويعرض سطر Total crypto amount أدناه القيمة بالعملة المشفّرة المختارة. وتتغير هذه القيمة وفقًا لسعر الصرف الحالي. هذا هو المبلغ الذي يجب على عميلك دفعه من محفظته.

ملاحظة! عنوان المحفظة للدفع خلال جلسة واحدة يكون محجوزًا للعميل فقط لمدة ساعتين. نوصي بأن يتأكد العميل من أن الوقت لم ينتهِ وأن عنوان المحفظة لا يزال صالحًا عند إجراء الدفع. إذا انتهى وقت الجلسة — يجب البدء من جديد بعملية الدفع بالكامل.

ردّ الدفع

بعد نجاح الدفع سيتلقى البوت ردًا يُخبرك بأن الدفع تم بنجاح. سترى هذا الرد في النظام كرسالة من المستخدم، لذلك لا يمكن للمستخدم إرساله. المستخدمون أنفسهم لا يمكنهم رؤية الرد، بل يستطيع المشغّل فقط رؤيته. لدى INXY عدة أنواع من الردود:

1. تتكوّن ردود النجاح من أول 10 رموز من التوكن متبوعة بكلمة ‘success’، مثلاً: uc8zsjNN1x_success

يُرسل هذا الرد إذا دفع العميل المبلغ كاملًا ولم تحدث أي مشاكل أثناء عملية الدفع. إلى جانب هذا الرد ستُضاف متغيرات اثنتان إلى المشروع: inxy_payment_completed تساوي True؛ و inxy_payment_status بالقيمة المدفوعة.

أثناء العملية inxy_payment_status يتغير المتغير في قيمته. بعد أن يفتح المستخدم النموذج سيتغير إلى waiting_payment، وأثناء معالجة الدفع سيتغير إلى waiting_confirmation، وبعد المعالجة الناجحة ستكون قيمته paid أو partially_paid.

أثناء معالجة الرد يجب أن يكون نوع المقارنة Full match. مثلاً: يمكنك تنفيذ معالجة الدفع الناجحة ككتلة بشرط وإظهار رسالة مناسبة للمستخدم:

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 من المبلغ، فسيستقبل Salebot رسالة عن مبلغ واحد. وسيُودَع الباقي في رصيد العملاء، وسيُستخدم للمدفوعات القادمة. وبما أن سعر صرف العملة المشفّرة يتغير، فقد لا يكفي هذا المبلغ في النهاية لإحدى المدفوعات التالية، مما يؤدي إلى اشتراك غير مدفوع. في مثل هذه الحالة، ستتلقى ردًا يذكر ‘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 إلى القيمة المناسبة.