معالجة المدفوعات باستخدام 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. تفعيل Cloud Firestore .
  4. قم بتثبيت Firebase CLI إذا لم تكن قد قمت بذلك بالفعل ، وقم بتسجيل الدخول باستخدام firebase login .
  5. قم بتكوين هذا النموذج لاستخدام مشروعك مع firebase use --add .
  6. تثبيت التبعيات محليًا عن طريق تشغيل cd functions; npm install; cd -
  7. أضف Stripe API Secret Key إلى تكوين بيئة 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 وتحقق من أن الميزات التالية تعمل:

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

للمقارنة ، راجع الوظائف السحابية -stripe-sample.web.app .

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

عرض المدفوعات المعالجة

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

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

قبول المدفوعات الحية

بمجرد أن تصبح جاهزًا لبدء البث المباشر ، ستحتاج إلى استبدال مفاتيح الاختبار الخاصة بك بمفاتيح البث المباشر. راجع مستندات Stripe لمعرفة المزيد حول هذه المفاتيح.

  1. قم بتحديث تكوين سر الشريط الخاص بك:

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

  2. عيّن مفتاحك المباشر القابل للنشر في /public/javascript/app.js .

  3. أعد نشر كل من وظائف السحابة والاستضافة لتصبح التغييرات سارية المفعول: firebase deploy .