Stripe

• كيفية الربط

• كيفية الحصول على رابط للدفع

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

• كيفية اختبار المدفوعات

كيفية الربط

لربط نظام الدفع Stripe، تحتاج إلى مفتاح API سري ومفتاح webhook.

يمكنك نسخ مفتاح API السري إلى قسم Developers -> API key ونسخ المفتاح السري.

بعد ذلك تحتاج إلى تعيين عنوان URL لعمليات الاستدعاء (Callbacks). وهذا ضروري لكي يتلقى الروبوت إشعارات الدفع.

اذهب إلى قسم Webhooks وأضف عنوانًا لـ webhooks.

عيّن عنوان URL: https://chatter.salebot.pro/stripe_callback/result

واختر الحدث:

checkout.session.completed

احفظ وانتقل إلى الصفحة التي تحتوي على webhook المثبّت، وانسخ المفتاح (Signing secret) الخاص بـ webhook (في حقل salebot - Webhook key):

بعد الضغط على Reveal key سيفتح Webhook، والذي سيبدأ بـ whsec_...

بعد استلام المفاتيح، سننتقل إلى الإعدادات في Salebot.

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

كيفية الحصول على رابط للدفع

لإنشاء رابط للدفع، تحتاج إلى تعيين قيمة المتغير payment_sum (مثل 150 أو 100.55 (باستخدام نقطة!))، ثم يظهر المتغير stripe_pay_url. يمكن عرض هذا المتغير كرابط أو وضعه على الزر مع النص "Pay".

يكون الرابط بالشكل التالي:

https://checkout.stripe.com/pay/cs_test_a17mskKFFRwEuo3WgBSAUjfk7xaZZIrct9B3Ds2AdODVq1I8aRiqYEBdrU#fidkdWxOYHwnPyd1blpxYHZxWjA0TGFsVzFPVmpmMzJAbVYzUkp1Y0lLYDVgfzR2Q0NxcWZBNUNnTnRSVVRJSGFobEB1UExSczRMMTc8PWRLMGBddl8xalxyPDRoUGhnZm9xXXZANDZyaF0wNTVBVExsPHZyfycpJ2N3amhWYHdzYHcnP3F3cGApJ2lkfGpwcVF8dWAnPyd2bGtiaWBabHFgaCcpJ2BrZGdpYFVpZGZgbWppYWB3dic%2FcXdwYHgl

الإعداد الافتراضي هو USD (الدولار)، وإذا كنت بحاجة إلى عملة أخرى فعليك تعيين قيمة المتغير currency

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

currency - عملة الطلب. القيم الصالحة - https://stripe.com/docs/currencies

payment_description - وصف الطلب

مثال على رابط للدفع

إنشاء رابط لدفع 2 EUR (الدولار افتراضي)

يرجى الملاحظة:

• حدد أولًا المعلمات الاختيارية first_name وpayment_description وما إلى ذلك.

• وأخيرًا، عيّن قيمة المتغير payment_sum

ملاحظة: أولًا نعيّن المتغيرات الإضافية للإعدادات، ثم payment_sum. يمكنك تعريف المتغيرات مسبقًا في السلسلة، وليس في كتلة واحدة؛ هذا مجرد مثال.

بعد ذلك، وفي المكان المناسب، سنعرض المتغير stripe_pay_url، الذي يحتوي على الرابط داخل الكتلة أو على الزر

صفحة مثال على الدفع

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

بعد إتمام الدفع بنجاح، ستصل إلى الروبوت عمليات استدعاء (callbacks)، ومن خلالها يمكنك معرفة أن الدفع تم بنجاح. هذه العمليات في النظام تراها كرسائل من المستخدم، لذلك لا يمكن للمستخدم إرسالها، وهي تتكون من أول 20 حرفًا من المفتاح السري وكلمة success للحساب، على سبيل المثال: sk_live_d35gky6d8ers_success

المستخدم لا يرى هذه العمليات، بل تظهر فقط للمشغّل.

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

أيضًا بعد نجاح الدفع، يتم تعيين المتغير stripe_payment_completed إلى True.

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

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

لإجراء دفعة متكررة، يجب إعادة تعيين payment_sum، والرابط الذي تم إنشاؤه مسبقًا، وبعد إعادة تعيين المتغير payment_sum الحصول على رابط جديد. يمكنك تحديد قيمة سابقة.

كيفية اختبار المدفوعات

يمكنك استخدام المفتاح السري من بيئة الاختبار لاختبار التكامل. للقيام بذلك، في حسابك الشخصي ضمن قائمة stripe على اليمين، تحتاج إلى التبديل إلى بيئة الاختبار.

بعد ذلك، اضبط الإعدادات الموصوفة في بداية هذه التعليمات. أدخل مفتاح الاختبار السري وأضف عنوان webhooks إلى بيئة الاختبار.

رقم بطاقة الاختبار

4242 4242 4242 4242

أي تاريخ مستقبلي

CVC - أي ثلاثة أرقام

إذا كان هناك شيء لا يعمل، فقارن البيانات مع البيانات الموجودة على الموقع الرسمي: https:/stripe.com/docs/testing#regulatory-cards