پرداخت ها را با Firebase پردازش کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
با استفاده از چند ویژگی مختلف Firebase و Stripe، می توانید بدون ایجاد زیرساخت سرور خود، پرداخت ها را در برنامه وب خود پردازش کنید. این راهنما شما را در سفارشی سازی و استقرار نسخه خود از برنامه نمونه منبع باز ابری-functions-stripe-sample.web.app راهنمایی می کند.
قبل از شروع، یک پروژه در کنسول Firebase ایجاد کنید و یک حساب Stripe راه اندازی کنید.
مروری بر پیاده سازی
- یک حساب Stripe راه اندازی کنید.
- یک پروژه در کنسول Firebase ایجاد کنید.
- پروژه خود را به طرح قیمت گذاری Blaze به صورت پرداختی ارتقا دهید.
- 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
.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["Using a few different Firebase features and Stripe, you can process payments in\nyour web app without building your own server infrastructure. This guide walks\nyou through customizing and deploying your own version of the open-source\n[cloud-functions-stripe-sample.web.app](//cloud-functions-stripe-sample.web.app/) example app.\n\nBefore you start, create a project in the\n[Firebase console](https://console.firebase.google.com) and set up a\n[Stripe](https://stripe.com/) account.\n| **Note:** Our partners at Stripe have introduced two new extensions, [Run Subscription Payments with Stripe](https://firebase.google.com/products/extensions/firestore-stripe-subscriptions) and [Send Invoices using Stripe](https://firebase.google.com/products/extensions/firestore-stripe-invoices), to make it possible to process payments with even less code!\n\nImplementation overview\n\n1. Set up a [Stripe](//stripe.com/) account.\n2. Create a project in the [Firebase console](//console.firebase.google.com).\n3. Upgrade your project to the [pay-as-you-go Blaze pricing plan](/pricing).\n4. Configure the Firebase CLI to use your project with `firebase use --add`.\n5. Get the [source code](//github.com/firebase/functions-samples/tree/main/Node-1st-gen/stripe) for the sample Firestripe app. Configure it with the right information for your project and customize the code to fit your app.\n6. Once you've deployed your app, look for a list of users and transactions in the Firebase console.\n\nSet up and deploy the sample app\n\n1. Get the [source code](//github.com/firebase/functions-samples/tree/main/Node-1st-gen/stripe).\n2. Enable Google \\& Email sign-in in your [authentication provider settings](//console.firebase.google.com/project/_/authentication/providers).\n3. Enable [Cloud Firestore](//console.firebase.google.com/project/_/firestore).\n4. Install the [Firebase CLI](//github.com/firebase/firebase-tools) if you haven't already, and log in with `firebase login`.\n5. Configure this sample to use your project with `firebase use --add`.\n6. Install dependencies locally by running `cd functions; npm install; cd -`\n7. Add your [Stripe API Secret Key](//dashboard.stripe.com/account/apikeys)\n to your Cloud Functions environment configuration:\n\n `firebase functions:config:set stripe.secret=\u003cYOUR STRIPE SECRET KEY\u003e`\n8. Set your [Stripe publishable key](//dashboard.stripe.com/account/apikeys)\n in [`/public/javascript/app.js`](//github.com/firebase/functions-samples/tree/main/Node-1st-gen/stripe/public/javascript/app.js#L16):\n\n `const STRIPE_PUBLISHABLE_KEY=\u003cYOUR STRIPE PUBLISHABLE KEY\u003e;`\n9. Deploy your project using `firebase deploy`. This command:\n\n 1. Sends all the files in the `public` directory to Hosting so that your website is available.\n 2. Sends the code in the `functions` directory to Cloud Functions for Firebase.\n 3. Sets security rules on your Cloud Firestore database as configured in `firestore.rules`. The provided rules only allow a user to read and write their own payments and payment methods.\n\nTest the sample app\n\nVisit your payments app's URL at\n`your-firebase-project-id.web.app` and verify that the following features work:\n\n- You can sign in via Google or Email.\n- You can add a new [Stripe test card](//stripe.com/docs/testing) and view it in the card select element.\n- You can select one of your cards and charge it.\n- You can sign out.\n\nFor comparison, see\n[cloud-functions-stripe-sample.web.app](//cloud-functions-stripe-sample.web.app/).\n\nTo provide a streamlined experience for your users, you can further customize\nyour payment page's appearance, or plug it into your existing app.\n\nView processed payments\n\nOnce you've set up and deployed your payments page, you can check the Firebase\nconsole and see a list of users along with their payment methods and payments.\n\n1. Go to [Cloud Firestore](https://console.firebase.google.com/project/_/firestore/data).\n2. Check for a list of your users and, if they added any credit cards or made any transactions, a list of those under each user.\n\nAccept live payments\n\nOnce you're ready to go live, you'll need to exchange your test keys for your\nlive keys. See the [Stripe docs](https://stripe.com/docs/keys) to learn more\nabout these keys.\n\n1. Update your Stripe secret config:\n\n `firebase functions:config:set stripe.secret=\u003cYOUR STRIPE LIVE SECRET KEY\u003e`\n2. Set your [live publishable key](//dashboard.stripe.com/account/apikeys) in\n [`/public/javascript/app.js`](//github.com/thorsten-stripe/functions-samples/blob/thorsten-stripe/update-stripe-template/stripe/public/javascript/app.js#L16).\n\n3. Redeploy both Cloud Functions and Hosting for the changes to take effect:\n `firebase deploy`."]]