تكامل Stripe — Payment Intents والاشتراكات وConnect وWebhooks

الجميع يربط Stripe. وقلّة تربطه كما ينبغي.

دليل Stripe السريع يمرّر دفعة في عشر دقائق. وما لا يعطيك إياه هو الربط الذي يصمد أمام webhook فاشل، أو إشعار مكرَّر، أو تحدي مصادقة، أو عملية متنازع عليها، أو اشتراك ينقضي الثالثة فجراً. تلك هي الشغلة.

💳 استقبال الدفعة

- Payment Intents في كل مكان — الواجهة الحالية، لا مسار Charges المهجور الذي ما يزال يملأ نصف الدروس على الإنترنت
- وسائل الدفع التلقائية، فتفعيل Apple Pay أو Google Pay أو Link أو وسيلة محلية لاحقاً مفتاح في اللوحة لا مشروع تطوير
- Stripe Checkout للطريق الأسرع، أو Elements حين يجب أن تكون صفحة الدفع صفحتك
- SCA و3-D Secure 2 مُعالَجان عبر Payment Intents، بما في ذلك العميل الذي يترك التحدي — فتلك النية لا مدفوعة ولا فاشلة ويجب حلّها لا تركها معلّقة
- بيانات البطاقة لا تمسّ خادمك أبداً؛ ويبقى نطاق امتثالك عند أدنى مستوى

🔁 الاشتراكات (Stripe Billing)

- منتجات وأسعار وباقات مبنية بحيث تستطيع تغيير التسعير لاحقاً دون ترحيل كل عميل
- فترات تجريبية، وتقسيم نسبي عند الترقية، وكميات بالمقاعد
- التحصيل المتعثّر — جدول إعادة المحاولة والرسائل ومسار تخفيض الباقة حين تفشل البطاقة أخيراً، وهناك يكمن معظم التسرّب الذي يمكنك منعه فعلاً
- بوابة العملاء مفعَّلة، فيدير المشتركون باقاتهم بأنفسهم بدل مراسلتك
- الفواتير وإعدادات الضريبة مضبوطة

🏪 الأسواق (Stripe Connect)

حيث تقسم المال بين بائعين: حسابات موصولة، وتسجيل، ورسوم تطبيق، وتحويلات ومدفوعات — مع معالجة سليمة لحالات الحساب، فالبائع الذي لم يُكمل التحقق لا يمكن أن يُدفع له ويعرف السبب.

🔔 webhooks مبنية لتصمد

- تحقق من التوقيع على كل حدث — فنقطة webhook غير موثَّقة باب مفتوح
- مفاتيح عدم التكرار على الاستدعاءات الصادرة ومعالجة تحتمل التكرار للأحداث الواردة، لأن Stripe سيسلّم الحدث نفسه أكثر من مرة ويجب ألا ينشئ ذلك طلباً ثانياً
- ترتيب الأحداث مُعالَج — فقد يصل payment_intent.succeeded قبل وجود السجل الذي يشير إليه
- مسح تسوية مجدول لكل ما لم يصل أبداً
- الأحداث الفاشلة مسجَّلة في مكان يراه إنسان فعلاً

⚖️ النزاعات والمرتجعات

المرتجعات والاسترداد الجزئي معروضة في إدارتك، وwebhooks النزاعات موجَّهة بحيث يصبح الاعتراض مهمةً لا مفاجأةً في كشف حساب بعد ستة أسابيع.

🧭 كيف يجري العمل

- اليوم 1: مراجعة نموذجك — دفعة مفردة أو اشتراك أو سوق أو مزيج — واختيار منتجات Stripe المناسبة
- الأيام 2–6: بناء في وضع الاختبار، وكل مسار مُجرَّب ببطاقات Stripe الاختبارية بما فيها SCA والرفض والنزاعات والتجديدات الفاشلة
- اليوم 7: مفاتيح الإنتاج، وعملية حقيقية بقيمة زهيدة، تُسترد فوراً
- التسليم: توثيق، وخريطة أحداث webhook، ومرجع بطاقات الاختبار

المنصات

Laravel (مع Cashier أو بدونه) · WordPress وWooCommerce · PHP مخصص · Node.js · Next.js · Python · Flutter وReact Native · أندرويد وiOS الأصليان

ملاحظة على النطاق

يغطي منصة واحدة بحساب Stripe واحد، ومدفوعات مفردة أو اشتراكات. أما أسواق Connect وتعدّد العملات وإعدادات الضريبة المعقّدة فتُسعَّر بعد مكالمة قصيرة.