# INXY Payments
## التسجيل
بعد التسجيل في خدمة انتقل إلى Payment gateway API في قائمة الجانب الأيسر واملأ البيانات التالية - اسم ووصف المحفظة والأيقونة. الرابط إلى موقعك اختياري. حدّد جميع العملات المشفّرة التي تريد قبولها باستخدام مربع اختيار ثم انقر حفظ التغييرات
بعد الحفظ، ستفتح النافذة التي تحتوي على بيانات الاتصال. بعد ذلك أنشئ مفتاح API بالضغط على زر Generate (1) وأدخل الرمز الذي تم إرساله إلى بريدك الإلكتروني. احفظ المتغير الناتج في مكان آمن. انسخ Secret Key المُنشأ في المكان نفسه. يمكن إعادة إنشاء المفاتيح في حال فقدانها (في هذه الحالة، تذكّر تغيير البيانات في المشروع). أدخل عنوان URL الخاص بالويب هوكس في حقل Postback URL (2).
## إعداد الاتصال
ثم انتقل إلى Salebot — أنظمة الدفع — INXY واضغط على زر Connect. أدخل مفاتيح API وSecret المستلمة في الحقول.
لقطة شاشة للاتصال من Salebot
## إنشاء رابط الدفع
لإنشاء رابط الدفع أدخل قيمة المتغير payment\_sum (مثلاً: 1)، وبعد ذلك سيظهر المتغير inxy\_pay\_url. يمكنك إضافة هذا المتغير على الشاشة كرابط أو وضعه في زر الدفع.
{% hint style="warning" %} **ملاحظة!** النظام يعمل بالدولار الأمريكي USD! المبلغ في المتغير payment\_sum يُعتبر بالدولار الأمريكي في نظام الدفع INXY.
{% endhint %}
يبدو الرابط هكذا:
أيضًا، **قبل إدخال المبلغ للمتغير payment\_sum**، يمكنك إدخال ما يلي **الاختيارية** لإعداد الدفع\
**inxy\_currency** — العملة المشفّرة التي ستُستخدم للدفع. يمكنك إدخال إحدى العملات المشفّرة المتاحة التي اخترتها عبر مربع الاختيار أثناء إنشاء مفتاح API. إذا تُركت فارغة، فسيختار اللاعبون العملة المشفّرة بأنفسهم من قائمة العملات المختارة. القيم المتاحة: ‘BTC’,‘ETH’,‘LTC’,‘DOGE’,‘USDT’,‘USDC’,‘DAI’
**inxy\_description** – وصف الدفع.
{% hint style="warning" %} **ملاحظة!** أولاً تُدخل المتغيرات الاختيارية للإعداد، ثم payment\_sum.
{% endhint %}
يمكن إدخال المتغيرات في وقت أبكر ضمن السلسلة، وليس في كتلة واحدة. أما المتغير inxy\_pay\_url، الذي يتضمن الرابط، فيجب أن يُعرض في المكان الصحيح. هذا الرابط يفتح نموذج الدفع.
{% hint style="warning" %} **ملاحظة!** يعرض سطر Total amount القيمة بالدولار الأمريكي، وهي مساوية لـ payment\_sum. ويعرض سطر Total crypto amount أدناه القيمة بالعملة المشفّرة المختارة. وتتغير هذه القيمة وفقًا لسعر الصرف الحالي. هذا هو المبلغ الذي يجب على عميلك دفعه من محفظته.
{% endhint %}
{% hint style="warning" %} **ملاحظة!** عنوان المحفظة للدفع خلال جلسة واحدة يكون محجوزًا للعميل فقط لمدة ساعتين. نوصي بأن يتأكد العميل من أن الوقت لم ينتهِ وأن عنوان المحفظة لا يزال صالحًا عند إجراء الدفع. إذا انتهى وقت الجلسة — يجب البدء من جديد بعملية الدفع بالكامل.
{% endhint %}
## ردّ الدفع
بعد نجاح الدفع سيتلقى البوت ردًا يُخبرك بأن الدفع تم بنجاح. سترى هذا الرد في النظام كرسالة من المستخدم، لذلك لا يمكن للمستخدم إرساله. المستخدمون أنفسهم لا يمكنهم رؤية الرد، بل يستطيع المشغّل فقط رؤيته. لدى INXY عدة أنواع من الردود:
1. تتكوّن ردود النجاح من أول 10 رموز من التوكن متبوعة بكلمة ‘success’، مثلاً: uc8zsjNN1x\_success
يُرسل هذا الرد إذا دفع العميل المبلغ كاملًا ولم تحدث أي مشاكل أثناء عملية الدفع. إلى جانب هذا الرد ستُضاف متغيرات اثنتان إلى المشروع: inxy\_payment\_completed تساوي True؛ و **inxy\_payment\_status** بالقيمة المدفوعة.
{% hint style="warning" %}
أثناء العملية **inxy\_payment\_status** يتغير المتغير في قيمته. بعد أن يفتح المستخدم النموذج سيتغير إلى waiting\_payment، وأثناء معالجة الدفع سيتغير إلى waiting\_confirmation، وبعد المعالجة الناجحة ستكون قيمته paid أو partially\_paid.
{% endhint %}
أثناء معالجة الرد يجب أن يكون نوع المقارنة Full match. مثلاً: يمكنك تنفيذ معالجة الدفع الناجحة ككتلة بشرط وإظهار رسالة مناسبة للمستخدم:
2\. أحيانًا تتغير أسعار صرف العملات المشفّرة أو تقتطع المحافظ رسومًا إضافية من العمليات، بحيث لا يكون المبلغ الذي استلمته كاملًا. في مثل هذه الحالات ستكون قيمة المتغير inxy\_payment\_status هي partially\_paid وسيستقبل النظام ردًا يبدو هكذا:
\
في هذه الحالة سيتعين عليك مراسلة العميل وطلب تغطية المبلغ الناقص. مثلاً: يمكنك تعيين شرط لبداية الرد الخاص بك، وعند استلامه ترسل للعميل رابطًا مُنشأً مسبقًا مع رابط دفع، أو يمكنك تعيين شرط بأن تُفعّل الكتلة عندما تكون قيمة المتغير inxy\_payment\_status هي **partially\_paid**.
{% hint style="warning" %}
تذكّر أن رابط الدفع صالح لمدة ساعتين فقط! إذا لم يقم العميل بدفع المبلغ الناقص في الوقت المناسب، فلن يمكن فتحه. وبما أن INXY في هذه المرحلة سيعالج الدفعة الجزئية الأولى، فلن تعود الأموال إلى العميل. لإعادتها ستحتاج إلى الانتقال إلى حساب INXY الخاص بك وإجراء عملية الاسترجاع.
{% endhint %}
## إنشاء اشتراك
يتيح نظام 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 يساوي الشهر افتراضيًا)
سيفتح الرابط أيضًا نموذج الدفع لكنه سيكون مختلفًا: أولًا، سيظهر على الجانب أن الدفع قائم على الاشتراك مع عرض الفترة، ثانيًا، سيقترح النموذج على العميل إضافة إيداع لعدة دفعات مسبقًا.
{% hint style="warning" %}
**خصائص INXY**: إذا دفع العميل x2 أو x3 من المبلغ، فسيستقبل Salebot رسالة عن مبلغ واحد. وسيُودَع الباقي في رصيد العملاء، وسيُستخدم للمدفوعات القادمة. وبما أن سعر صرف العملة المشفّرة يتغير، فقد لا يكفي هذا المبلغ في النهاية لإحدى المدفوعات التالية، مما يؤدي إلى اشتراك غير مدفوع. في مثل هذه الحالة، ستتلقى ردًا يذكر ‘fail’ ويمكنك إعداد تذكير لعميلك.
{% endhint %}
{% hint style="warning" %}
لا يمكن دفع الاشتراك جزئيًا. يتم التحقق من رصيد العميل قبل الدفع. إذا لم تكن هناك أموال كافية فلن يتم الدفع إطلاقًا.
{% endhint %}
بعد نجاح الاشتراك ستتضمن متغيرات العميل inxy\_subscribtion\_id (رقم مرجعي) و inxy\_subscription\_status.
## إلغاء الاشتراك
لإلغاء اشتراك، استخدم الدالة التالية **inxy\_remove\_subscription(inxy\_subscription\_id)**. أدخل رقم معرّف الاشتراكات كـ inxy\_subscribtion\_id في الدالة وسيتم إلغاء الاشتراك.
في حال النجاح ستتلقى ردًا ‘Subscription status inxy\_subscription\_id - deleted’ وسيتغير المتغير inxy\_subscription\_status إلى القيمة المناسبة.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.mavibot.ai/doc/ar/integrations/payment/inxy.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.