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

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

قبل البدء، قم بإنشاء مشروع في وحدة تحكم Firebase وقم بإعداد حساب Stripe .

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

  1. قم بإعداد حساب Stripe .
  2. قم بإنشاء مشروع في وحدة تحكم Firebase .
  3. قم بتمكين الفوترة لمشروعك وقم بتكوين Firebase CLI لاستخدام مشروعك باستخدام firebase use --add .
  4. احصل على الكود المصدري لنموذج تطبيق Firestripe. قم بتكوينه بالمعلومات الصحيحة لمشروعك وقم بتخصيص الكود ليناسب تطبيقك.
  5. بمجرد نشر تطبيقك، ابحث عن قائمة بالمستخدمين والمعاملات في وحدة تحكم Firebase.

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

  1. احصل على الكود المصدري .
  2. قم بتمكين تسجيل الدخول إلى Google والبريد الإلكتروني في إعدادات موفر المصادقة الخاص بك.
  3. تمكين سحابة Firestore .
  4. قم بتثبيت واجهة سطر أوامر Firebase إذا لم تكن قد قمت بذلك بالفعل، وقم بتسجيل الدخول باستخدام 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 إلى الاستضافة بحيث يكون موقع الويب الخاص بك متاحًا.
    2. يرسل الكود الموجود في دليل functions إلى Cloud Functions for Firebase.
    3. يضبط قواعد الأمان على قاعدة بيانات Cloud Firestore الخاصة بك كما تم تكوينها في firestore.rules . تسمح القواعد المقدمة للمستخدم فقط بقراءة وكتابة المدفوعات وطرق الدفع الخاصة به.

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

قم بزيارة عنوان URL لتطبيق الدفعات الخاص بك على your-firebase-project-id.web.app وتحقق من عمل الميزات التالية:

  • يمكنك تسجيل الدخول عبر جوجل أو البريد الإلكتروني.
  • يمكنك إضافة بطاقة اختبار 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. أعد نشر كل من الوظائف السحابية والاستضافة حتى تدخل التغييرات حيز التنفيذ: firebase deploy .