ربط HyperPay للدفع بالبطاقة

اربط حسابك أنت في HyperPay ليتمكن عملاؤك من الدفع بالبطاقة عند إتمام الطلب. يشرح هذا المقال المفاتيح التي تحتاجها من HyperPay، وكل حقل في صفحة الدفع بالبطاقة، والتحقق الذي نجريه مع HyperPay عند الحفظ، وكيف توقف الدفع بالبطاقة مؤقتاً أو تحذف مفاتيحك.

الدفع بالبطاقة متاح ابتداءً من خطة النمو. راجع الخطط وما تشمله كل خطة. ربط HyperPay يحتاج صلاحية تعديل الإعدادات، وفتح الصفحة يحتاج عرض الإعدادات. وفي البداية لا يملكهما إلا دور مالك المتجر. راجع أدوار الموظفين.

ما تحتاجه من HyperPay: المفاتيح الفعلية لا مفاتيح التجربة

تحتاج حساب تاجر لدى HyperPay اعتمده HyperPay. بعد الاعتماد يعطيك HyperPay مفاتيح نظامه الفعلي، أي النظام الذي يقبل بطاقات حقيقية:

• معرّف الكيان (Entity ID)؛
• رمز الوصول (Access token)؛
• مفتاح إشعارات الدفع (Webhook secret).

HyperPay هو من يصدر المفاتيح الثلاثة. ومفتاح إشعارات الدفع يصلك عندما تضيف Webhook بعنوان متجرك من لوحة التحكم في HyperPay، أو تطلب من دعم HyperPay إضافته؛ وصفحة الدفع بالبطاقة تعرض لك هذا العنوان. ولا يمكن تفعيل الدفع بالبطاقة بدون هذا المفتاح.

استخدم هذه المفاتيح الفعلية فقط. نتحقق من كل مفتاح مع نظام HyperPay الفعلي، لذلك تُرفض مفاتيح بيئة التجربة دائماً، ولا تستقبل أي دفعة. وهذا ما تقوله الصفحة في سطرها الأول: «أدخل المفاتيح الفعلية التي تحصل عليها من HyperPay بعد اعتماد حسابك؛ مفاتيح التجربة لا تستقبل الدفع.»

إذا كنت ما زلت تنتظر اعتماد حسابك، تابع تجهيز متجرك في الأثناء. ربط HyperPay يؤخر أول نشر فقط، ولا يمنعك من التصميم. راجع HyperPay وأول نشر.

ربط HyperPay

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

تكبير

2. تحت عنوان إشعارات الدفع من HyperPay، انسخ عنوان متجرك. وأضف Webhook بهذا العنوان من لوحة التحكم في HyperPay، أو أرسله إلى دعم HyperPay ليضيفوه. بعدها يعطيك HyperPay مفتاح إشعارات الدفع.
3. في معرّف الكيان (Entity ID) الصق معرّف الكيان من حسابك في HyperPay.
4. في رمز الوصول (Access token) الصق رمز الوصول.
5. في مفتاح إشعارات الدفع الصق مفتاح إشعارات الدفع.
6. اترك قبول الدفع بالبطاقة عند إتمام الطلب مفعّلاً.

تكبير

7. اختر حفظ. نحفظ مفاتيحك ثم نتحقق منها مع HyperPay مباشرة، ويستغرق ذلك لحظات.

تكبير

عندما يقبل HyperPay المفاتيح، تظهر الرسالة «تم حفظ إعدادات الدفع بالبطاقة.» وتتحول الشارة إلى مربوط. صار متجرك قادراً على استقبال الدفع بالبطاقة، بشرط أن يكون خيار الدفع بالبطاقة مفعّلاً أيضاً في تبويب المبيعات في الإعدادات (راجع الشرح أدناه).

يبقى زر حفظ غير متاح إلى أن تعبّئ معرّف الكيان (Entity ID) ورمز الوصول (Access token) معاً. وإلى أن تحفظ أول مرة، تبقى بجانبه العبارة «تحتاج معرّف الكيان ورمز الوصول معاً للربط.» حتى بعد أن يصير الزر متاحاً. وما دام قبول الدفع بالبطاقة عند إتمام الطلب مفعّلاً، ينتظر الزر أيضاً مفتاح إشعارات الدفع، وتقول ذلك العبارة «أضف مفتاح إشعارات الدفع لتفعيل الدفع بالبطاقة.»

الحقول

معرّف الكيان

هو المعرّف الذي حصلت عليه من HyperPay لحسابك، والنص المؤقت في الحقل يبيّن كيف يبدأ عادةً: 8ac7a4c9…. الصقه كما يظهر عند HyperPay تماماً. نحذف المسافات من بدايته ونهايته فقط، ولا نغيّر شيئاً آخر.

بخلاف المفتاحين السريين، يبقى معرّف الكيان ظاهراً لك. وإذا أفرغت حقله وحفظت، لا يعود متجرك مربوطاً.

رمز الوصول: يُحفظ مشفّراً ولا يظهر مرة أخرى

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

بعد الحفظ يكون الحقل فارغاً، وتحته عبارة «المفتاح المحفوظ:» تليها أربع نقاط وأربعة أحرف، مثلاً «المفتاح المحفوظ: ····Qm4x — اتركه فارغاً للإبقاء عليه». الأحرف الأربعة تميّز هذا المفتاح المحفوظ عن غيره، فتعرف منها متى تغيّر. وهي تتغير في كل مرة تحفظ فيها رمز وصول، حتى لو لصقت الرمز نفسه من جديد. وليست آخر أربعة أحرف من الرمز الذي كتبته.

مفتاح إشعارات الدفع

عندما يدفع عميل بالبطاقة، يرسل HyperPay إشعاراً بالدفع إلى عنوان متجرك، مشفّراً بمفتاح إشعارات الدفع. لا يفتحه إلا هذا المفتاح، وهذا ما يثبت أنه صادر من HyperPay، وبه يُسجَّل طلب البطاقة كمدفوع لحظة الدفع.

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

المفتاح 64 حرفاً ورقماً. الصقه كما يعرضه HyperPay تماماً؛ وأي شيء غيره يُرفض بالرسالة «مفتاح إشعارات الدفع هو 64 حرفاً ورقماً يعرضها HyperPay للـ Webhook الخاص بك. انسخه مرة أخرى.»

تكبير

يمكنك حفظ مفاتيحك وقبول الدفع بالبطاقة عند إتمام الطلب غير مفعّل وأنت تنتظر المفتاح. أما لتفعيل الدفع بالبطاقة فيجب أن يكون المفتاح محفوظاً. فما دام الخيار مفعّلاً ولا يوجد مفتاح محفوظ أو مكتوب، يبقى زر حفظ غير متاح، وتشرح السبب العبارة «أضف مفتاح إشعارات الدفع لتفعيل الدفع بالبطاقة.»

تكبير

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

الحفظ: نتحقق من المفاتيح مع HyperPay

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

تُحفظ مفاتيحك مهما كان رد HyperPay. والرد يحدد الرسالة والشارة:

الرسالة تتبع ما هو مسجّل عندنا، لا رد HyperPay هذه المرة وحده. فإذا كان HyperPay قد رفض مفاتيحك من قبل، وحفظت بدون تغيير معرّف الكيان أو رمز الوصول، مثلاً لتفعيل خيار القبول أو لإضافة مفتاح إشعارات الدفع، نسأل HyperPay من جديد. وإذا لم يرد، تظهر لك «تم الحفظ، لكن HyperPay لم يقبل هذه المفاتيح.» مرة أخرى، والرد نفسه في المربع الأحمر. فإذا لم يتغير الرد، قد يكون HyperPay لم يرد أصلاً: انتظر بضع دقائق واختر إعادة التحقق قبل أن تغيّر أي مفتاح.

مع الردّين اللذين يعطيان غير مؤكَّد يظهر زر إعادة التحقق بجانب حفظ. والمقال لم يقبل HyperPay مفاتيحي — ماذا أفعل؟ يشرح كل رفض وما تفعله في كل حالة.

مربوط ومؤكَّد

الشارة في أعلى بطاقة HyperPay تبيّن حالة الربط دائماً:

تكبير

الشارة تخص المفاتيح فقط. فهي تبقى مربوط حتى لو أوقفت الدفع بالبطاقة مؤقتاً، لذلك انظر أيضاً إلى خيار قبول الدفع بالبطاقة عند إتمام الطلب.

استبدال مفتاح واحد: اترك الباقي فارغاً

حقلا رمز الوصول (Access token) ومفتاح إشعارات الدفع يظهران فارغين في كل مرة، حتى لو كانت المفاتيح محفوظة. والفراغ يعني الإبقاء: الحقل السري الفارغ يترك المفتاح المحفوظ كما هو.

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

لا يمكنك مسح مفتاح سري محفوظ بإفراغ حقله. لإزالة مفاتيحك، احذفها.

قبول الدفع بالبطاقة عند إتمام الطلب: إيقاف مؤقت بدون حذف المفاتيح

لإيقاف استقبال البطاقات فترة من الوقت، مثلاً إلى أن تحل مسألة مع HyperPay:

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

وأثناء الإيقاف المؤقت:

• الدفعات التي تمت تُؤكَّد كالمعتاد. إشعار HyperPay بطلب بطاقة دُفع قبل الإيقاف بقليل يُقبل، ويتقدم الطلب كالمعتاد.
• رد مبالغ دفعات البطاقة يعمل. رد مبلغ طلب سابق بالبطاقة يستخدم المفاتيح نفسها، والإيقاف المؤقت يبقيها محفوظة.
• لا يمكنك الإيقاف والدفع عند الاستلام غير مفعّل. سيصبح الدفع بالبطاقة الطريقة الوحيدة للدفع في متجرك، فيُرفض الحفظ بالرسالة «الدفع بالبطاقة هو طريقة الدفع الوحيدة في هذا المتجر. فعّل الدفع عند الاستلام من الإعدادات أولاً.»
• قبل أول نشر تظهر مهمة «اربط HyperPay» في قائمة «جهّز متجرك» بحالة غير مفعّل، ويبقى النشر منتظراً.

خيار الدفع بالبطاقة في تبويب المبيعات

هناك خيار ثانٍ للبطاقات: مربع الدفع بالبطاقة تحت طرق الدفع في تبويب المبيعات في الإعدادات. هذا هو قرار متجرك العام بطرق الدفع التي تظهر عند إتمام الطلب. ولا يظهر خيار البطاقة لعملائك إلا عندما:

• يكون الدفع بالبطاقة مفعّلاً في تبويب المبيعات؛
• تكون مفاتيحك محفوظة في صفحة الدفع بالبطاقة، ويكون HyperPay قد أكّدها (الشارة مربوط)؛
• يكون مفتاح إشعارات الدفع محفوظاً؛
• يكون قبول الدفع بالبطاقة عند إتمام الطلب مفعّلاً فيها؛
• تشمل خطتك الدفع بالبطاقة.

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

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

لتقبل البطاقات فقط، أزل التحديد عن الدفع عند الاستلام في تبويب المبيعات. يصبح الدفع بالبطاقة حينها الطريقة الوحيدة للدفع في متجرك، فيجب أن يعمل أولاً: إلى أن يكون HyperPay مربوطاً ومؤكَّداً، ومعه مفتاح إشعارات الدفع، ومفعّلاً في هذه الصفحة، يعرض التبويب «لا يمكن إيقاف الدفع عند الاستلام إلا بعد ربط الدفع بالبطاقة وتأكيده من HyperPay وتفعيله من صفحة الدفع بالبطاقة.» ولا يحفظ. راجع ضبط الضرائب وطرق الدفع وإتمام الطلب كزائر.

HyperPay وأول نشر

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

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

تكبير

في المتجر المنشور، كما في الصورة، تظهر المهمة في بطاقة الخطوة الأخيرة تحت السطر «أكمل هذه الخطوات لإنهاء إعداد متجرك.» أما قبل أول نشر، وما دامت هناك خطوات أخرى مفتوحة، فتنتظر تحت بعد ذلك ومعها وسم مطلوب للنشر والسطر الرمادي نفسه.

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

تكبير

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

حذف مفاتيح HyperPay

الحذف يزيل معرّف الكيان ورمز الوصول ومفتاح إشعارات الدفع المحفوظة. استخدمه عندما تترك HyperPay أو تسلّم المتجر لغيرك؛ أما لإيقاف البطاقات فترة، فأوقفها مؤقتاً بدلاً من ذلك.

يُرفض الحذف ما دام طلب بالبطاقة بانتظار الدفع، بالرسالة «ما زال طلب بالبطاقة بانتظار الدفع. أوقف الدفع بالبطاقة مؤقتاً بدلاً من ذلك، واحذف المفاتيح بعد دفعه أو إلغائه.»، لأن هذه المفاتيح هي ما يؤكد دفعه. ويُرفض أيضاً ما دام الدفع عند الاستلام غير مفعّل في تبويب المبيعات، بالرسالة «الدفع بالبطاقة هو طريقة الدفع الوحيدة في هذا المتجر. فعّل الدفع عند الاستلام من الإعدادات أولاً.» فعّل الدفع عند الاستلام من جديد، ثم احذف المفاتيح.

تكبير

تكبير

تظهر الرسالة «تم حذف مفاتيح HyperPay.» وترجع الصفحة إلى غير مربوط بحقول فارغة.

تكبير

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

في الخطط التي لا تشمل الدفع بالبطاقة

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

تكبير

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

كيف يصل المال من عميلك إلى حسابك البنكي مشروح في كيف يدفع لك عملاؤك، ورد مبالغ الدفع بالبطاقة، الذي يمر عبر HyperPay، مشروح في ردّ مبلغ الطلب كاملاً أو جزئياً.

الخطوة التالية: اختر طرق الدفع التي تظهر عند إتمام الطلب، أو انشر واجهة متجرك.