# Fondy

* [كيفية الربط ](#how-to-connect)
* [كيفية إنشاء رابط](#how-to-create-a-link)&#x20;
* [كيفية معالجة النتيجة ](#how-to-process-the-result)
* [كيفية إجراء دفعات اختبارية](#how-to-make-test-payments)

## كيفية الربط&#x20;

للاتصال بنظام الدفع Fondy ستحتاج إلى معرّف تاجر ومفتاح سري. بعد الحصول عليهما، ننتقل إلى الإعدادات في Salebot&#x20;

في Salebot نفتح قسم أنظمة الدفع، ونختار Fondy. تحتاج إلى إدخال البيانات المستلمة.

&#x20;                                       ![](/files/656bf305548bd41ec28614973cd2b09f84520b11)

![](/files/4d3843413e61d45841f8116be047d8e98a25f515)

لإنشاء رابط للدفع، تحتاج إلى تعيين قيمة المتغير payment\_sum (مثل 150 أو 100.55 (باستخدام نقطة!))، وبعد ذلك مباشرةً يظهر المتغير fondy\_pay\_url. يمكن عرض هذا المتغير كرابط أو وضعه على الزر مع النص "Pay".&#x20;

يكون الرابط بالشكل التالي:&#x20;

<https://payfondy.eu/merchants/4879cf99f26d58b22b04c037d111d14a/default/index.html?n=fe044b299ce98accfcd5f0c559d8c8f28802c3>

أيضًا، قبل تعيين قيمة payment\_sum، يمكنك تحديد المتغيرات الاختيارية التالية لتكوين الدفع.

{% hint style="warning" %}
الإعداد الافتراضي هو UAH، وإذا كنت بحاجة إلى عملة أخرى فيجب عليك تعيين قيمة المتغير currency
{% endhint %}

**currency** - عملة الطلب.&#x20;

**القيم الصالحة:**&#x20;

UAH - الهريفنيا الأوكرانية&#x20;

RUB - الروبل الروسي&#x20;

USD - الدولار الأمريكي&#x20;

EUR - اليورو&#x20;

GBP - الجنيه الإسترليني إلزامي&#x20;

CZK - الكرونة التشيكية

**payment\_description** - وصف الطلب&#x20;

**session\_timeout** - مدة صلاحية الطلب بالثواني.&#x20;

الافتراضي (36000 ثانية = 10 ساعات).&#x20;

**language** - لغة صفحة الدفع:&#x20;

ru - الروسية&#x20;

uk - الأوكرانية&#x20;

en - الإنجليزية&#x20;

lv - اللاتفية&#x20;

fr - الفرنسية&#x20;

cs - التشيكية&#x20;

ro - الرومانية&#x20;

it  - الإيطالية&#x20;

sk - السلوفاكية&#x20;

pl - البولندية&#x20;

es - الإسبانية&#x20;

hu - المجرية&#x20;

de - الألمانية

## كيفية إنشاء رابط&#x20;

إنشاء رابط لدفع 122 هريفنيا (الهريفنيا الافتراضية)

![](/files/1e95029ca04f8f16966db52790d18e6e3a48aa4e)

{% hint style="info" %}
يرجى الملاحظة:

* أولاً حدّد الاختياري **payment\_description** المعلمات، إلخ.
* وأخيرًا، عيّن قيمة **payment\_sum** variable
  {% endhint %}

ملاحظة: أولًا نضبط المتغيرات الإضافية للإعدادات، ثم **payment\_sum**. يمكنك تعريف المتغيرات في وقت أبكر ضمن سلسلة، وليس في كتلة واحدة، هذا مثال.&#x20;

بعد ذلك، في المكان المناسب، اطبع **fondy\_pay\_url** المتغير، الذي يحتوي على الرابط.

&#x20;                                          ![](/files/a1c476f6dc75b080d18adaaab429439ec769f68e)

## كيفية معالجة النتيجة&#x20;

بعد نجاح الدفع في البوت ستصل ردود رجعية (callbacks)، ومن خلالها يمكنك فهم أن الدفع تم بنجاح. هذه الردود الرجعية في النظام تراها كرسائل من المستخدم، لذلك لا يمكن أن يرسلها المستخدم، وهي تتكون من أول 5 أحرف من المفتاح السري وكلمة success، على سبيل المثال: h4fd56\_success

{% hint style="info" %}
إذا كانت كلمة المرور أقل من 5 أحرف، فسيتم استخدام كلمة المرور بالكامل، على سبيل المثال بالنسبة لمدفوعات الاختبار كلمة المرور هي test، ثم ستصل callback بالشكل test\_success
{% endhint %}

{% hint style="success" %}
هذه الاستدعاءات العكسية لا يراها المستخدم، بل تظهر فقط للمشغّل
{% endhint %}

{% hint style="warning" %}
يجب أن يكون نوع المطابقة "Full match"
{% endhint %}

كما أنه بعد نجاح الدفع يتم تعيين المتغير fondy\_payment\_completed إلى True.&#x20;

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

![](/files/66f459a7a21b351c36f93aeba3228236f8f21047)

بعد اكتمال الدفع، ستتم إضافة المتغير fondy\_callback\_data إلى العميل، ويحتوي على بيانات استجابة نظام الدفع للمعاملة المكتملة. يمكنك استخراج البيانات اللازمة من القاموس باستخدام طريقة get.

{% hint style="warning" %}
لإجراء دفعة متكررة، يجب إعادة تعيين payment\_sum، والرابط الذي تم إنشاؤه مسبقًا، وبعد إعادة تعيين المتغير payment\_sum الحصول على رابط جديد. يمكنك تحديد قيمة سابقة.
{% endhint %}

## كيفية إجراء دفعات اختبارية&#x20;

بيانات الاختبار وقت نشر الوثائق:&#x20;

**معرّف التاجر**: 1396424&#x20;

**كلمة المرور**: test&#x20;

**أرقام بطاقات الاختبار**&#x20;

44445566661111 - ناجح&#x20;

4444111166665555 - مرفوض&#x20;

مدة الصلاحية و CVV2 أيًّا كان&#x20;

إذا لم يعمل شيء، فقارن البيانات مع البيانات الموجودة على الموقع الرسمي: <https://docs.fondy.eu/ru/docs/page/2/2>


---

# 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/fondy.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.
