تكامل
تكامل Stripe مع نافس CRM: إصدار فاتورة Stripe من الصفقة
إذا كان عملاؤك يدفعون عبر Stripe، يتيح نافس CRM إنشاء فاتورة Stripe من صفحة الصفقة بمبلغها، فيرسلها Stripe إلى بريد العميل مع صفحة دفع مستضافة. هذه الصفحة تشرح ما يحدث بالضبط، وحدود التكامل الحالية.
ماذا يفعل التكامل
التكامل إجراء واحد يبدأه المستخدم من قائمة رأس الصفقة: «إنشاء فاتورة Stripe». وعند تأكيده ينفذ نافس الخطوات التالية بالمفتاح السري لحساب Stripe الخاص بمنشأتك:
- إنشاء عميل في Stripe من جهة اتصال مرتبطة بالصفقة ولها بريد إلكتروني.
- إنشاء مسودة فاتورة وربط بند مبلغ الصفقة بها مباشرة بعملة مساحة العمل.
- اعتماد الفاتورة بعد نجاح إضافة البند، ثم طلب إرسالها بالبريد مع مهلة سداد 14 يومًا.
- عرض رابط الفاتورة المستضافة بعد نجاح الإرسال.
ويحوّل نافس المبلغ إلى أصغر وحدة للعملة كما يطلب Stripe، بما في ذلك العملات ذات المنازل العشرية الثلاث مثل الدينار الكويتي والبحريني والريال العماني.
ينشئ نافس مسودة الفاتورة أولًا، ويربط بند الصفقة بمعرّفها مباشرة، ثم يعتمدها قبل الإرسال. إذا فشل إضافة البند أو اعتماد الفاتورة، لا يرسلها. ابدأ بوضع الاختبار وتحقق من المبلغ والعملة والمستلم قبل استخدام مفتاح حقيقي.
خطوات الإعداد والاستخدام
احفظ المفتاح السري
بصفتك مديرًا، افتح «متجر التطبيقات» واختر Stripe ثم زر الإعداد، والصق المفتاح السري لحساب Stripe، ويفضَّل مفتاح وضع الاختبار في البداية. ثم اضغط «حفظ».
تحقق من المفتاح
اضغط «اختبار الاتصال»، فيقرأ نافس رصيد حساب Stripe للتأكد من صلاحية المفتاح ويعرض النتيجة وزمن الاستجابة.
جهّز الصفقة
افتح صفقة لها مبلغ، ومرتبطة بجهة اتصال لديها بريد إلكتروني؛ فبدون المبلغ يظهر الخيار معطلًا، وبدون البريد يطلب منك نافس إضافته.
أنشئ الفاتورة
من قائمة رأس الصفقة ← «التكاملات» ← «إنشاء فاتورة Stripe». تعرض نافذة التأكيد المبلغ والمستلم، ثم اضغط «إنشاء وإرسال». الإرسال فوري ولا يمكن التراجع عنه من نافس.
راجع الفاتورة
افتح الفاتورة من رسالة التأكيد، وتحقق من وجود البند والمبلغ قبل أن تعتبر العملية مكتملة.
البيانات المرسلة واتجاهها
| ما يُرسل | إلى | التفاصيل |
|---|---|---|
| اسم جهة الاتصال وبريدها | Stripe (عميل جديد) | مع رقم الصفقة في البيانات الوصفية |
| مبلغ الصفقة وعملتها | Stripe (بند فاتورة) | الوصف هو اسم الصفقة |
| الفاتورة | Stripe ثم بريد العميل | مهلة سداد 14 يومًا وصفحة دفع مستضافة |
| حالة الدفع | لا شيء يعود إلى نافس | لا يوجد مستقبِل لأحداث Stripe |
الحدود الحالية
- عميل جديد في كل مرة: كل فاتورة تنشئ عميلًا جديدًا في Stripe، فتتكرر سجلات العميل نفسه هناك.
- لا شيء يعود من Stripe: دفع الفاتورة لا يغيّر حالة الصفقة ولا يسجل دفعة في نافس.
- بند واحد وشروط ثابتة: الفاتورة تحمل مبلغ الصفقة بندًا واحدًا، بمهلة سداد 14 يومًا لا تُعدَّل من الواجهة.
- حقل سر الـ Webhook لا يفعّل شيئًا: تعرض شاشة إعداد Stripe حقلًا باسم Webhook Signing Secret، لكن نافس لا يستقبل أحداث Stripe أصلًا، فتعبئته لا تعيد حالة الدفع إلى الصفقة.
- يحتاج متجر التطبيقات: المتاح من خطة Starter فأعلى.
إذا كان هدفك تحصيل مدفوعات فواتيرك وتسجيلها تلقائيًا، ففواتير نافس نفسها تدعم الدفع الإلكتروني عبر حساب Tap الخاص بمنشأتك، وتُسجَّل الدفعة على الفاتورة فور نجاحها. التفاصيل في تكامل Tap Payments.
أسئلة شائعة
الأسئلة 4
هل يغيّر دفع فاتورة Stripe حالة الصفقة في نافس؟
لا. التكامل يرسل البيانات إلى Stripe فقط، ولا يستقبل أحداث الدفع. حدّث الصفقة يدويًا بعد التحقق من الدفع في لوحة Stripe.
كيف أتأكد من قيمة الفاتورة؟
اختبر بصفقة لها مبلغ وعملة واضحة. راجع البند والإجمالي في لوحة Stripe؛ يربط التكامل البند مباشرة بالفاتورة ويتوقف عن الإرسال إذا فشلت إضافته أو فشل الاعتماد.
بأي عملة تصدر الفاتورة؟
بعملة مساحة العمل التي يضبطها المدير في إعدادات المنطقة والتنسيقات، ويُحوَّل المبلغ إلى أصغر وحدة لهذه العملة كما يتطلب Stripe.
هل يمكن إلغاء الفاتورة بعد إرسالها؟
ليس من نافس. تُرسل الفاتورة فور التأكيد، وأي إلغاء أو تعديل يتم من لوحة Stripe.