با استفاده از چند ویژگی مختلف Firebase و Stripe، می توانید بدون ایجاد زیرساخت سرور خود، پرداخت ها را در برنامه وب خود پردازش کنید. این راهنما شما را در سفارشی سازی و استقرار نسخه خود از برنامه نمونه منبع باز ابری-functions-stripe-sample.web.app راهنمایی می کند.
قبل از شروع، یک پروژه در کنسول Firebase ایجاد کنید و یک حساب Stripe راه اندازی کنید.
مروری بر پیاده سازی
- یک حساب Stripe راه اندازی کنید.
- یک پروژه در کنسول Firebase ایجاد کنید.
- صورتحساب پروژه خود را فعال کنید و Firebase CLI را برای استفاده از پروژه شما با
firebase use --add
پیکربندی کنید. - کد منبع نمونه برنامه Firestripe را دریافت کنید. آن را با اطلاعات مناسب برای پروژه خود پیکربندی کنید و کد را متناسب با برنامه خود سفارشی کنید.
- هنگامی که برنامه خود را راه اندازی کردید، به دنبال لیستی از کاربران و تراکنش ها در کنسول Firebase باشید.
برنامه نمونه را راه اندازی و اجرا کنید
- کد منبع را دریافت کنید.
- ورود به سیستم Google & Email را در تنظیمات ارائه دهنده احراز هویت خود فعال کنید.
- 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
دیدن کنید و بررسی کنید که ویژگیهای زیر کار میکنند:
- می توانید از طریق گوگل یا ایمیل وارد شوید.
- می توانید یک کارت تست 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
.