# زر الدفع

يُبسِّط زرّ وظيفة الدفع العمل مع أنظمة الدفع المتصلة من خلال توفير رابط دفع.

صورة

يرجى ملاحظة أنه في العديد من برامج المراسلة، لا يمكن وضع الروابط إلا في الأزرار المضمّنة داخل النص. لا تنسَ اختيار نوع الزر المناسب في إعدادات الكتلة بعد إنشاء الزر.

زرّ وظيفة الدفع متاح لأنظمة الدفع التالية:

* Stripe

ضمن كتلة واحدة، يمكنك إنشاء أزرار "الدفع" لأنظمة دفع مختلفة وبمبالغ دفع مختلفة.

إذا لم تكن هناك أنظمة دفع متصلة بالمشروع، فلن يكون هذا النوع من الأزرار متاحًا.

صورة

**الحقول الرئيسية لزرّ الدفع:**

* **حقل النص:** سيظهر هذا النص على الزر مع رابط الدفع في الرسالة.
* **الوظيفة:** حدد نوع الزر **الدفع**.
* **حقل الوظيفة:** لإنشاء زر يوفّر رابط دفع، اختر **الدفع** .
* **حقل نظام الدفع:** تعرض القائمة أنظمة الدفع المتصلة بالمشروع.

اعتمادًا على نظام الدفع المختار، ستختلف الحقول المطلوبة لإنشاء الرابط وإصدار الإيصال.

يمكنك عرض إعدادات زر وظيفة الدفع لأنظمة الدفع المختلفة هنا:

الـ **الحقول المطلوبة لإنشاء رابط الدفع** هي **المبلغ** و **اسم المنتج/وصف المنتج**.

* **حقل المبلغ:** أدخل مبلغ الدفع هنا.
* **حقل اسم المنتج:** أدخل اسم المنتج الذي سيظهر في صفحة الدفع.

علامات الاقتباس المزدوجة **إرسال رسالة مباشرة كرد على الإشارة. يمكنك فقط الرد بتعليق.** يمكن استخدامها في اسم المنتج.

يمكنك استبدالها بعلامات الفاصلة العليا أو بعلامات الاقتباس المفردة.

اعتمادًا على نظام الدفع المختار، ستظهر في إعدادات الزر قوائم منسدلة بعنوان "بيانات الإيصال" و/أو "معلومات إضافية". عند النقر عليها ستظهر حقول إضافية:

صورة

### المتغيرات عند استخدام زر وظيفة الدفع <a href="#variables-when-using-the-payment-function-button" id="variables-when-using-the-payment-function-button"></a>

بمجرد أن يتلقى المستخدم الكتلة التي تحتوي على زر "الدفع"، يتم إنشاء متغيرات العميل التالية تلقائيًا:

* **متغير العميل النظامي `__payments`** – يخزّن هذا المتغير مبلغ الدفع ومعرّف رابط الدفع المُنشأ. ويُستخدم لتحديد استجابة الويب هوك من نظام الدفع.

متغير العميل النظامي `__payments` **يجب عدم حذفه أو تعديله**!

متغير العميل `error_payment_button` يتم إنشاؤه إذا حدث خطأ أثناء إنشاء زرّ الدفع.

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

تصبح قيم المتغيرات نشطة (محدَّثة) عندما ينتقل المستخدم إلى الكتلة التالية.

#### كيفية التعامل مع النتيجة <a href="#how-to-handle-the-result" id="how-to-handle-the-result"></a>

**دفع ناجح**

بعد نجاح عملية الدفع، سيتلقى الروبوت **callback** يتكون من أول 10 أحرف من المفتاح السري لنظام الدفع، والكلمة `_success`، ومبلغ الدفع مفصولًا بمسافة. على سبيل المثال: **`ovg58keefc_success 44`**، حيث:

* `ovg58keefc`أول 10 أحرف من المفتاح السري لنظام الدفع
* `_success`يشير إلى نتيجة الطلب (عملية دفع ناجحة)
* `44`مبلغ الدفع

عمليات ردّ النداء (الإشعارات) من نظام الدفع **غير مرئية للمستخدم**. وهي تظهر فقط في علامة التبويب **العملاء** وتكون مرئية لـ **المشغّل**.

**مثال على الاستخدام:** **الخطوة 1.** في الكتلة التي تحتوي على **الدفع** زرّ، أضف أزرارًا تحتوي على **الدفع** . **الخطوة 2.** في **شرط الاتصال** حقل من هذه الكتلة إلى **دفع ناجح** الكتلة، حدِّد **callback**. يعمل هذا بالطريقة نفسها إذا حدَّدت ردّ النداء الخاص بالدفع الناجح في **حقل الشرط** من **التحقق من الشرط الأساسي** الكتلة.

ملاحظة! اختيار نوع المطابقة — **مطابقة تامة** أو **مطابقة بالكلمة المفتاحية.**

نصيحة مفيدة

لإرسال إشعار عن عملية دفع ناجحة إلى العميل دون إيقاف تقدمه عبر المسار الرئيسي، أنشئ **"كتلًا غير حالية مع شروط."**

**دفع مع خطأ**

إذا حدث **خطأ في الدفع**، سيتلقى الروبوت **callback** يتكون من أول 10 أحرف من المفتاح السري لنظام الدفع، والكلمة `_fail`، ومبلغ الدفع مفصولًا بمسافة. على سبيل المثال: `ovg58keefc_fail 44`، حيث:

* `ovg58keefc`أول 10 أحرف من المفتاح السري لنظام الدفع
* `_fail`نتيجة معالجة الطلب — فشل الدفع أو حدوث خطأ
* `44`مبلغ الدفع

يعتمد ذلك على نظام الدفع. **ليست كل أنظمة الدفع ترسل ردّ نداء عند حدوث أخطاء في الدفع.**

إذا كان المبلغ المحدد في إعدادات الزر يختلف عن **المبلغ الذي دفعه العميل فعليًا**، سيتلقى الروبوت **callback** يتكون من أول 10 أحرف من المفتاح السري لنظام الدفع، والعبارة `_different_amounts`، ومعرّف دفع فريد مفصولًا بمسافة. على سبيل المثال: `ovg58keefc_different_amounts 123456`، حيث:

* `ovg58keefc`أول 10 أحرف من المفتاح السري لنظام الدفع
* `_different_amounts`نتيجة معالجة الطلب (يختلف مبلغ الدفع عن المبلغ الموجود في الرابط)
* `123456`معرّف دفع فريد


---

# 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/chatbot/builder/alazrar/zr-aldfa.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.