احصل على مدفوعاتك إلكترونيًا مع ادفع الآن (بالبطاقة أو عبر البنك، مع Stripe)

مع الدفع الإلكتروني، يمكن لعملائك دفع الفاتورة بالبطاقة أو عبر البنك بنقرات قليلة: يظهر زر ادفع الآن في بريد الفاتورة، وفي تذكيرات الدفع، وفي صفحة الفاتورة الإلكترونية، وفي بوابة العملاء. يذهب المال مباشرة إلى حسابك الخاص على Stripe (Stripe هي شركة الدفع التي تتلقى المبلغ). لا يرى Kaam360 أبدًا بيانات البطاقات أو الحسابات البنكية، ويعلّم الفاتورة كمدفوعة تلقائيًا عندما يؤكد Stripe الدفعة.

من يمكنه الإعداد: المسؤولون، وكل من يملك دوره صلاحية إعداد الدفع الإلكتروني (راجع أنشئ أدوارك الخاصة). وهو جزء من باقتي Team وBusiness.

1. افتح حسابًا على Stripe

1. انتقل إلى stripe.com وأنشئ حسابًا (فتحه مجاني؛ يأخذ Stripe رسومًا صغيرة من كل دفعة).
2. يبدأ Stripe في وضع الاختبار: لا شيء حقيقي، لذا يمكنك تجربة كل شيء بأمان. لتلقي مدفوعات حقيقية لاحقًا، يطلب Stripe بيانات نشاطك التجاري وحسابك البنكي (Activate payments).

2. اربطه بـ Kaam360 (ابدأ بوضع الاختبار)

1. في Stripe، افتح Developers > API keys. تأكد من تشغيل Test mode (المفتاح في الأعلى).
2. بجانب Secret key، اضغط Reveal test key وانسخه. يبدأ بـ sk_test_.
3. في Kaam360، اضغط الإعدادات ثم بطاقة المدفوعات الإلكترونية.
4. الصق المفتاح في المفتاح السري واضغط اتصال. يتحقق Kaam360 من المفتاح لدى Stripe ويعرض متصل ووضع الاختبار.

يُحفظ المفتاح مشفّرًا ولا يُعرض كاملًا مرة أخرى؛ تظهر آخر أربعة أحرف منه فقط لتتعرف عليه. لا تلصق أبدًا المفتاح القابل للنشر (pk_...): يطلب Kaam360 المفتاح السري.

3. أضف الـ webhook (لتُسجَّل الدفعات تلقائيًا)

الـ webhook هو طريقة Stripe لإخبار Kaam360 بأن «هذه الفاتورة دُفعت». بدونه لا يظهر زر ادفع الآن.

1. في المدفوعات الإلكترونية، تحت Webhook، اضغط نسخ بجانب عنوان نقطة النهاية (Endpoint URL).
2. في Stripe، افتح Developers > Webhooks واضغط Add endpoint (في شاشات Stripe الأحدث: Add destination، واختر Your account ثم Webhook endpoint).
3. الصق العنوان في Endpoint URL.
4. تحت Select events، اختر بالضبط الأحداث المذكورة في صفحة Kaam360: checkout.session.completed وcheckout.session.async_payment_succeeded وcheckout.session.async_payment_failed وcheckout.session.expired وpayment_intent.succeeded وpayment_intent.payment_failed وcharge.refunded, payout.paid, payout.failed. اضغط Add endpoint.
5. في صفحة نقطة النهاية في Stripe، تحت Signing secret، اضغط Reveal وانسخه. يبدأ بـ whsec_.
6. عد إلى Kaam360، والصقه في سر التوقيع واضغط حفظ. تتحول الشارة إلى تم حفظ سر التوقيع.

4. اختر ما يراه العملاء

تحت ما يراه العملاء:

• إظهار زر ادفع الآن على الفواتير: شغّل الدفع الإلكتروني أو أوقفه في أي وقت.
• طرق الدفع: البطاقات (مع Apple Pay وGoogle Pay حيثما توفرت للعميل)، والخصم البنكي حيث ينطبق: حساب بنكي أمريكي (ACH Direct Debit) للدولار، والخصم المباشر SEPA لليورو، والخصم المباشر Bacs (المملكة المتحدة) للجنيه. فعّل كل طريقة في Stripe أيضًا (Settings > Payment methods). اتركها كلها دون تحديد لعرض ما هو مفعّل في Stripe بالضبط.
• الدفعات الجزئية: حدّد يمكن للعملاء دفع جزء من الفاتورة ليكتبوا مبلغًا (لا يزيد أبدًا على المستحق)، وحدّد أصغر دفعة جزئية.
• رسوم الدفع الإلكتروني: معطّلة (0%) افتراضيًا. بعض الدول وشبكات البطاقات تمنع هذه الرسوم أو تحدّها، فتحقّق قبل إضافتها. يراها العميل قبل الدفع، ولا تُضاف إلى الفاتورة.
• أي الفواتير: عملات معيّنة فقط (مثل USD, EUR)، وإن كانت لديك عدة شركات، بعضها فقط.

اضغط حفظ.

5. جرّبه ببطاقة اختبار

1. أرسل لنفسك فاتورة (أو افتح فاتورة صادرة واضغط فتح بجانب صفحة الفاتورة الإلكترونية).
2. اضغط ادفع الآن. تفتح صفحة الدفع من Stripe.
3. ادفع ببطاقة اختبار Stripe 4242 4242 4242 4242، وأي تاريخ مستقبلي، وأي ثلاثة أرقام.
4. تعود إلى الفاتورة التي تظهر الآن مدفوعة. في صفحة الفاتورة في Kaam360، تعرض بطاقة الدفع الإلكتروني الدفعة، وتصلك إشعار ورسالة بريد.

6. انتقل إلى الوضع المباشر

1. في Stripe، أوقف Test mode وأكمل Activate payments.
2. انسخ المفتاح السري المباشر (sk_live_...). في المدفوعات الإلكترونية، اضغط تغيير المفتاح، والصقه واضغط اتصال. تعرض الشارة مباشر.
3. أضف الـ webhook مرة أخرى في الوضع المباشر (الخطوة 3: يفصل Stripe بين webhooks الاختبار والمباشر) واحفظ سر التوقيع الجديد.

ما يراه عملاؤك

• بريد الفاتورة والتذكيرات فيها زر ادفع الآن. ويمكنك في التذكيرات أيضًا استخدام الكلمة {pay_link}.
• صفحة الفاتورة الإلكترونية: عنوان خاص لكل فاتورة، يرى فيه العميل الفاتورة وينزّل ملف PDF ويدفع، دون تسجيل الدخول. في صفحة الفاتورة، تعرض بطاقة الدفع الإلكتروني العنوان مع نسخ؛ وتتضمنه رسالة واتساب.
• بوابة العملاء: على الفاتورة التي ما زال عليها مبلغ، يوجد ادفع الآن تحت طريقة الدفع.

تبقى تعليمات الدفع الخاصة بك (البيانات البنكية) أسفل ادفع الآن، فيمكن للعملاء الدفع بالطريقة المعتادة.

ماذا يحدث بعد الدفع

• مدفوعات البطاقة تُؤكد فورًا: تُعلَّم الفاتورة كمدفوعة (أو مدفوعة جزئيًا مع إظهار المتبقي)، وتتحرك معها دفعة المشروع التي تفوترها.
• الخصم البنكي يستغرق بضعة أيام. حتى يؤكد البنك، تظهر الدفعة في الطريق ولا يمكن لأحد دفع المبلغ نفسه مرتين. إذا رفضها البنك، تظهر الدفعة فشلت ويتم إبلاغك.
• رسوم Stripe تظهر بجانب كل دفعة عندما يبلغ عنها Stripe.
• يتلقى العميل إيصالًا بالبريد باسم شركتك.
• تتلقى إشعارًا (الجرس) ورسالة بريد؛ وكذلك من كتب الفاتورة.

المبالغ المستردة

نفّذ الاسترداد من لوحة Stripe (افتح الدفعة واضغط Refund). يتابع Kaam360 تلقائيًا: تعرض الدفعة المبلغ المسترد، وتصبح الفاتورة مستحقة بذلك المبلغ مجددًا. إذا لم يدفعه العميل ثانية، فاكتب إشعار دائن به (راجع إشعارات الدائن والمبالغ المستردة وكشوف الحساب).

إذا دفع العميل مرتين (مثلًا في علامتي تبويب)، تُسجَّل الدفعة الثانية على أنها أكثر من المستحق ويُطلب منك رد الفرق في Stripe.

التحويلات إلى بنكك

كل بضعة أيام يرسل Stripe الأموال التي جمعها إلى بنكك بعد خصم رسومه وأي مبالغ مستردة: هذا تحويل. يقرأ Kaam360 كل تحويل تلقائيًا بكل ما فيه عندما يرسل Stripe الحدث payout.paid.

1. في المدفوعات الإلكترونية ابحث عن التحويلات إلى بنكك. يعرض كل تحويل يوم وصوله والمدفوعات والمبالغ المستردة ورسوم Stripe التي يتضمنها وما يصل إلى بنكك.
2. اضغط عرض لرؤية كل سطر في التحويل: كل دفعة عبر ادفع الآن مع فاتورتها، وكل مبلغ مسترد، وكل رسم. الدفعة التي لم تتم عبر ادفع الآن في Kaam360 تُعلَّم بأنها ليست من Kaam360.
3. اضغط جلب التحويلات لقراءة تحويلات آخر 60 يومًا من Stripe مرة أخرى (مثلًا بعد إضافة الـ webhook مباشرة).

تبين الحالة وضع كل تحويل: في الطريق أو مدفوع، غير مقيد في الدفاتر بعد أو مقيد في الدفاتر، لم يُطابق سطر البنك بعد أو تمت التسوية.

في دفتر الأستاذ العام (مع تشغيل القيود التلقائية) تذهب دفعة ادفع الآن الموجودة في تحويل أولًا إلى حساب Stripe clearing. في يوم وصول التحويل ينقل Kaam360 المبلغ الصافي من Stripe clearing إلى بنكك ورسوم Stripe إلى Bank charges؛ ورسم الدفع الإلكتروني الذي أضافه العميل يذهب إلى Other income. عند استيراد كشف حسابك البنكي يطابق سطر البنك الخاص بالتحويل إجمالي التحويل: طابقه في كشوف الحساب البنكية فيظهر التحويل تمت التسوية.

تحقّق من أن كل شيء يعمل

في المدفوعات الإلكترونية:

• المدفوعات الإلكترونية تعرض كل دفعة بحالتها ورسومها وعميلها.
• رسائل من Stripe تعرض كل رسالة أرسلها Stripe وما فعله Kaam360 بها. الرسالة المرسلة مرتين لا تُستخدم إلا مرة واحدة.
• إذا رأيت تحذيرًا بأن رسالة وصلت بتوقيع غير مطابق، فسر التوقيع المحفوظ في Kaam360 ليس سر ذلك الـ webhook (أو من الوضع الآخر). انسخه مجددًا من Stripe واضغط حفظ.

من يستطيع ماذا

في الأدوار والصلاحيات، تحت المالية: إعداد الدفع الإلكتروني يربط الحساب ويغيّر الخيارات (للمسؤولين فقط حتى تمنحه لغيرهم). عرض الفواتير يُظهر المدفوعات الإلكترونية للفاتورة وصفحتها الإلكترونية. يُسجَّل الربط والتغيير وقطع الاتصال في سجل النشاط، وكذلك كل دفعة واسترداد.