تاب (Tap)
Tap Payments صفحة دفع مست ضافة تُستخدم في الكويت والسعودية والإمارات والبحرين وقطر وعُمان والأردن ومصر. يدفع المشترون على صفحة تاب — بطاقات وكي نت ومدى وبنفت وأبل باي وغيرها من الطرق المفعّلة على حسابك في تاب — ثم يعودون إلى متجرك. الطرق التي تظهر يحددها حسابك في تاب وليس TakeTheme.
الربط
الإعدادات ← المدفوعات ← تاب.
| بيان الاعتماد | مطلوب | أين تجده |
|---|---|---|
| مفتاح API السري | نعم | لوحة تاب ← goSell ← بيانات اعتماد API. يبدأ بـ sk_test_ أو sk_live_ |
المفتاح نفسه يحدد الوضع: المفتاح sk_test_… يُنشئ عمليات اختبار والمفتاح sk_live_… يستقبل أموالاً حقيقية. لا يوجد شيء آخر للتبديل. استخدم المفتاح السري — يُرفض المفتاح العام (pk_…) عند الحفظ.
تُنشأ الطلبات عند عودة المشتري من تاب: تستعلم TakeTheme عن عملية الدفع لدى تاب أثناء العودة، لذا لا يلزم تسجيل أي شيء في المسار المعتاد. كما تطلب TakeTheme من تاب إرسال Webhook لكل عملية دفع تلقائياً، فيُنشأ الطلب إذا دفع المشتري ثم أغلق الصفحة. هذه الإشعارات موقّعة بالمفتاح السري نفسه، لذا لا يوجد مفتاح webhook منفصل تلصقه.
الإعدادات
| الإعداد | الافتراضي | وظيفته |
|---|---|---|
| اسم الدفع في صفحة الدفع | فارغ | الاسم الذي يراه العميل (مثل "بطاقة أو كي نت أو أبل باي"). إن تُرك فارغاً يظهر "Tap" |
| رسوم المعاملة | لا يوجد | رسوم ثابتة أو نسبية تُضاف إلى الطلب عند اختيار هذه الطريقة |
| خصم الدفع | لا يوجد | خصم يُطبَّق عند اختيار المشتري لهذه الطريقة |
| إرسال بريد تأكيد الدفع | مفعّل | يرسل بريداً للعميل عند نجاح الدفع |
| إشعار عند فشل الدفع (بريد) | فارغ | ينبّه فريقك عند فشل عملية دفع |
توقف TakeTheme رسائل الإيصال (بريد وSMS) الخاصة بتاب، فيصل المشتري تأكيد واحد وليس اثنين.
العملة
تُنشئ TakeTheme عملية الدفع بـعملة متجرك. العملات المقبولة تعتمد على حسابك في تاب؛ وإذا كانت عملة متجرك غير مقبولة في حسابك يعرض الدفع رسالة الخطأ من تاب بدلاً من رابط الدفع.
إذا أبلغت تاب عن مبلغ محصَّل يختلف عن إجمالي الطلب، تسجّل TakeTheme الفرق للمطابقة دون رفض الدفع.
مسار الدفع
- يختار المشتري تاب ويُرسل الطلب.
- تُنشئ TakeTheme عملية دفع في تاب (بمرجع داخلي) وتوجّه المشتري إلى صفحتها المستضافة.
- يدفع المشتري بأي طريقة يوفرها حسابك، بما فيها 3-D Secure.
- تعيد تاب المشتري إلى TakeTheme (
GET /v1/payment/tap/return/<reference>). تسترجع TakeTheme تلك العملية من تاب بمفتاحك السري — باستخدام معرّف العملية الذي خزّنته عند إنشائها وليس معرّفاً قادماً من المتصفح — وفقط إذا أفادت تاب بأنها CAPTURED تُنشئ الطلب مدفوعاً. - يصل المشتري إلى صفحة الشكر في متجرك.
ترسل تاب أيضاً Webhook:
POST https://<your-api-host>/api/v1/payment/webhook/tap
يحمل كل إشعار ترويسة hashstring — توقيع HMAC-SHA256 لحقول العملية الأساسية بمفتاحك السري. يُرفض الإشعار بلا توقيع أو بتوقيع غير مطابق بالرمز 403. وحتى الإشعار الصحيح لا يحدد النتيجة بمفرده: هو فقط يعرّف عملية الدفع، وتُعاد قراءة الحالة من تاب. أيهما وصل أولاً (العودة أو الـ Webhook) ينشئ الطلب — ولا يُنشئان طلبين.
المدفوعات الفاشلة والمتروكة
العملية المرفوضة أو الفاشلة أو الملغاة أو المتروكة تعيد المشتري إلى فشل الدفع ليحاول مجدداً؛ ولا يُنشأ طلب. أما العملية التي ما زالت INITIATED أو التي تفيد تاب بأنها انتهت مهلتها أو غير معروفة فتُعامَل على أنها لم تُحسم بعد — يواصل المتجر التحقق بدلاً من إخبار المشتري بأنها فشلت.
الاسترداد
عمليات الاسترداد تُسجَّل في TakeTheme فقط — لا يصل أي طلب استرداد إلى تاب. نفّذ الاسترداد من لوحة تاب ثم سجّله هنا. راجع الاسترداد.
استكشاف الأخطاء
يفشل الحفظ برسالة "must be a Tap Secret API key".
لصقت المفتاح العام (pk_…) أو مفتاحاً به أحرف زائدة. انسخ المفتاح السري (sk_test_… أو sk_live_…) من goSell ← بيانات اعتماد API.
يقول الدفع إن تاب رفضت مفتاح API السري. المفتاح مُلغى أو يخص الوضع الآخر. أنشئ مفتاحاً جديداً من لوحة تاب والصقه مجدداً (القيم المقنّعة تُتجاهل عند الحفظ).
دفع المشتري لكن لم يظهر طلب.
افتح سجل الدفع للطلب: إذا تعذّر الوصول إلى تاب أثناء استرجاع العملية، يواصل المتجر المحاولة ويظهر الطلب بمجرد النجاح. ظهور 403 في سجل الـ Webhook يعني أن توقيع الإشعار لا يطابق مفتاحك المخزَّن — أعد حفظ المفتاح.
طريقة دفع غير ظاهرة في صفحة تاب. تُفعَّل الطرق لكل حساب لدى تاب؛ ولا ترسل TakeTheme أي تصفية للطرق.