كيف تعمل المدفوعات
تدعم TakeTheme تسع طرق دفع: الدفع عند الاستلام، وطرق الدفع اليدوية المخصصة (تحويل بنكي، محفظة، أو أي طريقة تحددها بنفسك)، وسبع بوابات إلكترونية — كاشير (Kashier)، باي موب (Paymob)، باي تابس (PayTabs)، باي بال (PayPal)، سترايب (Stripe)، تابي (Tabby)، وتمارا (Tamara).
كل بوابة تُربط بـحساب التاجر الخاص بك. تصل الأموال إليك مباشرة، ولا تحتفظ بها TakeTheme في أي وقت. تُحفظ بيانات الاعتماد لكل متجر على حدة ولا تُشارك بين المتاجر.
تشرح هذه الصفحة القواعد المشتركة بين جميع الطرق. أما ما يخص كل بوابة تحديدًا فتجده في صفحتها.
مسارا الشراء
يتحدد المسار الذي يمر به المشتري بطريقة الدفع التي يختارها فقط.
المسار اليدوي — الدفع عند الاستلام والطرق اليدوية
- يُتم المشتري عملية الشراء.
- يُنشأ الطلب فورًا بحالة دفع غير مدفوع.
- تُحصّل المبلغ لاحقًا (يسلّم المندوب النقد، أو يحوّل العميل إلى حسابك).
- تُعلّم الطلب كمدفوع من لوحة التحكم.
الطلب موجود منذ اللحظة الأولى، لذلك يظهر في قائمة الطلبات حتى قبل تحصيل أي مبلغ.
المسار الإلكتروني — جميع البوابات
- يُتم المشتري عملية الشراء.
- تُنشئ TakeTheme جلسة دفع لدى البوابة وتحوّل المشتري إليها. لا يوجد طلب بعد.
- يدفع المشتري على صفحة البوابة.
- تستدعي البوابة الويب هوك الخاص بـ TakeTheme. يُنشأ الطلب في هذه اللحظة، ويكون مدفوعًا بالفعل.
- يعود المشتري إلى صفحة نجاح الطلب في متجرك.
يُسمى هذا الإنشاء المؤجل للطلب، وله نتيجة واحدة يجب استيعابها:
إذا وصل المشتري إلى البوابة ولم يُكمل الدفع، فلن يُنشأ أي طلب — ولا يوجد ما يُلغى أو يُنظَّف. تظهر هذه المحاولات ضمن السلات المتروكة، لا ضمن الطلبات.
حالات الدفع
| الحالة | المعنى |
|---|---|
| غير مدفوع | لم يُحصَّل أي مبلغ. الحالة الطبيعية لطلبات الدفع عند الاستلام والطرق اليدوية. |
| مُصرّح به | دفع مُدّعى ولم يُؤكَّد بعد. ينتج فقط عن مسار لقطة إثبات الدفع وينتظر اعتمادك. |
| مدفوع | تم تحصيل المبلغ كاملًا. |
| مدفوع جزئيًا | أُضيفت عناصر إلى طلب مدفوع، فأصبح هناك رصيد مستحق. |
| مسترد جزئيًا | استُرد جزء من المبلغ المحصَّل. |
| مسترد | استُرد كامل المبلغ المحصَّل. |
| مُلغى التصريح | أُلغي التصريح دون تحصيل أي أموال. |
| فاشل | رفضت البوابة عملية الدفع. |
| منتهي الصلاحية | انتهت مهلة جلسة الدفع قبل أن يدفع المشتري. |
حالة الدفع مستقلة عن حالة الطلب وحالة التجهيز وحالة التوصيل — راجع دورة حيا ة الطلب.
التصريح مقابل التحصيل
لا توفّر TakeTheme مسارًا يدويًا للتصريح ثم التحصيل. كل البوابات الإلكترونية مضبوطة على التحصيل التلقائي بمجرد إتمام المشتري للدفع. لا يوجد زر "حصّل الآن"، ولا تصريح معلّق ينتهي دون مطالبة.
الاستثناء الوحيد هو الدفع اليدوي الذي طلبت فيه لقطة إثبات الدفع: يصل بحالة مُصرّح به حتى تعتمده.
الاسترداد
استرداد طلب من لوحة التحكم يُحدّث سجل الدفع، والسجل الزمني للطلب، وتقاريرك، ويعيد المخزون اختياريًا. لكنه لا يعيد الأموال عبر البوابة. لا يُرسَل أي طلب استرداد إلى كاشير أو باي موب أو باي تابس أو باي بال أو سترايب أو تابي أو تمارا.
لإعادة الأموال فعليًا، نفّذ الاسترداد من لوحة تحكم البوابة نفسها، ثم سجّله في TakeTheme حتى تتطابق تقاريرك.
ما تفرضه TakeTheme فعليًا:
- لا يمكن استرداد إلا المدفوعات بحالة مدفوع أو مسترد جزئيًا. أما غير المدفوعة أو الفاشلة أو الملغاة أو المستردة بالكامل فتُرفض.
- لا يمكن أبدًا استرداد مبلغ أكبر مما حُصِّل. يُفحص ذلك لحظة الكتابة، فلو نفّذ موظفان استردادًا في الوقت نفسه فلن يمرّا معًا — تفشل المحاولة الثانية.
- تُرفض المبالغ الصفرية والسالبة، حتى لا يتحول الاسترداد إلى خصم من العميل.
- لا يمكن استرداد العنصر نفسه بالكمية نفسها مرتين.
- استرداد كل المبلغ يجعل الحالة مسترد، واسترداد جزء منه يجعلها مسترد جزئيًا.
يسجّل كل استرداد طريقة الاسترداد. اتركها الأصلية لتسجيله على الطريقة التي دفع بها العميل، أو اختر طريقة أخرى (مثل رد قيمة طلب مدفوع بالبطاقة كرصيد في المتجر أو نقدًا).
لا يُسترد الشحن إلا إذا اخترت ذلك صراحةً، ويُسجَّل منفصلًا عن مبالغ العناصر.
إلغاء التصريح
إلغاء التصريح يحرّر الحجز دون تحصيل أموال، وينطبق فقط على المدفوعات بحالة مُصرّح به — عمليًا الطلبات اليدوية التي تنتظر اعتماد لقطة إثبات الدفع.
يحدث ذلك بإحدى طريقتين:
- أن تُلغي التصريح مباشرة.
- أن تُلغي الطلب. الإلغاء يُلغي التصريح تلقائيًا. وإذا كان الطلب مدفوعًا بالفعل واخترت "استرداد المبلغ المتبقي"، يُسترد الرصيد المحصَّل بدلًا من ذلك. راجع الإلغاء.
لا يمكن إلغاء التصريح أكثر من مرة.
رسوم المناولة وحدود الطلب
يمكن للدفع عند الاستلام والطرق اليدوية المخصصة فرض رسوم وحدود على إجمالي الطلب. ويُطبَّق كلاهما عند إتمام الشراء وقبل إنشاء الطلب — فالمشتري خارج الحدود لا يستطيع إتمام الطلب أصلًا.
| الإعداد | الدفع عند الاستلام | الطريقة اليدوية |
|---|---|---|
| الرسوم | مبلغ ثابت (رسوم مناولة الدفع عند الاستلام) | مبلغ ثابت أو نسبة من الإجمالي |
| الحد الأقصى لإجمالي الطلب | الحد الأقصى لمبلغ الدفع عند الاستلام | الحد الأقصى لمبلغ الطلب |
| الحد الأدنى لإجمالي الطلب | — | الحد الأدنى لمبلغ الطلب |
تُقارن الحدود بمجموع العناصر + الشحن + الضريبة (الإجمالي قبل إضافة رسوم المناولة). اترك الحقل فارغًا لإلغاء الحد.
إذا تجاوز الإجمالي الحد الأقصى يفشل إتمام الشراء بالخطأ ORDER_TOTAL_EXCEEDS_MAX_ALLOWED_AMOUNT، وإذا قلّ عن الحد الأدنى بالخطأ ORDER_TOTAL_IS_BELOW_MIN_ALLOWED_AMOUNT.
أما البوابات الإلكترونية فليست لها إعدادات رسوم أو حدود.
العملة
تُسجَّل الطلبات بـعملة المتجر المحددة في إعدادات المتجر.
بمجرد وجود طلب واحد على الأقل في المتجر، لا يمكن تغيير العملة (CURRENCY_LOCKED_HAS_ORDERS)، وإلا تغيّر معنى الطلبات والتقارير وسجلات الدفع السابقة بصمت. اضبط عملتك بشكل صحيح قبل الإطلاق.
هناك بوابتان لهما معالجة خاصة للعملة:
- باي تابس لها حقل
currencyخاص (EGP أو SAR) إلى جانب المنطقة، ويجب أن يطابق عملة متجرك وإلا رفضت البوابة العملية أو حوّلتها. - سترايب تستقبل المبالغ بأصغر وحدة للعملة (القروش/السنتات) وتقبل البطاقات فقط.
تفعيل أكثر من طريقة
يمكنك تفعيل ما تشاء من الطرق — تظهر جميعها عند إتمام الشراء بشعارها واسمها (مترجمة إلى العربية والفرنسية في واجهة المتجر).
أما الطرق اليدوية المخصصة فغير محدودة العدد: أنشئ طريقة لكل حساب بنكي أو محفظة أو ترتيب خارجي، ولكلٍّ تعليماتها ورسومها وحدودها.
إعدادات موجودة في كل بوابة
| الإعداد | الوظيفة |
|---|---|
| إرسال بريد تأكيد الدفع | يرسل بريدًا للعميل عند تسجيل الدفع. يعمل فعليًا. |
| التنبيه عند فشل الدفع (عناوين بريد) | يرسل بريدًا للعناوين التي تحددها عند فشل عملية دفع لدى البوابة. يعمل فعليًا. |
| تعليم الطلبات كمدفوعة تلقائيًا | غير مُفعَّل حاليًا. أي دفع مؤكَّد يجعل الطلب مدفوعًا سواء كان هذا الخيار مفعّلًا أم لا. |
أما الإعدادات الخاصة بكل بوابة (البيئة، حفظ البطاقات، حدود الدفع عند الاستلام) فموثّقة في صفحة كل بوابة.
عناوين الويب هوك
تؤكد كل بوابة الدفع باستدعاء عنوان لدى TakeTheme. غالبًا لن تحتاج إلى التعامل معها — يكفي ربط البوابة — لكنك ستحتاج إلى العنوان إذا طلبت منك لوحة تحكم المزوّد تسجيله.
| المزوّد | العنوان | التحقق من التوقيع |
|---|---|---|
| كاشير | POST /v1/payment/webhook/kashier | نعم — دائمًا |
| باي موب | POST /v1/payment/webhook/paymob | فقط عند ضبط مفتاح HMAC |
| باي تابس | POST /v1/payment/webhook/paytabs | نعم — دائمًا، ويُرفض الطلب بدونه |
| سترايب | POST /v1/webhooks/stripe | نعم، عند ضبط مفتاح الويب هوك |
| باي بال | POST /v1/webhooks/paypal | نعم، عند ضبط معرّف الويب هوك |
| تابي | — | لا يوجد عنوان (راجع الدفع الآجل) |
| تمارا | — | لا يوجد عنوان (راجع الدفع الآجل) |
استقبال الويب هوك آمن التكرار: تعيد البوابات الإرسال حتى تحصل على استجابة 200، وأي إعادة إرسال لعملية دفع ناجحة مسجّلة مسبقًا تُقبل وتُتجاهل بدل أن تُضاعف الإيرادات أو تُنشئ الطلب مرتين.
كل ويب هوك وارد يُسجَّل، لذا يستطيع الدعم إخبارك ما إذا كان المزوّد قد استدعى فعلًا وماذا أرسل.
حل المشكلات
"حفظت بيانات الاعتماد فتوقفت البوابة عن العمل."
تُعرض الأسرار المحفوظة مقنّعة بالشكل ••••1234. أعد كتابة السر كاملًا عند تغييره ولا تعدّل حوله. أي قيمة تبدأ بنقاط تُعامل على أنها "أبقِ القيمة الحالية"، لذا قد يترك التعديل الجزئي مفتاحًا قديمًا كما هو.
"دفع المشتري ولا يوجد طلب." في البوابات الإلكترونية يُنشئ الويب هوك الطلب. ابدأ بمراجعة إعداد الويب هوك لدى المزوّد، وتواصل مع الدعم ومعك رقم العملية لدى البوابة — سيوضح سجل الويب هوك الوارد ما إذا كان الاستدعاء قد وصل.
"الاسترداد لا يظهر في حساب البوابة." هذا متوقع — راجع الاسترداد. TakeTheme تسجّل الاسترداد، وأنت تنفّذه لدى البوابة.
"رسوم الدفع عند الاستلام لا تُحتسب." تُطبَّق الرسوم عند إتمام الشراء، لذا تؤثر فقط على الطلبات التي تُنشأ بعد حفظ الإعداد. أما الطلبات القائمة فلا تتغير.