كيف تربط Stripe بـ heyhey

يتيح لك Stripe استلام المدفوعات مقابل منتجاتك وإدارة الاشتراكات. في heyhey تربط حسابك الخاص في Stripe باستخدام مفتاح مقيّد الصلاحيات (restricted key). لا تحتاج إلى كتابة أي كود أو تثبيت أي إضافة، وتُودَع المدفوعات في حسابك على Stripe وفق شروط Stripe.

بعد اتباع هذا الدليل، يُفترض أن تظهر بطاقة Stripe في heyhey بحالة متصل (Connected)، وأن ينتهي شراء أي منتج بطلب مدفوع ووصول المشتري إلى ما اشتراه.

1. جهّز حسابك وافتح الإعدادات الصحيحة

1. سجّل الدخول إلى حسابك على stripe.com. إذا كنت تنشئ الحساب الآن، فأكمل خطوات التفعيل التي يعرضها عليك Stripe. سيطلب منك Stripe بيانات نشاطك التجاري وعنوان موقعك الإلكتروني وحسابًا مصرفيًا لتحويل المبالغ إليه، وقد يطلب التحقق من هويتك. وتختلف المتطلبات بحسب بلدك.
2. تأكد من أن لديك صلاحية إدارة مفاتيح API. إذا لم يظهر لك هذا القسم، فاطلب من مالك الحساب منحك الصلاحية المناسبة.
3. في علامة تبويب ثانية في المتصفح، افتح إعدادات المدفوعات في لوحة تحكم heyhey. ستجدها في المبيعات (Sales) ← المدفوعات (Payments).
4. ابحث عن بطاقة Stripe. أبقِ علامتَي التبويب مفتوحتين، فستنقل مفتاحًا واحدًا بينهما.

API وسيلة ربط بين الأنظمة. ومفتاح API معرّف سري يسمح لـ heyhey بتنفيذ إجراءات محددة ومتفق عليها في حسابك على Stripe، وهو ليس كلمة مرور لتسجيل الدخول.

2. أنشئ مفتاحًا مقيّد الصلاحيات

في لوحة تحكم Stripe، افتح قسم Developers ثم API keys. في التصميم الأحدث قد تصل إلى أدوات المطورين عبر Workbench. ويمكنك أيضًا فتح صفحة API keys مباشرة.

1. تأكد من أنك تعمل في الحساب الصحيح وفي الوضع المناسب: الوضع الفعلي (live) للمبيعات الحقيقية، أو الوضع التجريبي (test) للتجارب.
2. اختر Create restricted key لإنشاء مفتاح مقيّد الصلاحيات.
3. أعطه اسمًا يسهل التعرف عليه، مثل heyhey.
4. إذا عرض عليك Stripe مجموعات صلاحيات جاهزة، فاختر الإعداد اليدوي عبر Choose your own.
5. اضبط الصلاحيات كما في الجدول أدناه، ثم أنشئ المفتاح وانسخ قيمته كاملة. احفظه في مدير كلمات المرور، فقد لا تتمكن من عرضه مرة أخرى.

تشرح وثائق Stripe الخاصة بمفاتيح API طريقة إنشاء المفاتيح والفرق بين الوضعين. أما الصلاحيات أدناه فهي ما يحتاجه ربط heyhey.

3. امنح هذه الصلاحيات بالضبط

نُبقي الأسماء في الجدول كما تظهر في لوحة تحكم Stripe باللغة الإنجليزية، ليسهل عليك العثور عليها.

ستجد Prices وSubscriptions وCustomer Portal وInvoices ضمن قسم Billing، وAccounts ضمن قسم Connect. اترك جميع الموارد الأخرى على None (بلا وصول). صلاحية «Write» تشمل الإجراءات التي تتطلب حفظ بيانات، لذلك لا تكفي صلاحية «Read» وحدها في هذه الصفوف.

4. الصق المفتاح في heyhey

1. عُد إلى بطاقة Stripe في heyhey.
2. الصق المفتاح في حقل مفتاح API. يبدأ المفتاح الفعلي بـ rk_live_، ويبدأ المفتاح التجريبي بـ rk_test_.
3. مع المفتاح التجريبي، فعّل خيار Sandbox / test mode (الوضع التجريبي). ومع المفتاح الفعلي، اترك هذا الخيار غير مفعّل.
4. انقر على Connect Stripe (ربط Stripe) وانتظر نتيجة التحقق.

لا تلصق المفتاح العام الذي يبدأ بـ pk_، ولا المفتاح السري الكامل sk_، ولا سرّ الـ Webhook الذي يبدأ بـ whsec_. فهذه أنواع مختلفة من بيانات الاعتماد، ونموذج heyhey يتطلب مفتاحًا يبدأ بـ rk_.

تتحقق heyhey من المفتاح وتسجّل Webhook، وهو إشعار تلقائي يرسله Stripe. ومن خلال هذه الإشعارات تعرف heyhey ما إذا دُفعت قيمة الشراء، أو تجدّد الاشتراك، أو استُرد مبلغ. لا تحتاج إلى إدخال عنوان الـ Webhook بنفسك.

5. تحقّق من الحالة وطرق الدفع

حالة متصل (Connected) تعني أن الإعداد قد قُبل. إذا ظهرت لك رسالة تفيد بأن حسابك غير مفعّل، فأكمل التفعيل في Stripe، ثم استخدم زر إعادة التحقق في heyhey.

بعد تفعيل حسابك، يستطيع عملاؤك الدفع بالبطاقة (Visa وMastercard). أما Apple Pay وGoogle Pay فتُدار من إعدادات طرق الدفع في Stripe، لذا تأكد من تفعيلهما هناك. ولا تظهر المحفظة الرقمية في صفحة الدفع إلا إذا كان جهاز المشتري ومتصفحه يدعمانها.

ليست كل طريقة تصلح للدفع لمرة واحدة قابلة للاستخدام في التحصيل المتكرر. في حالة الاشتراك، تحقّق من الطرق التي تظهر فعلًا في صفحة الدفع الخاصة به.

6. جرّب الشراء كأنك مشترٍ

1. افتح منتجًا منشورًا مع تفعيل البيع، وتحقّق من السعر والعملة.
2. انسخ رابط صفحة الدفع وافتحه في نافذة متصفح منفصلة.
3. في الوضع التجريبي، استخدم بيانات البطاقات التجريبية من Stripe. لا تستخدم بطاقة حقيقية في اختبارات الـ Sandbox.
4. أكمل الدفع، ثم عُد إلى heyhey وافتح المبيعات (Sales) ← الطلبات (Orders).
5. تحقّق من تأكيد الشراء ومن الوصول إلى المنتج كما يراه المشتري.
6. قبل مشاركة صفحة الدفع مع عملائك، اربط المفتاح الفعلي وتأكد من اختفاء علامة Sandbox.

صفحة الشكر وحدها لا تغني عن التحقق من الطلب. إذا قبل Stripe الدفعة ولم تظهر بعد في heyhey، فيجب التحقق من إشعارات المعاملة.

المشكلات الشائعة

تغيير الحساب أو المفتاح، والحصول على المساعدة

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

إذا احتجت إلى مساعدة، فأرسل لنا رسالة الخطأ، ووضّح ما إذا كنت في الوضع التجريبي أو الفعلي، مع رقم الطلب. لا ترسل أبدًا مفتاح API أو بيانات البطاقة. تواصل مع فريق دعم heyhey.