ربط Stripe

المتطلبات

قبل تكامل Stripe، تأكد من أن لديك:

• تطبيق MGX يعمل.
• مشروع MGX متصل بالفعل بمشروع Supabase. (تعرّف على المزيد حول Supabase.)
• أنشأت منتجات وأسعارها المقابلة في Stripe dashboard.

ملاحظة: لا يمكن استخدام وضع المعاينة لاختبار وظيفة الدفع. انشر تطبيق MGX الخاص بك وبدّل Stripe إلى Test Mode للتحقق من التكامل.

بطاقة الاختبار:

• رقم البطاقة: 4242 4242 4242 4242
• تاريخ الانتهاء: أي تاريخ مستقبلي
• CVC: أي رقم مكوّن من 3 خانات

إعداد دفع Stripe

1. قم بربط Supabase

   • انقر على زر Supabase في الزاوية العلوية اليمنى من MGX
   • اتبع أدلة ربط Supabase لتحديد مشروع Supabase المستهدف
   • بمجرد الاتصال، يمكنك تكوين إعدادات الدفع عبر Supabase

2. صف متطلبات الاشتراك الخاصة بك بلغة طبيعية

   • مثال: أنشئ نظام دفع يدعم ثلاث باقات اشتراك بسعر 4.99$ أسبوعيًا، و14.99$ شهريًا، و149.99$ سنويًا.

   بعد الإرسال، سيقوم Agent في MGX بإنشاء أزرار التكوين. ستحتاج إلى ملء حقلين على الأقل.

3. انقر على زر Add Stripe Secret Key

   

   • أدخل Stripe secret key الخاص بك ضمن حقل STRIPE_SECRET_KEY.
   • لكل باقة، أدخل Stripe Price ID المقابل لها في الحقل الذي ينتهي بـ PRICE_ID.

   

   يمكنك استرداد Stripe secret key الخاص بك من هنا: https://dashboard.stripe.com/test/apikeys

   انتقل إلى Product Catalog > Products، ثم احصل على price ID باستخدام إحدى الطريقتين التاليتين:

   • في قائمة "Pricing"، انقر على زر “More” الموجود إلى يمين السعر المقابل، ثم انقر على "Copy Price ID".

   

   يمكنك النقر مباشرة على اسم السعر لفتح صفحة التفاصيل، ثم نسخ price ID الظاهر في الزاوية العلوية اليمنى.

   

   أخيرًا، الصق كل price ID بدقة في حقل الإدخال المقابل.

   

   ملاحظة: حفاظًا على الخصوصية والأمان، لا تلصق secret key الخاص بك مباشرة في دردشة MGX مطلقًا. فقد يتيح كشفه وصولاً غير مصرح به إلى حساب Stripe الخاص بك. استخدم بدلًا من ذلك زر "Add API Key" في MGX لتخزينه بأمان.

4. انقر على زر Add Stripe Webhook Secret Key

   

   • أدخل Webhook Secret Key الخاص بك

5. كيفية العثور على Webhook Secret Key:

   في Stripe، انقر على “Developers” في الزاوية السفلية اليسرى، ثم اختر خيار Webhooks.

   

   في صفحة Webhooks، انقر على زر "Add destination".

   

   حدّد أحداث webhook التي تتوافق مع احتياجات مشروعك:

   • checkout.session.async_payment_failed
   • checkout.session.async_payment_succeeded
   • checkout.session.completed
   • checkout.session.expired

   

   بعد النقر على "Continue"، اختر "Webhook endpoint."

   

   أدخل Endpoint URL من Supabase.

   

6. كيفية العثور على Supabase Endpoint URL الخاص بك:

   انقر على View Edge Function في MGX.

   

   • انقر لتحديد edge function الذي يحمل اللاحقة _webhook المقابلة.

     

   • في لوحة Details الخاصة بـ edge function المقابل، انسخ Endpoint URL والصقه في Stripe Event Destination.

     

7. اختبر التكامل الخاص بك

   استخدم Test Mode في Stripe لاختبار المدفوعات.

   تفاصيل بطاقة الاختبار:

   • رقم البطاقة: 4242 4242 4242 4242
   • أي تاريخ انتهاء مستقبلي
   • أي CVC مكوّن من 3 خانات

الأسئلة الشائعة

لماذا لا يمكنني اختبار المدفوعات في وضع المعاينة؟

يعمل وضع المعاينة في بيئة محلية، وهي لا توفر Webhook URL متاحًا بشكل عام. يجب عليك نشر تطبيقك لتلقي أحداث Stripe.

كيف أنتقل إلى Production Mode؟

يمكنك تعطيل Test Mode في Stripe Dashboard واستخدام Secret Key وWebhook Secret المباشرين الخاصين بك.

كيف يمكنني التحقق مما إذا كانت دفعة اختبار قد نجحت؟

بعد إكمال دفعة اختبار، انتقل إلى صفحة Payments في Stripe لعرض سجلات معاملات الاختبار الخاصة بك.