تميز تجاري
ePay User Guide
TAMAYYUZ ePay is a payment gateway that allows you to accept online payments with CIB and EDAHABIA cards in Algeria. Whether you're a business owner or a developer, this guide will help you get started with integrating and using TAMAYYUZ ePay seamlessly.
كيفية البدء
-
إنشاء حساب
لبدء استخدام TAMAYYUZ ePay، الخطوة الأولى هي إنشاء حساب. انتقل إلى صفحة التسجيل، وأدخل معلوماتك، ثم فعّل حسابك كما هو مطلوب في المنصة.
بمجرد إعداد حسابك، سيكون لديك خيار إنشاء تطبيقات متعددة داخل الحساب نفسه.
-
إنشاء تطبيق أو تحديث التطبيق الحالي
يمثل التطبيق مشروعًا أو موقعًا إلكترونيًا أو كيانًا تجاريًا فريدًا. كل تطبيق هو بيئة مستقلة تسمح لك بإدارة تكامل الدفع بشكل مستقل. عند إنشاء تطبيق، ستحصل على مفتاح واجهة برمجة تطبيقات (API) فريد ومفتاح سري، يُستخدمان لمصادقة المعاملات وتأمينها لذلك التطبيق المحدد.
تخيل التطبيق كحاوية لإعدادات الدفع وسجل المعاملات. هذا يعني أن لكل تطبيق سجلات معاملات منفصلة خاصة به، مما يضمن نسب المدفوعات والطلبات بوضوح إلى المشروع أو الموقع الإلكتروني الصحيح. بالإضافة إلى ذلك، فإن استخدام تطبيقات منفصلة لمشاريع مختلفة يساعد على منع التعارضات بين أرقام الطلبات، حيث يحتفظ كل موقع إلكتروني بنظام ترقيم خاص به. تتيح لك هذه المرونة تنظيم عمليات دمج المدفوعات بكفاءة وتوسيع نطاق أعمالك بسهولة.
عند إعداد حسابك لأول مرة، يتم إنشاء تطبيق افتراضي باسم "تطبيقي الجديد" تلقائيًا. يمكنك تعديل هذا التطبيق أو إنشاء تطبيقات جديدة حسب الحاجة لإدارة مشاريع أو مواقع إلكترونية متعددة.
2.1. انقر على اسم التطبيق الحالي في الشريط الجانبي الأيسر.
2.2. انقر على زر "تطبيق جديد".
-
تفعيل الدفع الإلكتروني
3.1. أضف معلومات حسابك المصرفي. سيتم استخدام هذا الحساب لتلقي مدفوعاتك و/أو مدفوعاتك المباشرة.
3.2. انقر على زر "تفعيل الدفع الإلكتروني" وأدخل المعلومات المطلوبة. انتظر حتى يقوم أحد أعضاء فريقنا بمراجعة طلب التفعيل والموافقة عليه.
إذا لم يكن لديك سجل التجاري، يُرجى إدخال "غير متوفر" في الحقول المناسبة. في هذه الحالة، يُرجى التأكد من صحة معلومات ملفك الشخصي، وتحميل إثبات هويتك (بطاقة الهوية).
3.3. عد تفعيل الدفع الإلكتروني، يمكنك البدء في قبول المدفوعات. لهذا، ستحصل على مفتاح واجهة برمجة التطبيقات (API) والمفتاح السري.
3.4. سجّل رابط webhook.
لتسجيل رابط webhook، انتقل إلى تطبيقك، وانقر على "تعديل التطبيق"، ثم عدّل رابط webhook واحفظه.
ملاحظة:
- يمكنك تعديل تطبيق موجود. يمكنك الوصول إليه بالنقر على اسم التطبيق وتعديل المعلومات المطلوبة. يُرجى العلم أنه بعد تفعيل الدفع الإلكتروني، لن تتمكن من تعديل بعض الحقول فيه.
هام:
-
لمعالجة المدفوعات، يجب عليك تفعيل حساب المستخدم وطلب تفعيل الدفع الإلكتروني.
-
احرص على عدم مشاركة مفاتيحك مطلقًا في الأماكن العامة مثل GitHub أو أي رمز من جانب العميل.
-
استخدام خاصية الدفع الإلكتروني
باستخدام مفتاح واجهة برمجة التطبيقات (API) والمفتاح السري، يمكنك تهيئة موقعك الإلكتروني لبدء قبول المدفوعات الإلكترونية.
يعتمد التهيئة على نوع الموقع الإلكتروني. على سبيل المثال، لمواقع ووردبريس، ما عليك سوى تثبيت إضافة ووردبريس الخاصة بنا وإضافة مفاتيح إعداداتها كما هو موضح أدناه.
لجميع أنواع مواقع الويب (اللغات والأطر)، يُرجى مراجعة هذه الوثائق لمعرفة خطوات التكامل - دليل المطور.
المعاملات والسحوبات
بما أن المشترين يدفعون ثمن البضائع التي تبيعها على مواقعك الإلكترونية، تتم المعاملات عبر بوابة الدفع الإلكتروني لدينا.
إليك كيفية ارتباط هذه المعاملات بالفواتير والسحوبات.
-
المعاملات
تحدث المعاملة عندما يُكمل المشتري عملية دفع مقابل عملية شراء على موقعك الإلكتروني. يمكن أن يشمل ذلك شراء سلع مادية أو منتجات رقمية أو خدمات.
يمكن أن تكون المعاملات ناجحة (معتمدة) أو غير ناجحة (مرفوضة). تؤدي المعاملات الناجحة إلى إيداع أموال في حسابك، ويمكنك طلب تحويلها إلى حسابك المصرفي عبر طلب سحب.
على سبيل المثال، في حالة إتمام عملية دفع ناجحة بقيمة 4000 دينار جزائري، سيكون رصيد حسابك المتاح للسحب 3940 دينار جزائري، مع احتساب رسوم قدرها 1.5%.
-
الفواتير
تشير الفواتير إلى المبلغ الذي تدفعه لنا. سيظهر لك المبلغ المستحق الدفع على شاشة الفواتير.
ذا المبلغ هو إجمالي الرسوم المحتملة أدناه:
- رسوم عمليات السحب الناجحة - راجع صفحة الأسعار لمزيد من التفاصيل.
- المبالغ النهائية المستردة للعميل (في حالة التاجر الوسيط والتاجر غير المباشر)*
- رسوم المعاملات الناجحة في حال تم الدفع مباشرةً إلى حساب العميل المصرفي (في حالة التاجر المباشر)*
يرجى مراجعة أنواع التجار في قسم "الرسوم" أدناه
-
عمليات السحب
السحب هو عملية تحويل الأموال من حساب التاجر إلى حسابك المصرفي. بهذه الطريقة تستلم الأموال من المعاملات الناجحة.
بعد تسوية المعاملات، يمكنك بدء عملية سحب لتحويل الأموال إلى حسابك المصرفي. عادةً ما تخضع عمليات السحب لفترات معالجة وتختلف الرسوم باختلاف نوع التاجر.
-
الرسوم
نُعرّف أنواع التجار التالية:
- Direct Merchant: تاجر أبرم عقد تاجر إلكتروني مع مصرفه، ويقبل المدفوعات الإلكترونية، ويتفق معنا على استلام الدفعة النهائية للمستهلك مباشرةً في حسابه المصرفي.
- Intermediary Merchant: تاجر أبرم عقد تاجر إلكتروني مع مصرفه ولكنه لا يستلم الدفعة النهائية للمستهلك مباشرةً. تقوم منصة الدفع الإلكتروني لدينا بتحصيل الدفعة وتحويلها إلكترونيًا إلى التاجر.
- Indirect Merchant: تاجر لم يُبرم عقد تاجر إلكتروني مع مصرفه. تقوم منصة الدفع الإلكتروني لدينا بتحصيل الدفعة النهائية للمستهلك وتحويلها إلى التاجر.
يتم إنشاء عميل جديد كتاجر غير مباشر افتراضيًا. بناءً على طلب المستخدمين، قد نوافق على تحويل هذا المستخدم من التاجر غير المباشر إلى أنواع أخرى.
لمزيد من المعلومات حول أسعارنا والخطط المتاحة، يُرجى زيارة صفحة الأسعار.
كيفية دمج خدمة الدفع الإلكتروني TAMAYYUZ في موقعك الإلكتروني/تطبيقك
-
WooCommerce Plugin
أولاً، قم بتنزيل WooCommerce Plugin الذي نرسله إليك بعد التسجيل.
بعد ذلك، شاهد الفيديو التعليمي للاطلاع على تعليمات التثبيت والتكوين. سيكون الفيديو متاحًا قريبًا.
-
لغات ومنصات أخرى
يُرجى زيارة دليل المطور لخدمة الدفع الإلكتروني TAMAYYUZ للحصول على وصف مفصل لكيفية دمج المدفوعات الإلكترونية في موقعك الإلكتروني أو تطبيقك.