بااستفاده از چند ویژگی مختلف Firebase و Stripe، میتوانید پرداختها را در برنامه وب خود بدون ساختن زیرساخت سرور خودتان پردازش کنید. این راهنما شما را در سفارشیسازی و استقرار نسخه خودتان از برنامه نمونه منبع باز cloud-functions-stripe-sample.web.app راهنمایی میکند.
قبلاز شروع، پروژهای در کنسول Firebase ایجاد کنید و حساب Stripe راهاندازی کنید.
نمای کلی پیادهسازی
- حساب Stripe راهاندازی کنید.
- پروژهای در کنسول Firebase ایجاد کنید.
- پروژهتان را به طرح قیمتگذاری Blaze با پرداخت به اندازه استفاده ارتقا دهید.
- Firebase CLI را پیکربندی کنید تا از پروژه شما با
firebase use --addاستفاده کند. - کد منبع را برای نمونه برنامه Firestripe دریافت کنید. آن را با اطلاعات درست برای پروژهتان پیکربندی کنید و کد را برای تناسب با برنامهتان سفارشیسازی کنید.
- پساز استقرار برنامهتان، فهرست کاربران و تراکنشها را در کنسول Firebase ببینید.
راهاندازی و پیادهسازی برنامه نمونه
- دریافت کد منبع.
- «ورود به سیستم با Google و ایمیل» را در تنظیمات ارائهدهنده اصالتسنجی فعال کنید.
- Cloud Firestore را فعال کنید.
- اگر قبلاً Firebase CLI را نصب نکردهاید، آن را نصب کنید و با
firebase loginبه سیستم وارد شوید. - این نمونه را پیکربندی کنید تا از پروژه شما با
firebase use --addاستفاده کند. - با اجرای
cd functions; npm install; cd -، وابستگیها را بهصورت محلی نصب کنید کلید خصوصی Stripe API خود را به پیکربندی محیط 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پیکربندی شده است تنظیم میکند. قوانین ارائهشده فقط به کاربر اجازه میدهد پرداختها و روشهای پرداخت خود را بخواند و بنویسد.
- همه فایلهای موجود در فهرست
آزمایش برنامه نمونه
به نشانی وب برنامه پرداختهایتان در
your-firebase-project-id.web.app بروید و بررسی کنید که ویژگیهای زیر کار میکنند:
- میتوانید ازطریق Google یا «ایمیل» به سیستم وارد شوید.
- میتوانید کارت آزمایشی Stripe جدیدی اضافه کنید و آن را در عنصر انتخاب کارت مشاهده کنید.
- میتوانید یکی از کارتهایتان را انتخاب کنید و آن را شارژ کنید.
- میتوانید از سیستم خارج شوید.
برای مقایسه، به cloud-functions-stripe-sample.web.app مراجعه کنید.
برای ارائه تجربهای ساده به کاربران، میتوانید ظاهر صفحه پرداخت را بیشتر سفارشیسازی کنید یا آن را به برنامه موجودتان متصل کنید.
مشاهده پرداختهای پردازششده
پساز راهاندازی و استقرار صفحه پرداختهایتان، میتوانید کنسول Firebase را بررسی کنید و فهرستی از کاربران را بههمراه روشهای پرداخت و پرداختهایشان ببینید.
- به Cloud Firestore بروید.
- فهرست کاربران خود را بررسی کنید و اگر کارت اعتباری اضافه کردهاند یا تراکنشی انجام دادهاند، فهرست آنها را در زیر هر کاربر بررسی کنید.
پذیرفتن پرداختهای زنده
وقتی آماده شروع پخش زنده بودید، باید کلیدهای آزمایشیتان را با کلیدهای پخش زنده مبادله کنید. برای کسب اطلاعات بیشتر درباره این کلیدها، به اسناد Stripe مراجعه کنید.
پیکربندی محرمانه Stripe را بهروز کنید:
firebase functions:config:set stripe.secret=<YOUR STRIPE LIVE SECRET KEY>کلید قابل انتشار زنده خود را در
/public/javascript/app.jsتنظیم کنید.برای اعمال تغییرات، هم Cloud Functions و هم Hosting را دوباره مستقر کنید:
firebase deploy.