موصّل Stripe

اربط حسابك على Stripe بـ Tajo لمزامنة بيانات الدفع للقراءة فقط (العملاء والمدفوعات والاشتراكات والفواتير) ضمن تحديد جهات الاتصال والتقسيم إلى شرائح والأتمتة المدفوعة بالإيرادات (عبر Brevo وغيره من مزودي التفاعل).

نظرة عامة

الخاصية	القيمة
المصادقة	مفتاح Stripe السري (sk_live_... / sk_test_...) أو مفتاح مقيّد
الوصول	للقراءة فقط، فـ Tajo لا يكتب أبدًا في حسابك على Stripe
عنوان API الأساسي	https://api.stripe.com/v1
اتجاه المزامنة	من Stripe إلى Tajo
webhooks في الوقت الفعلي	ليس بعد، فالمزامنة اليوم قائمة على الاستطلاع

الإعداد

1. في لوحة تحكم Stripe، افتح Developers ← API keys.
2. أنشئ مفتاحًا مقيّدًا، وتكفي صلاحية القراءة على Customers وCharges وSubscriptions وInvoices. والمفتاح المقيّد مفضّل بقوة على المفتاح السري الكامل: فـ Tajo يقرأ فقط، فامنح القراءة وحدها.
3. الصق المفتاح في اتصال Stripe داخل Tajo.

يُتحقق من الاتصال بطلب للقراءة فقط قبل بدء أي مزامنة. ويمكنك تدوير المفتاح أو إلغاءه في Stripe في أي وقت.

ما الذي يُزامَن

البيانات	ما يفعله Tajo بها
العملاء	تُحوَّل إلى جهات اتصال (البريد الإلكتروني والاسم والهاتف والعنوان) من أجل الهوية والتقسيم إلى شرائح. ولا يُستنتج القبول أبدًا من مجرد وجود سجل عميل.
المدفوعات	أحداث إيراد من أجل الأتمتة القائمة على الشراء عبر دورة الحياة والتقسيم حسب القيمة الدائمة
الاشتراكات	حالة دورة الحياة (active وpast_due وcanceled وغيرها) من أجل مسارات تحصيل المتأخرات والاستعادة والاحتفاظ
الفواتير	حالة الدفع من أجل الرسائل المرتبطة بالفوترة

يستخدم التقسيم إلى صفحات نموذج المؤشر لدى Stripe (starting_after)، فتُزامَن الحسابات الكبيرة بالكامل ومع إمكانية الاستئناف.

القيود الحالية

مذكورة بصراحة كي تخطط على أساسها:

• لا توجد webhooks في الوقت الفعلي بعد. تصل التغييرات وفق جدول المزامنة، لا في لحظة نجاح الدفع. واستقبال webhooks مدرج على خارطة الطريق.
• للقراءة فقط. لا ينشئ Tajo عملاء أو مدفوعات أو اشتراكات في Stripe ولا يعدّلها.
• لا يوجد تطبيق Stripe. لا يوجد اليوم تطبيق Tajo في متجر تطبيقات Stripe؛ فالاتصال يُضبط داخل Tajo، لا في لوحة تحكم Stripe.

استكشاف الأخطاء

العَرَض	السبب والحل
خطأ 401 من Stripe	أُلغي المفتاح أو جرى تدويره، فالصق المفتاح الحالي في الاتصال
العملاء يُزامَنون لكن المدفوعات لا	المفتاح المقيّد تنقصه صلاحية القراءة على Charges
جهة اتصال بلا بريد إلكتروني	يُزامَن عملاء Stripe بلا بريد إلكتروني كسجلات إيراد مجهولة، وينضمون إلى رسم جهات الاتصال إذا أُضيف البريد لاحقًا

الخطوات التالية

• مزامنة العملاء: تعيين عملاء Stripe داخل نظام السجل لديك
• ابنِ في Tajo أتمتة تحصيل المتأخرات واستعادة العملاء استنادًا إلى تغيّرات حالة الاشتراك