# Paypal

* [كيفية إعداد باي بال ](#how-to-set-up-paypal)
* [كيفية إنشاء رابط دفع ](#how-to-create-a-payment-link)
* [كيفية معالجة النتيجة](#how-to-process-the-result)

## كيفية إعداد باي بال 

للتعامل مع باي بال، تحتاج إلى الحصول على مفتاحين: client\_id و secret 

اذهب إلى الصفحة[ https://developer.paypal.com/developer/applications/ ](< https://developer.paypal.com/developer/applications/ >)

واختر من القائمة أو أنشئ تطبيقًا جديدًا:

![](/files/08a1536981946cbb559510fdd95f5a2508a238c0)

في الأعلى، غيّر المفتاح إلى وضع التشغيل المباشر Live mode واختر التطبيق الذي تريده. ستفتح صفحة بالإعدادات حيث يمكنك العثور على البيانات التي تريدها:

![](/files/182995e9a4c32efc71fef9a881465797c3111928)

انسخ البيانات والصقها في الحقول المقابلة في إعدادات Salebot - أنظمة الدفع - Paypal:

&#x20;                                             ![](/files/4c9e940b1bec93339333c86f05040dc2be3e5c1c)

![](/files/d6acd16bac62f9ffd429b825c241f60fdd7bcc3d)

وهنا تنتهي عملية الاتصال.

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

لتوليد رابط دفع، تحتاج إلى تعيين قيمة المتغير payment\_sum وسيظهر المتغير paypal\_pay\_url فورًا.&#x20;

المتغير payment\_title ليس متغيرًا إلزاميًا، وهو اسم المنتج. إذا لم تحدده فسيُملأ بالنص: "Payment account order\_id" (order\_id - معرّف الطلب في الخادم)&#x20;

payment\_description - وصف المنتج، اختياري&#x20;

بالإضافة إلى ذلك، قبل تحديد payment\_sum، يمكنك تحديد اللغة التي ستظهر بها صفحة الدفع. للقيام بذلك، تحتاج إلى تعيين المتغير locale، والقيمة الافتراضية هي الروسية (ru-RU). جميع الخيارات الممكنة: **da-DK, he-IL, id-ID, ja-JP, no-NO, pt-BR, ru-RU, sv-SE, th-TH, zh-CN, zh-HK, zh-TW.**&#x20;

والمعلمة الإضافية الثالثة هي company\_name - اسم شركتك، ويظهر في أعلى الصفحة تمامًا (مثال أدناه، company).

&#x20;                                       &#x20;

يمكنك أيضًا تحديد العملة التي سيتم قبول الدفع بها، ولهذا نحدد المتغير currency، والقيمة الافتراضية مضبوطة على الروبل (RUB)، وللدولار اضبط قيمته USD (currency = USD). يمكن العثور على خيارات العملات الممكنة عبر الرابط [https://developer.paypal.com/docs/api/reference/currency-codes/ ](<https://developer.paypal.com/docs/api/reference/currency-codes/ >)

والمعلمة الإضافية الثالثة هي company\_name - اسم شركتك، ويظهر في أعلى الصفحة تمامًا (مثال أدناه، company )&#x20;

يمكن عرض المتغير paypal\_pay\_url كرابط أو وضعه على زر "الدفع".&#x20;

يكون الرابط بالشكل التالي: [https://ww.paypal.com/checkoutnow?token=07N53571YM296381N ](<https://ww.paypal.com/checkoutnow?token=07N53571YM296381N >)

مثال على التنفيذ.&#x20;

تعيين مبلغ الدفع 444 واسم الشركة

&#x20;                                       ![](/files/267ef560478cc9899d4f34bc4d05d76bafa03332)

{% hint style="info" %}
**ملاحظة:** يتم تعيين المتغير payment\_sum كآخر متغير، بعد المتغير الاختياري **payment\_title**, **company\_name**، إلخ.
{% endhint %}

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

{% hint style="info" %}
بعد نجاح الدفع في البوت ستصل الكولباكات، والتي يمكنك من خلالها فهم أنه تم الدفع بنجاح. هذه الكولباكات تظهر في النظام كرسائل من المستخدم، لذلك لا يمكن إرسالها من المستخدم، وهي تتكون من أول 10 رموز سرية وصفحة رئيسية مع الحالة، على سبيل المثال: EHsWHYOoWV\_success.
{% endhint %}

كما أنه بعد نجاح الدفع، يتم تعيين المتغير paypal\_payment\_completed إلى True.

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

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

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

{% hint style="warning" %}
تصل الكولباكات مع تأخير، لذلك بعد إرسال رابط الدفع إلى المستخدم، نوصي بإرسال رسالة مثل: "بعد الدفع، انتظر رسالة تفيد بإتمام الدفع بنجاح"
{% endhint %}

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

![](/files/d9770592051cad48a7b37934b631d9fbdd9c26b3)

يجب أن يكون نوع المطابقة "Full match"&#x20;

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


---

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