# INXY payments

## التسجيل

بعد التسجيل في الخدمة [https://auth.inxy.io/ ](<https://auth.inxy.io/ >) اذهب إلى قائمة واجهة برمجة تطبيقات بوابة الدفع واملأ المعلومات التالية:

1. اسم المحفظة ووصفها، والأيقونة.
2. يتم وضع رابط الموقع الإلكتروني حسب طلبك.

يجب تحديد جميع أنواع العملات المشفرة المقبولة ثم النقر على حفظ التغييرات

<figure><img src="/files/685a5d286c435c995f9d773b26d9c885d92f78f7" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/b35d94a149d0f520bb3ba42562be8e17be41ab35" alt=""><figcaption></figcaption></figure>

بعد الحفظ، سيفتح حقل بيانات الاتصال.

بعد ذلك، أنشئ مفتاح API بالنقر على Generate(1) وأدخل الرمز المرسل إلى بريدك الإلكتروني.

يجب حفظ المتغير الذي تم استلامه في مكان آمن. وانسخ هناك أيضًا Secret Key.

{% hint style="success" %}
يمكن إعادة إنشاء المفاتيح في حالة فقدانها (إذا حدث ذلك، فلا تنسَ تغيير البيانات في المشروع).
{% endhint %}

في حقل Postback Url (2)، حدّد عنوان url للـ webhooks <https://chatter.salebot.pro/inxy\\_callback/result>

<figure><img src="/files/46147e3adbd711b25e154c19a4ee360407ada162" alt=""><figcaption></figcaption></figure>

## إعدادات الاتصال&#x20;

ثم انتقل إلى Mavibot → قسم "Acquiring" → INXY وانقر على <mark style="background-color:blue;">**connect**</mark>. أدخل مفاتيح API و Secret المستلمة في الحقول.

<figure><img src="/files/47e8b2cacaa9913f2341f77a2f314abd6c66cc40" alt=""><figcaption><p>قسم "Acquiring" في Mavibot </p></figcaption></figure>

<figure><img src="/files/b50aabc63e3b653e6835cdd19e4e64aff018e201" alt=""><figcaption><p>إعدادات INXY في قسم "Acquiring" في Mavibot</p></figcaption></figure>

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

لإنشاء رابط دفع، تحتاج إلى تعيين قيمة المتغير payment\_sum (على سبيل المثال، 1). بعد ذلك سيظهر المتغير inxy\_pay\_url. يمكن عرض هذا المتغير كرابط أو وضعه في زر "Pay".

{% hint style="warning" %} <mark style="color:red;">**انتبه!!!**</mark> النظام يعمل بالدولار! سيتم قبول المبلغ المحدد في payment\_sum بواسطة نظام الدفع INXY على أنه دولارات.
{% endhint %}

يبدو الرابط كالتالي: [https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1 ](https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1)

أيضًا، **قبل تعيين قيمة المتغير payment\_sum**، يمكنك تعيين المتغيرات التالية **الاختيارية** لإعداد عملية الدفع:\
**inxy\_currency** - العملة المشفرة التي سيتم الدفع بها.

{% hint style="info" %}
يمكنك تحديد إحدى العملات المشفرة الممكنة التي قمت بتحديدها عند إنشاء مفتاح API. إذا تركته فارغًا، فسيختار الدافع العملة المشفرة من بين العملات التي تم تحديدها.&#x20;
{% endhint %}

القيم المتاحة: 'BTC', 'ETH', 'LTC', 'DOGE', 'USDT', 'USDC', 'DAI'

<figure><img src="/files/6c1bb3fce7b0aeb9bf5a2e1fddbca8d2d06c0fd5" alt=""><figcaption></figcaption></figure>

**inxy\_description** - وصف الدفع

<figure><img src="/files/cb97e90c5b3430cd5c3bf61b6a04dc5460f76d17" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:red;">**انتبه**</mark>! أولًا، يتم تعيين المتغيرات الإضافية للإعدادات، ثم payment\_sum.
{% endhint %}

يمكن تعيين المتغيرات في وقت سابق ضمن السلسلة، بدلًا من وضعها كلها في كتلة واحدة. ويجب عرض المتغير inxy\_pay\_url، الذي يحتوي على الرابط، في المكان المناسب. عند النقر عليه، سيفتح نموذج دفع.

<figure><img src="/files/68eb37249f08252e00594143ba1811bb24940939" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:red;">**انتبه!**</mark> يحتوي سطر المبلغ الإجمالي على قيمة بالدولار تساوي payment\_sum. وأسفل ذلك في إجمالي مبلغ العملات المشفرة - توجد القيمة بالعملة المشفرة المحددة. وتتغير كثيرًا حسب سعر الصرف الحالي. هذه هي القيمة التي يحتاج العميل إلى دفعها لك من محفظته.
{% endhint %}

<figure><img src="/files/5ee06ab46c06c436cb7db11b73ec0e57f9150b20" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:red;">**انتبه!!!**</mark> عنوان المحفظة للدفع، ضمن جلسة واحدة، محجوز للعميل لمدة ساعتين فقط. ننصح العميل بالتأكد من أن الوقت لم ينتهِ وأن عنوان المحفظة لا يزال صالحًا وقت الدفع. إذا انتهى وقت الجلسة، فستحتاج إلى إعادة بدء عملية الدفع.
{% endhint %}

## معالجة نتيجة الدفع (callback الدفع)

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

1. تتكون الـ callbacks الناجحة من أول 10 أحرف من الرمز واللاحقة success، على سبيل المثال: uc8zsjNN1x\_success

<figure><img src="/files/df34766b615612039a7f3e30bbf6b643382ceb4e" alt=""><figcaption><p>Callback دفع ناجح في محادثة مع العميل</p></figcaption></figure>

يتم استلام هذا الـ callback إذا دفع العميل المبلغ بالكامل ولا توجد مشكلات في الدفع. مع هذا الـ callback، **inxy\_payment\_completed** سيتم إضافة المتغير إلى متغيرات المشروع، وسيكون مضبوطًا على True. وكذلك **inxy\_payment\_status** سيأخذ المتغير القيمة paid.

{% hint style="warning" %}
يمكن أن يغيّر المتغير inxy\_payment\_status قيمته طوال فترة معالجة الدفع بالكامل. بعد أن يفتح المستخدم النموذج، سيأخذ حالة waiting\_payment، ثم أثناء معالجة دفعه سيأخذ القيمة waiting\_confirmation، وبعد المعالجة الناجحة ستكون قيمته paid أو partially\_paid.
{% endhint %}

عند معالجة callback، يجب أن يكون نوع المقارنة "Exact Match".

على سبيل المثال، يمكنك معالجة الدفع الناجح داخل كتلة شرطية وعرض الرسالة المناسبة للمستخدم:

<figure><img src="/files/78985635e4269e9a0f67433c1c2944578636480c" alt=""><figcaption></figcaption></figure>

2\. توجد حالات يتغير فيها سعر صرف العملات المشفرة أو تقتطع المحفظة عمولة من العملية، ونتيجة لذلك يتم إيداع مبلغ غير كامل في حسابك. في هذه الحالة، سيأخذ المتغير inxy\_payment\_status القيمة partially\_paid وسيتم إرسال callback إلى النظام.

<figure><img src="/files/0a9e0eab1496a21ab4080ca5675742ab88da6f8f" alt=""><figcaption></figcaption></figure>

في هذه الحالة، ستحتاج إلى إرسال إشعار إلى العميل يطلب دفع المبلغ المتبقي.

على سبيل المثال، يمكنك تعيين شرط لبدء الـ callback، وبعد الحصول عليه، إرسال الرابط الذي تم إنشاؤه مسبقًا مع رابط الدفع إلى العميل مرة أخرى، أو تعيين شرط يتم فيه تشغيل الكتلة عندما يكون المتغير inxy\_payment\_status مساويًا لـ partially\_paid.

<figure><img src="/files/ad4a5d7631541ad857faae1c371f5fec22f21e03" alt=""><figcaption></figcaption></figure>

{% 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 هو شهر افتراضيًا)

<figure><img src="/files/a97d7fe2983c4edec3251166cbfa86f399010698" alt=""><figcaption></figcaption></figure>

عند اتباع الرابط، سيرى المستخدم صفحة الدفع نفسها، ولكن مع بعض الاختلافات: أولًا، ستكون هناك ملاحظة على الجانب تشير إلى أن الدفع جزء من اشتراك بالتكرار المحدد؛ وثانيًا، ستعرض صفحة الدفع على العميل خيار دفع مبلغين أو ثلاثة مقدمًا.

{% hint style="warning" %}
F**ميزات نظام الدفع INXY:** إذا دفع العميل x2 أو x3 من المبلغ، فسيستلم Mavibot إشعارًا بالدفع لأحدها فقط. سيتم إرسال المبلغ المتبقي إلى رصيد العميل، ومن هناك سيتم خصم المبلغ في عمليات الخصم اللاحقة. وبما أن سعر صرف العملات المشفرة يتغير باستمرار، فقد لا يكون هذا المبلغ كافيًا للخصم اللاحق، مما سيؤدي إلى حالة اشتراك غير مدفوع بالكامل. في هذه الحالة، ستتلقى callback "fail" ويمكنك إعداد تذكير للعميل.
{% endhint %}

{% hint style="warning" %}
لا يمكن أن يكون هناك دفع جزئي وفقًا للجدول. يتم التحقق من الرصيد قبل الدفع، وإذا لم يكن الرصيد كافيًا، فإن المال **لن يتم خصمه** من حساب العميل.
{% endhint %}

<figure><img src="/files/6a12aa02751587f3e8bf031ec5b1bb2c4ce54d88" alt=""><figcaption></figcaption></figure>

بعد نجاح الاشتراك، سيظهر المتغير **inxy\_subscription\_id** في متغيرات العميل، مشيرًا إلى رقم الاشتراك و **inxy\_subscription\_status** مع حالته.

<figure><img src="/files/51857f0dc66793a29682ac6828ff6fdcdd7754d4" alt="" width="385"><figcaption></figcaption></figure>

## إلغاء الاشتراك

لإلغاء اشتراكك، استخدم الدالة **inxy\_remove\_subscription(inxy\_subscription\_id)**. أدخل معرّف الاشتراك inxy\_subscription\_id في الدالة، وسيتم إلغاء الاشتراك.

<figure><img src="/files/47fd3be312d0224e3a09202efc5f2095816d6afa" alt=""><figcaption></figcaption></figure>

في حالة النجاح، ستحصل على callback **‘Subscription status inxy\_subscription\_id - deleted’** و **inxy\_subscription\_status** سيتم تغيير المتغير إلى القيمة المناسبة.

<figure><img src="/files/9633f128014700c58a2e42e38db1a6b05fa496be" alt=""><figcaption></figcaption></figure>


---

# 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/aldfa/inxy-payments.md?ask=<question>
```

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.