# Stripe * [كيفية الربط ](#how-to-connect) * [كيفية الحصول على رابط للدفع ](#how-to-get-a-link-to-payment) * [كيفية معالجة النتيجة ](#how-to-process-the-result) * [كيفية اختبار المدفوعات](#how-to-test-payments) ## كيفية الربط لربط نظام الدفع Stripe، تحتاج إلى مفتاح API سري ومفتاح webhook. يمكنك نسخ مفتاح API السري إلى قسم Developers -> API key ونسخ المفتاح السري. ![](/files/07111fb279f1b63e9d46dcec257e3d6461559f87) بعد ذلك تحتاج إلى تعيين عنوان URL لعمليات الاستدعاء (Callbacks). وهذا ضروري لكي يتلقى الروبوت إشعارات الدفع. اذهب إلى قسم Webhooks وأضف عنوانًا لـ webhooks. ![](/files/f1dbefa3e96d1f69a583947fee13c27b9a6666a1) عيّن عنوان URL: واختر الحدث: `checkout.session.completed` ![](/files/8b9c5bb586ad4fe68bf572a8abd9c85f54755762) احفظ وانتقل إلى الصفحة التي تحتوي على webhook المثبّت، وانسخ المفتاح (Signing secret) الخاص بـ webhook (في حقل salebot - Webhook key): \ بعد الضغط على Reveal key سيفتح Webhook، والذي سيبدأ بـ whsec\_... ![](/files/8ff96d63d8a92c84ed8ccf7fb64711ddd24734f8) بعد استلام المفاتيح، سننتقل إلى الإعدادات في Salebot. في salebot، افتح قسم أنظمة الدفع، واختر Stripe. في صفحة الاتصال، تحتاج إلى إدخال البيانات التي تم استلامها. ![](/files/e063fbc200c0729e46f6c7c88bd206e896cac1de) ![](/files/48d700ec6e3160332ef780390a3620317c8c153d) ## كيفية الحصول على رابط للدفع لإنشاء رابط للدفع، تحتاج إلى تعيين قيمة المتغير payment\_sum (مثل 150 أو 100.55 (باستخدام نقطة!))، ثم يظهر المتغير stripe\_pay\_url. يمكن عرض هذا المتغير كرابط أو وضعه على الزر مع النص "Pay". يكون الرابط بالشكل التالي: `https://checkout.stripe.com/pay/cs_test_a17mskKFFRwEuo3WgBSAUjfk7xaZZIrct9B3Ds2AdODVq1I8aRiqYEBdrU#fidkdWxOYHwnPyd1blpxYHZxWjA0TGFsVzFPVmpmMzJAbVYzUkp1Y0lLYDVgfzR2Q0NxcWZBNUNnTnRSVVRJSGFobEB1UExSczRMMTc8PWRLMGBddl8xalxyPDRoUGhnZm9xXXZANDZyaF0wNTVBVExsPHZyfycpJ2N3amhWYHdzYHcnP3F3cGApJ2lkfGpwcVF8dWAnPyd2bGtiaWBabHFgaCcpJ2BrZGdpYFVpZGZgbWppYWB3dic%2FcXdwYHgl` {% hint style="warning" %} الإعداد الافتراضي هو USD (الدولار)، وإذا كنت بحاجة إلى عملة أخرى فعليك تعيين قيمة المتغير currency {% endhint %} أيضًا، قبل تعيين قيمة payment\_sum، يمكنك تحديد المتغيرات الاختيارية التالية لتكوين الدفع. currency - عملة الطلب. القيم الصالحة - [https://stripe.com/docs/currencies ]() payment\_description - وصف الطلب ### مثال على رابط للدفع إنشاء رابط لدفع 2 EUR (الدولار افتراضي) ![](/files/02d2897d7163ef298ebea692641c4365f706f53b) {% hint style="info" %} يرجى الملاحظة: * حدد أولًا المعلمات الاختيارية first\_name وpayment\_description وما إلى ذلك. * وأخيرًا، عيّن قيمة المتغير payment\_sum {% endhint %} ملاحظة: أولًا نعيّن المتغيرات الإضافية للإعدادات، ثم payment\_sum. يمكنك تعريف المتغيرات مسبقًا في السلسلة، وليس في كتلة واحدة؛ هذا مجرد مثال. بعد ذلك، وفي المكان المناسب، سنعرض المتغير stripe\_pay\_url، الذي يحتوي على الرابط داخل الكتلة أو على الزر ![](/files/b6ee5c3eeb0d22c1ebe9d58cb6c94c06e182022e) صفحة مثال على الدفع ![](/files/d107e48b26f0571a3d5deb9ba9e580dd5b696646) ## كيفية معالجة النتيجة بعد إتمام الدفع بنجاح، ستصل إلى الروبوت عمليات استدعاء (callbacks)، ومن خلالها يمكنك معرفة أن الدفع تم بنجاح. هذه العمليات في النظام تراها كرسائل من المستخدم، لذلك لا يمكن للمستخدم إرسالها، وهي تتكون من أول 20 حرفًا من المفتاح السري وكلمة success للحساب، على سبيل المثال: sk\_live\_d35gky6d8ers\_success المستخدم لا يرى هذه العمليات، بل تظهر فقط للمشغّل. يجب أن يكون نوع المطابقة "Full match" أيضًا بعد نجاح الدفع، يتم تعيين المتغير stripe\_payment\_completed إلى True. على سبيل المثال، يمكنك إنشاء كتلة معالجة دفع ناجحة مع شرط وطباعة الرسالة المناسبة للمستخدم: ![](/files/5546d856c0d47cf91da6da6ac459bee84995ae8b) بعد اكتمال الدفع، ستتم إضافة المتغير stripe\_callback\_data إلى العميل، ويحتوي على بيانات استجابة نظام الدفع للمعاملة المكتملة. يمكنك استخراج البيانات اللازمة من القاموس باستخدام طريقة get. {% hint style="warning" %} لإجراء دفعة متكررة، يجب إعادة تعيين payment\_sum، والرابط الذي تم إنشاؤه مسبقًا، وبعد إعادة تعيين المتغير payment\_sum الحصول على رابط جديد. يمكنك تحديد قيمة سابقة. {% endhint %} ## كيفية اختبار المدفوعات يمكنك استخدام المفتاح السري من بيئة الاختبار لاختبار التكامل. للقيام بذلك، في حسابك الشخصي ضمن قائمة stripe على اليمين، تحتاج إلى التبديل إلى بيئة الاختبار. ![](/files/551b5d369acc85c61e7797141edaf498549f25b8) بعد ذلك، اضبط الإعدادات الموصوفة في بداية هذه التعليمات. أدخل مفتاح الاختبار السري وأضف عنوان webhooks إلى بيئة الاختبار. رقم بطاقة الاختبار 4242 4242 4242 4242 أي تاريخ مستقبلي CVC - أي ثلاثة أرقام إذا كان هناك شيء لا يعمل، فقارن البيانات مع البيانات الموجودة على الموقع الرسمي: https\:/stripe.com/docs/testing#regulatory-cards --- # 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/stripe.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.