ربط Stripe بتطبيقك في MonstarX

استقبل المدفوعات بالبطاقة والاشتراكات وصفحات الدفع في تطبيقك.

النوع

لتطبيقك

الفئة

المدفوعات والفوترة

طريقة الربط

مفتاح API

Stripe شركة مدفوعات: تتولى نموذج البطاقة والجانب المصرفي والإيصالات، وتحوّل الأموال إلى حسابك المصرفي. اربطه، وسيتمكن تطبيقك من بيع ما تريد، سواء كان باقة حصص أو منتجًا أو عضوية شهرية، عبر صفحة دفع آمنة يديرها Stripe.

ماذا يمكنك أن تنشئ به؟

• زر «اشترِ الآن» يفتح صفحة الدفع في Stripe، ويعيد العميل إلى تطبيقك بعد أن يدفع.
• باقات ومجموعات، مثل «5 حصص مقابل $90»، تفتح شيئًا في التطبيق بعد الدفع.
• اشتراكات شهرية أو سنوية للأعضاء أو لخطة مدفوعة.
• سجل طلبات لكل عميل، وصفحة إدارة تعرض المدفوعات.
• متابعة تلقائية، مثل وضع علامة «مدفوع» على الطلب وإرسال إيصال بالبريد الإلكتروني، عندما يؤكد Stripe الدفع.

قبل أن تبدأ

• حساب في Stripe. إنشاؤه مجاني، ويقتطع Stripe رسومًا من كل عملية دفع ناجحة (راجع أسعار Stripe). ولا يضيف MonstarX أي رسوم عليها.
• للاختبار، لا تحتاج إلى شيء آخر: يستطيع كل حساب في Stripe استخدام بيئة اختبار (sandbox)، وهي نسخة تجريبية من حسابك لا تتحرك فيها أموال حقيقية.
• للمدفوعات الحقيقية، يطلب منك Stripe تفعيل حسابك أولًا، بإدخال بيانات نشاطك التجاري والحساب المصرفي الذي تُحوَّل إليه الأموال.

ما بيئة الاختبار والبيئة الفعلية؟

يمنحك Stripe مجموعتين من المفاتيح، ويسألك MonstarX في خيار البيئة عن المجموعة التي تلصقها:

البيئة	تبدأ المفاتيح بـ	ما يحدث
بيئة الاختبار (مفاتيح اختبار)	sk_test_… وpk_test_…	مدفوعات تجريبية بأرقام بطاقات اختبار. لا تُخصم أي مبالغ من بطاقة حقيقية ولا تتحرك أي أموال. استخدمها أثناء الإنشاء.
البيئة الفعلية (مفاتيح تشغيل فعلي)	sk_live_… وpk_live_…	بطاقات حقيقية وأموال حقيقية تُحوَّل إلى حسابك المصرفي. استخدمها عندما يدفع عملاء حقيقيون.

ما تنشئه في إحدى البيئتين لا يوجد في الأخرى: المنتجات والأسعار والعملاء والمدفوعات التي تُنشأ في بيئة الاختبار تبقى فيها.

كيف أدفع ببطاقة اختبار؟

في بيئة الاختبار، تقبل صفحة الدفع في Stripe بطاقات الاختبار التي ينشرها Stripe. استخدم أي تاريخ انتهاء في المستقبل (مثل 12/34)، وأي رمز CVC من ثلاثة أرقام، وأي رمز بريدي:

رقم البطاقة	ما يحدث
4242 4242 4242 4242	تنجح عملية الدفع.
4000 0000 0000 0002	تُرفض البطاقة، فترى ما يراه العملاء عندما يفشل الدفع.
4000 0025 0000 3155	يطلب المصرف تحققًا إضافيًا (3D Secure) قبل إتمام الدفع.

لا تكتب أبدًا رقم بطاقة حقيقية في صفحة دفع ضمن بيئة الاختبار. ويعرض Stripe المزيد من بطاقات الاختبار في دليل الاختبار.

احصل على مفاتيحك

1. سجّل الدخول إلى Stripe Dashboard.

2. للاختبار، افتح sandbox (بيئة اختبار) من قائمة الحساب في أعلى يسار الصفحة. وللتشغيل الفعلي، انتقل إلى live mode (الوضع الفعلي) بدلًا من ذلك.

3. افتح API keys (ضمن Developers). انسخ Publishable key، ثم اكشف Secret key وانسخه.

تنبيه

يستطيع المفتاح السري استقبال الأموال وإجراء عمليات الاسترداد في حسابك. لا تلصقه إلا في نموذج الموصل في MonstarX، ولا تلصقه أبدًا في المحادثة أو في رسالة بريد إلكتروني أو في شفرة تطبيقك. ولا يُعرض المفتاح السري الفعلي إلا مرة واحدة، فاحفظه في مكان آمن.

اربطه في MonstarX

عندما تطلب المدفوعات، يعرض MonstarX عادةً بطاقة ربط Stripe في المحادثة بالحقول نفسها. ويمكنك أيضًا أن تربطه بنفسك:

1. افتح مشروعك وانقر على الخدمات السحابية في الشريط العلوي، ثم على السحابة.

2. في قسم الموصلات، انقر على ربط بجانب Stripe.

3. اختر البيئة: بيئة الاختبار (مفاتيح اختبار) أو البيئة الفعلية (مفاتيح تشغيل فعلي).

4. الصق المفتاحين في حقلي مفتاح سري ومفتاح قابل للنشر. واترك سر توقيع Webhook فارغًا الآن.

   

5. انقر على ربط Stripe. يظهر في الصف متصل · بيئة الاختبار (أو متصل · البيئة الفعلية)، ويُعاد تشغيل المعاينة بالمفاتيح.

لا يتحقق MonstarX من أن المفاتيح تطابق البيئة التي اخترتها، لذلك تأكد من أن مفاتيح sk_test_ تذهب مع بيئة الاختبار، ومفاتيح sk_live_ مع البيئة الفعلية.

هل أحتاج إلى سر توقيع Webhook؟

يُقصد بـ webhook أن يخبر Stripe تطبيقك بأن «هذه الدفعة تمت»، حتى لو أغلق العميل الصفحة قبل أن يعود. التطبيقات التي تفتح شيئًا بعد الدفع، أو تشغّل اشتراكات، ينبغي أن يكون لها webhook. أضفه بعد نشر تطبيقك، لأن Stripe لا يستطيع الوصول إلى معاينتك الخاصة:

1. اسأل MonstarX: «ما عنوان webhook الخاص بـ Stripe في تطبيقي، وما الأحداث التي يجب أن يستمع إليها؟» وعادةً يكون https://your-app.monstarx.app/api/stripe-webhook.

2. في Stripe، افتح Webhooks، وانقر على Create an event destination، واختر تلك الأحداث، ثم اختر Webhook endpoint والصق العنوان.

3. اكشف signing secret (يبدأ بـ whsec_) وانسخه.

4. في MonstarX، انقر على تحديث المفاتيح في صف Stripe، والصقه في سر توقيع Webhook، ثم انقر على حفظ المفاتيح. انشر التطبيق مجددًا ليحصل عليه التطبيق المنشور.

لكل من بيئة الاختبار والوضع الفعلي webhooks وأسرار توقيع خاصة به.

اطلب من MonstarX استخدامه

ما تكتبه	ما يحدث
«دع الأعضاء يشترون باقة من 5 حصص مقابل $90 عبر Stripe.»	زر شراء، وصفحة دفع في Stripe بذلك المبلغ، وصفحة شكر. وتُضاف الباقة بعد الدفع.
«أضف خطة Pro شهرية بسعر $12 عبر Stripe، وصفحة أرى فيها خطتي.»	صفحة دفع للاشتراك، وصفحة تعرض خطة العضو.
«أضف صفحة إدارة تعرض كل المدفوعات.»	صفحة تعرض المدفوعات: من دفع، ومقابل ماذا، ومتى.
«استورد منتجاتي من Stripe إلى المتجر.»	يحتاج MonstarX إلى مفاتيحك لقراءة حسابك، فتقول البطاقة يحتاج MonstarX إلى Stripe للمتابعة، ويواصل العمل تلقائيًا بمجرد أن تربطه.

ليست لديك مفاتيح بعد؟ انقر على لاحقًا في البطاقة. ينشئ MonstarX صفحة الدفع كاملة رغم ذلك، ويوضّح الزر أن Stripe غير مربوط بعد إلى أن تضيف المفاتيح.

الانتقال إلى التشغيل الفعلي

1. فعّل حسابك في Stripe، وانتقل إلى الوضع الفعلي، وانسخ المفاتيح الفعلية.

2. في الخدمات السحابية›السحابة، انقر على تحديث المفاتيح في صف Stripe.

3. اضبط البيئة على البيئة الفعلية (مفاتيح تشغيل فعلي)، والصق المفتاحين الفعليين (وسر توقيع Webhook فعليًا إن كنت تستخدمه)، ثم انقر على حفظ المفاتيح.

4. انشر تطبيقك مجددًا. من الآن فصاعدًا، المدفوعات حقيقية.

نصيحة

ادفع بنفسك دفعة حقيقية بمبلغ صغير، ثم استردها من Stripe Dashboard. إنها أسرع طريقة للتأكد من أن كل شيء يعمل في الوضع الفعلي.

الأمان والخصوصية

• تُحفظ مفاتيحك مشفّرة مع هذا التطبيق فقط. تظهر أسماؤها في الخدمات السحابية›الأسرار، أما قيمها فلا تُعرض مجددًا أبدًا.
• لا يستخدم المفتاح السري وسر توقيع Webhook إلا خادم تطبيقك. أما المفتاح القابل للنشر فمصمّم ليظهر في المتصفح، وهذا آمن.
• تُكتب أرقام البطاقات في صفحة الدفع الخاصة بـ Stripe نفسه، ولا تصل أبدًا إلى تطبيقك أو إلى MonstarX.
• لا يستطيع ربط Stripe أو تحديثه أو قطع اتصاله إلا مالك المشروع. يزيل قطع الاتصال المفاتيح من هذا التطبيق، وعندها تعرض صفحة الدفع أن Stripe غير مربوط.
• إذا تسرّب مفتاح، فاستبدله (roll) في Stripe Dashboard، والصق المفتاح الجديد عبر تحديث المفاتيح.

معلومات مفيدة

• يستخدم التطبيق الواحد بيئة واحدة من Stripe في كل مرة. وإعادة تطبيق منشور إلى مفاتيح بيئة الاختبار توقف المدفوعات الحقيقية إلى أن تعود إلى المفاتيح الفعلية.
• يقدّم Stripe أيضًا مفاتيح مقيّدة (rk_…) لا تملك إلا الأذونات التي تختارها. وهي تعمل في حقل مفتاح سري إذا كانت تسمح بكل ما يفعله تطبيقك، مثل إنشاء جلسات الدفع.
• يختبر اختبار QA مسار الدفع حتى خطوة Stripe، ويضع عليه علامة تفيد بحاجته إلى المفاتيح ما دام Stripe غير مربوط.

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

هل يأخذ MonstarX حصة من مبيعاتي؟

لا. تذهب المدفوعات مباشرة إلى حسابك في Stripe. ولا تنطبق إلا رسوم Stripe نفسه.

هل يمكنني تجربة المدفوعات دون بطاقة حقيقية؟

نعم. اربط Stripe باختيار بيئة الاختبار (مفاتيح اختبار)، وادفع ببطاقة الاختبار 4242 4242 4242 4242 مع أي تاريخ في المستقبل وأي رمز CVC. لا تتحرك أي أموال.

كيف أنتقل من المدفوعات التجريبية إلى المدفوعات الحقيقية؟

انقر على تحديث المفاتيح في صف Stripe، واضبط البيئة على البيئة الفعلية (مفاتيح تشغيل فعلي)، والصق مفاتيحك الفعلية، ثم انقر على حفظ المفاتيح وانشر التطبيق مجددًا.

لماذا تقول صفحة الدفع إن Stripe غير مربوط؟

لم تُضف المفاتيح بعد، أو أُزيلت. افتح الخدمات السحابية ← السحابة واربط Stripe، وسيُعاد تشغيل المعاينة بالمفاتيح.

هل يمكنني رؤية المدفوعات في MonstarX؟

يعرض تطبيقك ما أنشأه MonstarX له، مثل صفحة الطلبات. أما السجل الكامل لكل دفعة واسترداد وتحويل فموجود في Stripe Dashboard.

صفحات ذات صلة

اربط خدمة بتطبيقككيف تعمل موصلات التطبيق والبطاقات وزر لاحقًا.

انشر تطبيقكأتح تطبيقك على الإنترنت ليتمكن Stripe من الوصول إليه.

Twilioأرسل إلى عملائك إيصالًا أو تذكيرًا برسالة نصية.

الأسرار ومفاتيح APIالمكان الذي تُحفظ فيه مفاتيحك.