كيف تربط PayPal بـ heyhey

يمكنك ربط PayPal بـ heyhey لاستلام المدفوعات في حسابك الخاص على PayPal. يتطلب الربط بيانات اعتماد من تطبيق في PayPal: Client ID وSecret. لن تُدخل كلمة مرور PayPal في heyhey، ولن تحتاج إلى تثبيت أي إضافة.

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

1. جهّز حسابك على PayPal

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

افتح علامتَي تبويب:

PayPal Developer، وفيها ستنشئ التطبيق وتنسخ بياناته؛
المبيعات (Sales) ← المدفوعات (Payments) في لوحة تحكم heyhey، وفيها ستحفظ الربط.

«التطبيق» في لوحة PayPal مجرد اسم لمجموعة إعدادات الوصول الخاصة بـ heyhey. ولا يعني ذلك أن عليك بناء تطبيق للجوال أو برمجة الربط بنفسك.

2. أنشئ تطبيقًا واختر البيئة

سجّل الدخول إلى PayPal Developer بالحساب المرتبط بمبيعاتك.
افتح Apps & Credentials.
اختر Live إذا كنت تجهّز للبيع الفعلي، أو Sandbox إذا كنت تُجري تجربة.
انقر على Create App وسمِّ التطبيق heyhey. إذا سألك النموذج عن النوع، فاختر تطبيق التاجر (Merchant) لمبيعاتك الخاصة.
افتح التطبيق الذي أنشأته وابحث عن Client ID وSecret (قد يظهر باسم Client secret). قد تحتاج إلى النقر على زر لإظهار الـ Secret.

يشرح دليل PayPal لإنشاء بيانات اعتماد REST API الفصل بين Live وSandbox. فبيانات الاعتماد من إحدى البيئتين لا تعمل في الأخرى.

3. انسخ البيانات إلى الحقول الصحيحة في heyhey

في صفحة المدفوعات في heyhey، ابحث عن بطاقة PayPal.

الحقل في heyhey	ما الذي تلصقه	ما لا تُدخله هنا
Client ID	معرّف تطبيق PayPal الذي أنشأته	عنوان بريدك الإلكتروني أو معرّف التاجر
Secret	الـ Secret الخاص بالتطبيق نفسه	كلمة مرور حسابك أو بيانات تطبيق آخر
Sandbox / test mode	فعّله فقط مع بيانات Sandbox	لا تفعّله مع بيانات Live

انسخ الـ Client ID كاملًا والصقه في الحقل الأول.
انسخ الـ Secret من التطبيق نفسه والصقه في الحقل الثاني.
تحقّق من خيار Sandbox.
انقر على زر ربط PayPal.
انتظر ظهور الرسالة والحالة على بطاقة مزوّد الدفع.

الخطأ الأكثر شيوعًا هو الجمع بين Client ID من تطبيق وSecret من تطبيق آخر. لتجنّب ذلك، انسخ الحقلين معًا وتفاصيل التطبيق نفسه مفتوحة أمامك.

4. تحقّق أيضًا من الإشعارات والاشتراكات

تتحقق heyhey من بيانات التطبيق وتحاول تسجيل Webhook. والـ Webhook رسالة تلقائية يرسلها PayPal إلى heyhey عند حدوث تغيير في دفعة أو اشتراك. وبفضلها يمكن تحديث حالة الطلب حتى لو أغلق المشتري المتصفح.

قد ترى على البطاقة إحدى نتيجتين:

متصل والاشتراكات مفعّلة: الربط والإشعارات المطلوبة جاهزة.
المدفوعات لمرة واحدة تعمل، والاشتراكات غير جاهزة: لم يقبل PayPal تسجيل الـ Webhook بعد. استخدم زر إعادة المحاولة الظاهر على البطاقة. وإذا تكررت المشكلة، فتحقّق من أن التطبيق يملك صلاحية الوصول إلى الميزات المطلوبة، وتواصل مع فريق دعم heyhey.

لا تُنشئ عدة Webhooks متطابقة بطريقة التجربة والخطأ، فـ heyhey تسجّل نقطة الاستقبال الخاصة بها تلقائيًا. وعند حل المشكلة، المهم هو نتيجة هذا التسجيل، لا مجرد ظهور شعار PayPal في صفحة الدفع.

5. اختبر دفعة لمرة واحدة

افتح منتجك، وحدّد السعر، وفعّل البيع. استخدم منتجًا يسهل عليك التحقق من الوصول إليه، مثل كتاب إلكتروني.
افتح رابط صفحة الدفع خارج جلسة التحرير، واختر PayPal.
أكمل التجربة بحساب مشترٍ يناسب البيئة. في Sandbox تستخدم حساب مشترٍ تجريبيًا منفصلًا عن حساب التاجر التجريبي.
عُد إلى المبيعات (Sales) ← الطلبات (Orders) في heyhey وابحث عن عملية الشراء بعنوان البريد الإلكتروني.
قارن حالة الطلب بالمعاملة في PayPal، ثم تحقّق من رسالة الشراء ومن الوصول إلى المحتوى.

يشرح PayPal إعداد التطبيق والحسابات التجريبية في دليل البدء. وقبل بدء البيع، اربط بيانات Live، وأوقف Sandbox، ثم تحقّق من الحالة مرة أخرى.

6. إذا كنت تبيع اشتراكًا

اختر منتجًا بسعر متكرر، واختبر عملية الشراء كاملة بشكل منفصل عن الدفعة لمرة واحدة. يجب أن تُظهر بطاقة PayPal أن الاشتراكات جاهزة. وبعد اعتماد الشراء، تحقّق من أن heyhey أنشأت اشتراك العميل ومنحته الوصول.

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

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

المشكلة	الخطوة التالية
البيانات لا تجتاز التحقق	انسخ Client ID وSecret من جديد من تطبيق واحد، وتحقّق من Live/Sandbox
الربط يعمل في التجربة ولا يعمل في البيع الفعلي	اربط بيانات تطبيق Live وتأكد من أن الحساب جاهز لاستلام المدفوعات
الاشتراكات غير جاهزة	أعد محاولة تسجيل الـ Webhook من بطاقة PayPal في heyhey
عاد المشتري إلى صفحتك لكن الشراء غير مدفوع	قارن معاملة PayPal بحالة الطلب، فالعودة إلى الصفحة لا تؤكد الدفع
الدفعة موجودة في PayPal لكن المحتوى غير متاح	تحقّق من الإشعارات والطلب والمنتج المرتبط، ثم أرسل أرقام السجلات إلى فريق الدعم
لا يظهر PayPal لمنتج معيّن	تحقّق من إعدادات البيع، والعملة (يدعم PayPal عملات محددة فقط)، وحالة الربط في حساب heyhey هذا

التحويلات والرسوم وفصل الربط

تدير أموالك وتحويلاتك من PayPal. تخضع رسوم PayPal لشروط حسابك، وربط heyhey لا يغيّر هذا الاتفاق.

لا تفصل تطبيقًا لديه اشتراكات نشطة لمجرد تغيير اسمه أو مراجعة إعداداته، فإزالة الوصول قد تعطّل عمليات الدفع المتكررة. وإذا أردت تغيير التطبيق أو الحساب، فمن الأفضل الاتفاق على ذلك مسبقًا مع فريق دعم heyhey. ولا تُرسل أبدًا الـ Secret أو كلمة مرور PayPal في رسالتك.