עיבוד תשלומים באמצעות Firebase

בעזרת כמה תכונות שונות של Firebase ו-Stripe, אפשר לעבד תשלומים באפליקציית האינטרנט בלי ליצור תשתית שרת משלכם. במדריך הזה נסביר איך להתאים אישית ולפרוס גרסה משלכם של אפליקציית הדוגמה cloud-functions-stripe-sample.web.app בקוד פתוח.

לפני שמתחילים, צריך ליצור פרויקט במסוף Firebase ולהגדיר חשבון Stripe.

הערה: השותפים שלנו ב-Stripe השיקו שני תוספים חדשים, הפעלת תשלומים על מינויים באמצעות Stripe ו-שליחת חשבוניות באמצעות Stripe, כדי לאפשר לכם לעבד תשלומים עם פחות קוד!

סקירה כללית על ההטמעה

1. מגדירים חשבון Stripe.
2. יוצרים פרויקט במסוף Firebase.
3. משדרגים את הפרויקט לתוכנית התמחור Blaze בתשלום לפי שימוש.
4. מגדירים את ה-CLI של Firebase כך שישתמש בפרויקט שלכם באמצעות firebase use --add.
5. מקבלים את קוד המקור של אפליקציית Firestripe לדוגמה. מגדירים אותה עם המידע המתאים לפרויקט ומתאימים אישית את הקוד כך שיתאים לאפליקציה.
6. אחרי הפריסה של האפליקציה, תוכלו לחפש רשימה של משתמשים ועסקאות במסוף Firebase.

הגדרה ופריסה של האפליקציה לדוגמה

1. מורידים את קוד המקור.
2. מפעילים את הכניסה באמצעות חשבון Google והכניסה באמצעות אימייל בהגדרות של ספק האימות.
3. מפעילים את Cloud Firestore.
4. מתקינים את CLI של 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 אל 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.