معالجة الدفعات باستخدام Firebase

باستخدام بعض ميزات Firebase وStripe المختلفة، يمكنك معالجة الدفعات في تطبيق الويب بدون إنشاء البنية الأساسية للخادم. يرشدك هذا الدليل إلى كيفية تخصيص إصدارك من تطبيق المثال المفتوحة المصدر cloud-functions-stripe-sample.web.app ونشره.

قبل البدء، أنشئ مشروعًا في وحدة تحكّم Firebase وأعدّ حسابًا على Stripe.

ملاحظة: طرح شركاؤنا في Stripe وظيفتَين إضافيتين جديدتَين، وهما تنفيذ دفعات الاشتراكات باستخدام Stripe وإرسال الفواتير باستخدام Stripe، لتسهيل معالجة الدفعات باستخدام رمز أقل.

نظرة عامة على التنفيذ

1. إعداد حساب على Stripe
2. أنشئ مشروعًا في وحدة تحكُّم Firebase.
3. ترقية مشروعك إلى خطة أسعار Blaze المستندة إلى الدفع حسب الاستخدام
4. اضبط واجهة سطر أوامر Firebase لاستخدام مشروعك مع firebase use --add.
5. احصل على الرمز المصدر لنموذج تطبيق Firestripe. اضبطه باستخدام المعلومات الصحيحة لمشروعك وخصِّص الرمز ليناسب تطبيقك.
6. بعد نشر تطبيقك، ابحث عن قائمة بالمستخدمين والمعاملات في وحدة تحكّم Firebase.

إعداد نموذج التطبيق ونشره

1. احصل على رمز المصدر.
2. فعِّل تسجيل الدخول باستخدام حساب Google وعنوان البريد الإلكتروني في إعدادات موفِّر المصادقة.
3. فعِّل Cloud Firestore.
4. ثبِّت Firebase CLI إذا لم يسبق لك ذلك، وسجِّل الدخول باستخدام firebase login.
5. يمكنك ضبط هذا النموذج لاستخدام مشروعك مع firebase use --add.
6. تثبيت التبعيات على الجهاز من خلال تشغيل cd functions; npm install; cd -

7. أضِف مفتاح Stripe API السري إلى إعدادات بيئة Cloud Functions:

   firebase functions:config:set stripe.secret=<YOUR STRIPE SECRET KEY>

8. اضبط مفتاح Stripe القابل للنشر في /public/javascript/app.js:

   const STRIPE_PUBLISHABLE_KEY=<YOUR STRIPE PUBLISHABLE KEY>;

9. يمكنك نشر مشروعك باستخدام firebase deploy. يؤدي هذا الأمر إلى ما يلي:

   1. إرسال جميع الملفات في الدليل public إلى Hosting حتى يصبح موقعك الإلكتروني متاحًا
   2. تُرسِل الرمز في دليل functions إلى Cloud Functions for Firebase.
   3. تُستخدَم لضبط قواعد الأمان في قاعدة بيانات Cloud Firestore كما تم ضبطها في firestore.rules. لا تسمح القواعد المقدَّمة للمستخدم إلا بقراءة مدفوعاته وطُرق دفعه وتسجيلها.

اختبار التطبيق النموذجي

يُرجى الانتقال إلى عنوان URL لتطبيق الدفعات على الرابط your-firebase-project-id.web.app والتأكّد من أنّ الميزات التالية تعمل:

• يمكنك تسجيل الدخول من خلال Google أو البريد الإلكتروني.
• يمكنك إضافة بطاقة اختبار Stripe جديدة وعرضها في عنصر اختيار البطاقة.
• يمكنك اختيار إحدى بطاقاتك وشحنها.
• يمكنك تسجيل الخروج.

للمقارنة، اطّلِع على cloud-functions-stripe-sample.web.app.

لتوفير تجربة سلسة للمستخدمين، يمكنك تخصيص مظهر صفحة الدفع بشكل أكبر أو دمجها في تطبيقك الحالي.

الاطّلاع على الدفعات التي تمت معالجتها

بعد إعداد صفحة الدفعات ونشرها، يمكنك الانتقال إلى وحدة تحكّم Firebase والاطّلاع على قائمة بالمستخدمين وطرق الدفع والدفعات التي أجروها.

1. انتقِل إلى Cloud Firestore.
2. ابحث عن قائمة بالمستخدمين، وإذا أضافوا أي بطاقات ائتمان أو أجروا أي معاملات، ابحث عن قائمة بهذه البطاقات والمعاملات ضمن كل مستخدم.

قبول الدفعات المباشرة

عندما تكون مستعدًا لنشر التطبيق، عليك استبدال مفاتيح الاختبار بمفاتيح النشر. اطّلِع على مستندات Stripe لمعرفة المزيد عن هذه المفاتيح.

1. عدِّل إعدادات المفتاح السري في Stripe:

   firebase functions:config:set stripe.secret=<YOUR STRIPE LIVE SECRET KEY>

2. اضبط مفتاح النشر المباشر في /public/javascript/app.js.

3. أعِد نشر كلّ من Cloud Functions وHosting لتصبح التغييرات سارية: firebase deploy.