مدفوعات Stripe

1ما الذي يمنحه هذا لتطبيقك#

يتيح للتطبيقات التي تنشئها تحصيل أموال حقيقية - جدران دفع وترقيات 'Pro' وأزرار شراء - عبر Stripe Checkout.

إنه حساب Stripe الخاص بك: مفاتيحك وأموالك، وتُدفع إليك مباشرة. لا يأخذ AppMint أي عمولة ولا يتحمل أي مسؤولية عن المدفوعات (بدون Stripe Connect). تربط Stripe مرة واحدة في الإعدادات؛ وكل تطبيق تنشئه يعيد استخدامه - تصف فقط ما تريد بيعه ولا تعيد إدخال المفاتيح.

يكتب الذكاء الاصطناعي كل كود الدفع. ولا يُشحن مفتاحك السري داخل التطبيق أبدًا - بل يبقى في الواجهة الخلفية على Supabase.

2اربط Supabase أولًا (مطلوب)#

تحتاج مدفوعات Stripe إلى خادم آمن يحفظ مفتاحك السري ويؤكد المدفوعات - وهذا الخادم هو مشروع Supabase الخاص بك. لذا اربط Supabase وفعّله أولًا (الإعدادات ← BACKEND - SUPABASE) - يشرح ذلك الفصل '🗄️ Supabase Backend (Connect It Once)' في أعلى هذا الدليل.

إذا لم يكن Supabase مفعّلًا سترى 'Stripe keys saved, but payments also need Supabase active'. يدفع AppMint سرّ Stripe الخاص بك إلى دوال Supabase تلقائيًا عند النشر - ولا يوضع أبدًا داخل التطبيق المولَّد.

3احصل على مفاتيح Stripe (ابدأ في وضع الاختبار)#

على الحاسوب:

1. افتح لوحة Stripe وابقَ في وضع الاختبار / sandbox أثناء البناء (تسمي Stripe الآن بيئة الاختبار 'sandbox'؛ وتعرض الحسابات الأقدم مفتاح Test/Live). لا تحدث أي عمليات دفع حقيقية هنا.
2. اذهب إلى Developers ← API keys.
3. انسخ 'Publishable key' (يبدأ بـ pk_test_…) واكشف وانسخ 'Secret key' (يبدأ بـ sk_test_…).

استخدم المفتاح السري القياسي (sk_…)، وليس المفتاح المقيّد (rk_…) - يتحقق AppMint من المفتاح sk_ ويدفعه. لا تحتاج إلى موافقة التاجر لبناء العملية كاملة واختبارها قبل تفعيل المدفوعات الحقيقية.

افتح مفاتيح Stripe API ←

4اربط Stripe في AppMint#

افتح AI Studio ← الإعدادات ← مرر إلى 'PAYMENTS - STRIPE (OPTIONAL)' ← 'CONNECT STRIPE (YOUR ACCOUNT)':

1. اترك 'Live mode' مغلقًا الآن (مغلق = وضع الاختبار).
2. الصق المفتاح العام (publishable key) في حقل pk_test_….
3. الصق مفتاحك السري في حقل sk_test_… (يُحفظ مشفّرًا على هذا الجهاز).
4. فعّل 'Enable Stripe payments for generated apps'.
5. اضغط 'Validate & save Stripe keys'. يتحقق AppMint من الصيغة ومن أن المفتاحين في الوضع نفسه، ويتأكد من المفتاح السري مع Stripe. عند النجاح سترى '● Connected (TEST)'.

5ما الذي يجهزه AppMint لك#

عند إنشاء تطبيق مع مدفوعات، يتولى AppMint التوصيلات تلقائيًا - لا تحتاج إلى لمس لوحات Supabase أو Stripe:

• يدفع STRIPE_SECRET_KEY الخاص بك إلى دوال Supabase Edge (مشفّرًا، في جهة الخادم فقط).
• ينشر دالة 'create-checkout' (تبدأ جلسة Stripe Checkout) ودالة 'stripe-webhook' (تؤكد المدفوعات).
• يسجّل الـ webhook لدى Stripe ويخزّن سرّ التوقيع الخاص به.
• ينشئ جدول 'entitlements' ليعرف التطبيق من دفع.

المفتاح العام (pk_) هو قيمة Stripe الوحيدة التي تُشحن داخل التطبيق - ومن الآمن أن يكون عامًا.

6صِف جدار الدفع - والذكاء الاصطناعي يبنيه#

قل ما تريد بلغة عادية فقط. يضيف الذكاء الاصطناعي زر الشراء واستدعاء الدفع ويقفل الميزات المدفوعة نيابةً عنك:

• 'اشحن 5$ مرة واحدة لفتح سمة Pro.'
• 'اشتراك بسعر 9$ شهريًا يزيل الإعلانات.'
• 'بِع ملف PDF قابلاً للتنزيل بسعر 19$.'

لا تلصق المفاتيح أو الأسعار في المحادثة كإعدادات - فقط ما تريده. لا يُفتح الوصول إلا بعد أن تؤكد Stripe الدفع عبر الـ webhook، وليس أبدًا من علامة "تم الدفع" في جهة العميل، لذا لا يمكن تزويرها.

7اختبر عملية دفع من البداية إلى النهاية#

في وضع الاختبار لا تتحرك أموال حقيقية. شغّل العملية كاملة:

1. افتح تطبيقك واضغط زر الشراء/الترقية.
2. في صفحة Stripe Checkout، ادفع باستخدام بطاقة الاختبار:

 4242 4242 4242 4242, any future expiry, any CVC, any ZIP.

1. تعود إلى التطبيق وتنفتح الميزة المدفوعة.
2. افتح لوحة Stripe (وضع الاختبار) ← Payments - سترى عملية الدفع التجريبية.

إذا انفتح المحتوى، فهذا يعني أن الـ webhook والصلاحيات موصولة بشكل صحيح.

4242 4242 4242 4242   exp: any future date   CVC: any 3 digits

8انتقل إلى الوضع الحقيقي عندما تكون جاهزًا#

1. فعّل حساب Stripe للمدفوعات الحقيقية (لوحة Stripe ← 'Activate' / أكمل بيانات النشاط التجاري).
2. في Stripe، انتقل من وضع sandbox/الاختبار إلى الوضع الحقيقي وانسخ مفاتيحك الحقيقية (pk_live_… وsk_live_…) من Developers ← API keys.
3. في AppMint ← الإعدادات ← المدفوعات: فعّل 'Live mode'، والصق مفاتيح pk_live_/sk_live_، ثم اضغط 'Validate & save'. ستتحول الشارة إلى '● Connected (LIVE)'.
4. أعد بناء تطبيقك.

يمنع AppMint خلط مفاتيح الاختبار والمفاتيح الحقيقية، وتبديل الوضع يعيد توجيه السرّ المنشور - لا يتعايش الاختبار والإنتاج في تطبيق واحد، فلا يمكنك أن تنشر مفاتيح الاختبار بالخطأ.

9إذا لم يعمل شيء#

• 'Stripe keys saved, but payments also need Supabase active' ← فعّل Supabase أولًا (الخطوة 2).

• 'You selected TEST but the keys are LIVE' (أو العكس) ← يجب أن يطابق مفتاح الوضع بادئة مفاتيحك (pk_test/sk_test مقابل pk_live/sk_live).

• 'Stripe rejected the key' ← المفتاح السري خاطئ أو ملغى. انسخه مجددًا من Developers ← API keys.

• نجح الدفع لكن الميزة ما زالت مقفلة ← لم يصل الـ webhook إلى Supabase. أعد البناء/النشر ليعيد AppMint تسجيل الـ webhook، وتأكد أن مشروع Supabase للتطبيق هو الذي ربطته.

• لا يمكن تفعيل حساب حقيقي ← لا تقبل Stripe التجار في بعض الدول (ومنها الهند). يعمل وضع الاختبار في كل مكان للبناء؛ أما للدفع الحقيقي هناك فستحتاج دولة تدعمها Stripe أو مزود دفع آخر.