باستخدام بعض ميزات Firebase المختلفة و Stripe ، يمكنك معالجة المدفوعات في تطبيق الويب الخاص بك دون إنشاء البنية الأساسية للخادم الخاص بك. يرشدك هذا الدليل خلال تخصيص ونشر نسختك الخاصة من التطبيق السحابي مفتوح المصدر للوظائف السحابية -stripe-sample.web.app .
قبل أن تبدأ ، أنشئ مشروعًا في وحدة تحكم Firebase وقم بإعداد حساب Stripe .
نظرة عامة على التنفيذ
- قم بإعداد حساب Stripe .
- أنشئ مشروعًا في وحدة تحكم Firebase .
- قم بتمكين الفوترة لمشروعك وقم بتهيئة Firebase CLI لاستخدام مشروعك مع
firebase use --add
. - احصل على شفرة المصدر لعينة تطبيق Firestripe. قم بتكوينه بالمعلومات الصحيحة لمشروعك وخصص الكود ليناسب تطبيقك.
- بمجرد نشر تطبيقك ، ابحث عن قائمة بالمستخدمين والمعاملات في وحدة تحكم Firebase.
إعداد ونشر نموذج التطبيق
- احصل على الكود المصدري .
- قم بتمكين تسجيل الدخول إلى Google والبريد الإلكتروني في إعدادات مزود المصادقة .
- تفعيل Cloud Firestore .
- قم بتثبيت Firebase CLI إذا لم تكن قد قمت بذلك بالفعل ، وقم بتسجيل الدخول باستخدام
firebase login
. - قم بتكوين هذا النموذج لاستخدام مشروعك مع
firebase use --add
. - تثبيت التبعيات محليًا عن طريق تشغيل
cd functions; npm install; cd -
أضف Stripe API Secret Key إلى تكوين بيئة Cloud Functions:
firebase functions:config:set stripe.secret=<YOUR STRIPE SECRET KEY>
عيّن مفتاح Stripe القابل للنشر في
/public/javascript/app.js
:const STRIPE_PUBLISHABLE_KEY=<YOUR STRIPE PUBLISHABLE KEY>;
انشر مشروعك باستخدام
firebase deploy
. هذا الأمر:- يرسل جميع الملفات الموجودة في الدليل
public
إلى Hosting حتى يكون موقع الويب الخاص بك متاحًا. - يُرسل الرمز الموجود في دليل
functions
إلى Cloud Functions for Firebase. - يضبط قواعد الأمان على قاعدة بيانات Cloud Firestore كما تم تكوينها في
firestore.rules
. تسمح القواعد المقدمة للمستخدم بقراءة وكتابة مدفوعاته وطرق الدفع الخاصة به.
- يرسل جميع الملفات الموجودة في الدليل
اختبر نموذج التطبيق
قم بزيارة عنوان URL لتطبيق الدفعات على your-firebase-project-id.web.app
وتحقق من أن الميزات التالية تعمل:
- يمكنك تسجيل الدخول عبر جوجل أو البريد الإلكتروني.
- يمكنك إضافة بطاقة اختبار Stripe جديدة وعرضها في عنصر تحديد البطاقة.
- يمكنك اختيار واحدة من البطاقات الخاصة بك وشحنها.
- يمكنك تسجيل الخروج.
للمقارنة ، راجع الوظائف السحابية -stripe-sample.web.app .
لتوفير تجربة سلسة للمستخدمين ، يمكنك تخصيص مظهر صفحة الدفع بشكل أكبر أو توصيلها بتطبيقك الحالي.
عرض المدفوعات المعالجة
بمجرد إعداد صفحة المدفوعات ونشرها ، يمكنك التحقق من وحدة تحكم Firebase والاطلاع على قائمة بالمستخدمين بالإضافة إلى طرق الدفع والمدفوعات الخاصة بهم.
- انتقل إلى Cloud Firestore .
- تحقق من وجود قائمة بالمستخدمين لديك ، وإذا قاموا بإضافة أي بطاقات ائتمان أو أجروا أي معاملات ، فقم بقائمة بتلك الموجودة تحت كل مستخدم.
قبول المدفوعات الحية
بمجرد أن تصبح جاهزًا لبدء البث المباشر ، ستحتاج إلى استبدال مفاتيح الاختبار الخاصة بك بمفاتيح البث المباشر. راجع مستندات Stripe لمعرفة المزيد حول هذه المفاتيح.
قم بتحديث تكوين سر الشريط الخاص بك:
firebase functions:config:set stripe.secret=<YOUR STRIPE LIVE SECRET KEY>
عيّن مفتاحك المباشر القابل للنشر في
/public/javascript/app.js
.أعد نشر كل من وظائف السحابة والاستضافة لتصبح التغييرات سارية المفعول:
firebase deploy
.