Stripe

الطريقة الأخرى: الصق مفاتيحك الخاصة

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

ما تحتاجه

فقط المسار الرئيسي يحتاج إلى هذه. إذا قمت بتسجيل الدخول باستخدام Stripe أعلاه، فليس هناك ما يمكنك جمعه. Stripe يحتفظ بمفاتيح منفصلة لوضع الاختبار والوضع المباشر (pk_test_ / sk_test_ مقابل pk_live_ / sk_live_)، ولكل منهما سر توقيع خطاف الويب الخاص به. يحمل Coin Moebius كلاً من علامتي التبويب Live وTest، حتى تتمكن من التحقق من مفاتيح الاختبار وإضافة المفاتيح المباشرة لاحقًا دون إعادة إدخال كل شيء.

لماذا نطلب كل حقل

المفتاح القابل للنشر

يعرّف حسابك حين تفتح صفحة الدفع في متصفح المشتري. عام بالتصميم.

المفتاح السري

النصف الخاص الذي يفوّض إنشاء الخصمة، فتجري الدفعة عبر حسابك.

سر توقيع الـ webhook

يثبت أن webhook وارداً من Stripe فعلاً، فلا يستطيع أحد تزوير حدث "مدفوع". وهو قيمة منفصلة عن المفتاح السري.

عنوان النجاح والإلغاء

إعدادات بسيطة: حيث يصل المشتري بعد الدفع أو التراجع. ليست سرية.

الإعداد

1. استخدم وضع الاختبار (مجاني)

   حساب Stripe مجاني، ويعمل وضع الاختبار قبل التفعيل. سجّل الدخول على dashboard.stripe.com وفعّل وضع الاختبار (الزاوية العليا). أعدّ الاختبار أولاً، ثم كرّر في الوضع الحي.

2. انسخ مفاتيحك

   اذهب إلى Developers → API keys وانسخ المفتاح القابل للنشر والمفتاح السري.

   ⤢
3. أضف الـ webhook
   1. Developers → Webhooks → Add endpoint.
   2. اضبط عنوان نقطة النهاية على عنوان webhook مشروعك (أدناه).
   3. اختر الأحداث. للمدفوعات لمرة واحدة: checkout.session.completed، وcharge.refunded، وcharge.dispute.created. وإن كنت تبيع اشتراكات، أضِف أيضاً: customer.subscription.created، وcustomer.subscription.updated، وcustomer.subscription.deleted، وinvoice.payment_succeeded، وinvoice.payment_failed. الأحداث الإضافية غير ضارة، نتجاهل ما لا نستخدمه.
   4. انسخ سر توقيع نقطة النهاية (whsec_…). للاختبار والحي كلٌّ سرّه الخاص.

   https://api.coinmoebius.com/webhook/stripe/<your project id>

   ⤢
4. اختبر

   تعمل بطاقات الاختبار في وضع الاختبار فقط ولا تخصم من بطاقة حقيقية أبداً. استخدم أي تاريخ انتهاء مستقبلي، وأي CVC، وأي رمز بريدي.

   النتيجة	البطاقة
   تنجح	4242 4242 4242 4242
   تحتاج مصادقة	4000 0025 0000 3155
   مرفوضة	4000 0000 0000 9995

5. اربط في لوحة التحكم

   إضافة مزود → Stripe. أدخل المفتاح القابل للنشر، والمفتاح السري، وسر توقيع الـ webhook، وعنوان النجاح، وعنوان الإلغاء. استخدم مفاتيح الاختبار للتحقق من التدفّق، ثم عدّل المزود وبدّل بمفاتيح حية.

بعد أن تربط

قم بإجراء دفعة واحدة قبل بدء البث المباشر:

1. هل قمت بتسجيل الدخول باستخدام Stripe؟ حسابك نشط، لذا قم بشراء منتج بقيمة دولار واحد باستخدام بطاقتك الخاصة واسترده من Stripe بعد ذلك. مفاتيح الاختبار التي تم لصقها؟ كل دفعة هي دفعة اختبارية، لذا استخدم بطاقة اختبار من الأعلى.
2. أنشئ منتجاً وضع زر الشراء على صفحة (ملف HTML محلي يعمل) موجَّهاً إلى مشروعك.
3. ادفع ببطاقة اختبار من أعلاه.
4. افتح تبويب المعاملات. حين تبلغ حالة الصف الجديد succeeded، يعمل مفتاحاك والـ webhook من البداية إلى النهاية.

إذا استخدمت مفاتيح الاختبار، فقم بتحرير الموفر، وقم بتبديل مفاتيحك المباشرة، وستحصل على دفعات حقيقية.

حل المشكلات

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

لقد قمت بتسجيل الدخول باستخدام Stripe وحصلت على "الحساب متصل. مطلوب اتخاذ إجراء."

حسابك Stripe متصل ولكن Stripe لم يقم بمسحه لمدفوعات البطاقة بعد. افتح Stripe، وأكمل ما يطلبه (عادةً تفاصيل العمل أو حساب مصرفي)، ثم انقر على Verify على البطاقة Stripe في Coin Moebius.

البطاقة Stripe تقول "غير متصل".

تمت إزالة Coin Moebius من حسابك Stripe، عادةً من صفحة التطبيقات المعتمدة في Stripe. افتح البطاقة، واختر Edit، وانقر على Reconnect للموافقة عليها مرة أخرى.

يقول التحقق إن صيغة المفتاح خاطئة.

تبدأ المفاتيح السرية بـ sk_test_ أو sk_live_ (وتبدأ المفاتيح المقيَّدة بـ rk_). ويبدأ سر توقيع الـ webhook بـ whsec_. أعِد نسخ القيمة الصحيحة في الحقل الصحيح.

يقول التحقق إن Stripe رفض المفتاح.

أعِد نسخ المفتاح السري من Developers → API keys، وتأكد من أنك لا تقرن مفتاح اختبار بسر webhook حي أو العكس.

تكتمل الدفعة لكن الطلب يبقى معلّقاً.

الـ webhook لا يصل. أكّد أن عنوان نقطة النهاية يطابق بالضبط، وأنك اخترت checkout.session.completed، وأن دفعة اختبار تصل إلى نقطة نهاية وضع اختبارك (الاختبار والحي نقطتا نهاية منفصلتان).

يفشل التحقق من التوقيع.

لكل نقطة نهاية Stripe سر توقيعها الخاص. انسخ whsec_ من إعدادات هذه النقطة، لا نقطة أخرى.

أكّده من البداية إلى النهاية.

لا يملك Stripe زر محاكاة. في لوحة تحكم Stripe، أعِد إرسال حدث حديث إلى نقطة نهايتك، أو أنشئ PaymentIntent اختباراً، ثم راقب تحديث الطلب.

جيد أن تعرف

تم تسجيل الدخول بـ Stripe. لا توجد مفاتيح أو أسرار خطاف الويب لنسخها أو تخزينها أو تدويرها. Stripe يخبر Coin Moebius عندما يتغير حسابك. لقص الرابط، انقر فوق Disconnect على البطاقة Stripe، أو قم بإزالة Coin Moebius ضمن التطبيقات المعتمدة في Stripe.

تدوير المفاتيح. هل قمت بلصق مفاتيحك الخاصة؟ قم بتدوير المفتاح السري أو webhook السري في أي وقت، ثم الصق القيمة الجديدة. تظل الحقول السرية فارغة عند التحرير حتى تتمكن من إدخال مفتاح تم تدويره.

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

أسئلة؟ Join our Discord