Google 致力于为黑人社区推动种族平等。查看具体举措
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

إرسال الفواتير باستخدام Stripe

شريط
صنع بواسطة Stripe

ينشئ ويرسل فواتير العملاء ذات العلامات التجارية باستخدام منصة مدفوعات Stripe.

كيف يعمل هذا الامتداد

استخدم هذا الملحق لإنشاء وإرسال فواتير العملاء ذات العلامات التجارية باستخدام منصة الدفع Stripe .

يتم تخصيص الفواتير تلقائيًا بشعار ولون عملك الذي قمت بإعداده في Stripe. بعد إرسال الفاتورة ، يمكنك استخدام لوحة معلومات Stripe لتتبع ما إذا كان العميل قد دفع ومقدار الأموال التي عالجتها بتقارير ومخططات مفصلة.

يستمع هذا الامتداد إلى مجموعة Cloud Firestore المحددة الخاصة بك للمستندات الجديدة (مثل المثال أدناه). عند إضافة مستند ، يستخدم Stripe معلومات الفاتورة في المستند لإنشاء فاتورة في نظامهم ، ثم يرسل الفاتورة إلى عنوان البريد الإلكتروني المحدد في المستند. يمكنك إدارة عناوين البريد الإلكتروني للعملاء اختياريًا باستخدام معرفات مستخدم Firebase Authentication .

email: "customer@example.com",
items: [{
    amount: 2000,
    currency: "usd",
    quantity: 2, // Optional, defaults to 1.
    description: "Growth plan"
}]

فيما يلي مثال على الشكل الذي ستبدو عليه فاتورتك المخصصة!

صفحة فاتورة تعرض إيصالاً مفصلاً ، مع خيارات للدفع بالبطاقة أو التحويل المصرفي

من الميزات الاختيارية لهذا الامتداد تحديث حالة الفاتورة تلقائيًا في مستند Cloud Firestore الخاص بها. يمكنك تكوين هذه الميزة بعد تثبيت الامتداد عن طريق تسجيل خطاف ويب Stripe يستمع إلى أحداث فاتورة Stripe . إذا كنت تريد استخدام هذه الميزة الاختيارية ، فاترك المعلمة Stripe webhook secret فارغة أثناء التثبيت ، ثم Stripe webhook secret تكوين الملحق المثبت لاحقًا بالقيمة الفعلية للخطاف الصوتي المسجل على الويب. يتم توفير مزيد من التفاصيل حول هذه العملية بعد التثبيت.

الإعداد الإضافي

قبل تثبيت هذه الإضافة ، قم بإعداد خدمات Firebase التالية في مشروع Firebase:

  • Cloud Firestore لتخزين معلومات الفاتورة وحالة الفاتورة اختياريًا.
    • اتبع الخطوات الواردة في الوثائق لإنشاء قاعدة بيانات Cloud Firestore.
  • مصادقة Firebase لإدارة البريد الإلكتروني وبيانات العملاء بشكل اختياري.
    • قم بتمكين طرق تسجيل الدخول في وحدة تحكم Firebase التي تريد تقديمها للمستخدمين.

يجب أن يكون لديك أيضًا حساب Stripe ومفتاح Stripe API قبل تثبيت هذا الامتداد.

ملاحظة: يحتوي Stripe على وضع اختبار يتيح لك إجراء مكالمات API دون إجراء مدفوعات فعلية. لاستخدام هذا الامتداد مع وضع اختبار Stripe ، قم بتعيين معلمة Stripe API key بالملحق (أثناء تكوين الامتداد) لاستخدام مفتاح وضع الاختبار. يبدو مفتاح وضع الاختبار مثل rk_test_12345 ، في حين أن مفتاح الوضع المباشر سيكون rk_live_12345 . نظرًا لأن هذا الامتداد لا يتطلب سوى الوصول للكتابة إلى customers Stripe وموارد invoices ، فإننا نوصي بإنشاء مفتاح مقيد مع وصول محدود إلى هذه الموارد فقط بدلاً من استخدام مفتاحك السري.

الفواتير

تستخدم هذه الإضافة خدمات Firebase التالية التي قد يكون لها رسوم مرتبطة بها:

  • سحابة Firestore
  • وظائف السحابة
  • مصادقة Firebase (اختياري)

يستخدم هذا الامتداد أيضًا خدمات الجهات الخارجية التالية:

أنت مسؤول عن أي تكاليف مرتبطة باستخدامك لهذه الخدمات.

ملاحظة من Firebase

لتثبيت هذا الامتداد ، يجب أن يكون مشروع Firebase الخاص بك على خطة Blaze (الدفع أولاً بأول). سيتم محاسبتك فقط على الموارد التي تستخدمها. تقدم معظم خدمات Firebase مستوى مجانيًا للاستخدام منخفض الحجم. تعرف على المزيد حول فوترة Firebase.

اعتبارًا من 17 أغسطس 2020 ، ستتم محاسبتك على مبلغ صغير (عادةً أقل من 0.10 دولارًا أمريكيًا) عند تثبيت هذا الامتداد أو إعادة تكوينه. راجع الأسئلة الشائعة حول وظائف السحابة الخاصة بفواتير Firebase للحصول على شرح مفصل.

كيفية تثبيت هذا الامتداد

باستخدام وحدة تحكم Firebase

لتثبيت الإضافات وإدارتها ، يمكنك استخدام وحدة تحكم Firebase.

التثبيت باستخدام وحدة التحكم

استخدام Firebase CLI

لتثبيت الإضافات وإدارتها ، يمكنك أيضًا استخدام Firebase CLI:

الخطوة 1: قم بتشغيل الأمر npm التالي لتثبيت CLI أو التحديث إلى أحدث إصدار من CLI.

npm install -g firebase-tools
لا يعمل؟ ألق نظرة على مرجع Firebase CLI أو قم بتغيير أذونات npm الخاصة بك.

الخطوة 2: قم بتثبيت هذا الامتداد عن طريق تشغيل الأمر التالي

firebase ext:install stripe/firestore-stripe-invoices --project=projectId_or_alias
يدعم
مصادقة سحابة Firestore
مؤلف
بالتعاون مع
رخصة
اباتشي 2.0
إصدار
0.1.6