بوابة العملاء هي منطقة آمنة مُستضافة حيث يمكن لعملائك إدارة الاشتراكات، وعرض الفواتير، والوصول إلى تفاصيل مفاتيح الترخيص—دون الحاجة للتواصل مع الدعم.
Create Portal Session (API)
أنشئ برمجيًا جلسات بوابة آمنة ومحددة زمنياً.
Subscriptions
إدارة الخطط المتكررة، والترقيات، والتخفيضات، والإضافات.
ما هي بوابة العملاء؟
توفر البوابة تجربة خدمة ذاتية موثوقة ومميزة للعملاء لـ:- الوصول إلى سجل الفوترة: عرض الفواتير وتنزيل الإيصالات.
- إدارة الاشتراكات: عرض تفاصيل الاشتراك، وإيقاف الاشتراكات مؤقتًا واستئنافها، وإلغاء الاشتراكات فورًا أو في تاريخ الفوترة التالي.
- تحديث طرق الدفع: تغيير طرق الدفع للاشتراكات النشطة أو إعادة تفعيل الاشتراكات المعلّقة.
- استرداد مفاتيح الترخيص: الوصول إلى جميع المفاتيح المرتبطة بعمليات الشراء.
- التنقل بسهولة: استخدام زر الرجوع للتنقل بين أقسام البوابة دون فقدان السياق.
الفوائد الرئيسية
- خفض حجم الدعم: يحل العملاء طلبات الفوترة الشائعة بأنفسهم
- الوصول السريع للقيمة: وصول فوري للفواتير والمفاتيح
- تقليل خطر الإلغاء: رؤية واضحة لتجديدات وتفاصيل الخطط
- آمن بتصميمه: الوصول المرمز برموز وروابط منتهية الصلاحية
- تجربة محلية: البوابة متوفرة بـ 21 لغة، مع الكشف التلقائي وفقًا لتفضيلات متصفح العميل
طرق الوصول
يمكن للعملاء الوصول إلى البوابة باستخدام رابط ثابت أو رابط ديناميكي لمرة واحدة.رابط ثابت (الوصول عبر البريد الإلكتروني)
يمكن للعملاء طلب الوصول إلى البوابة عن طريق إدخال بريدهم الإلكتروني في رابط ثابت لا ينتهي صلاحيته. يختلف تنسيق رابط البوابة الثابت حسب البيئة: وضع الاختبار (للاختبار والتطوير):{business_id} بمعرّف عملك الفعلي، ثم شارك الرابط المناسب مع العملاء حتى يتمكنوا من إدخال بريدهم الإلكتروني والحصول على وصول آمن إلى البوابة.
1
Merchant flow
- انتقل إلى المبيعات → العملاء.
- انقر على مشاركة الدعوة.
- انسخ الرابط الثابت وشاركه مع عميلك.
2
Customer flow
- افتح الرابط الثابت.
- أدخل البريد الإلكتروني المستخدم أثناء الشراء.
- استلم رابط تسجيل دخول آمن للوصول إلى البوابة.
يتم التعرف على العملاء الحاليين تلقائيًا.
رابط ديناميكي (رابط سحري)
رابط سحري شخصي لمرة واحدة يرسل العملاء مباشرة إلى البوابة. ينتهي الرابط بعد 24 ساعة.
1
Merchant flow
- انتقل إلى المبيعات → العملاء.
- انقر على مشاركة الدعوة.
- انسخ الرابط الديناميكي وشاركه مع عميلك.
2
Customer flow
- افتح الرابط الديناميكي.
- ادخل مباشرة إلى بوابة العملاء دون إدخال بريد إلكتروني.
ميزات البوابة
يوفر بوابة العملاء المُجددة واجهة نظيفة وموحدة مع شريط جانبي يسار وأقسام منظمة لجميع احتياجات إدارة الحساب.Active Subscriptions
عرض جميع الاشتراكات النشطة مع اسم الخطة والسعر وتاريخ التجديد وفترة الصلاحية. انقر على “إدارة الاشتراك” لعرض التفاصيل أو تعديل معلومات الفوترة أو إيقاف الاشتراك مؤقتًا أو إلغائه.
Payment Methods
عرض جميع طرق الدفع المحفوظة (البطاقات، UPI، إلخ) في لمحة. حرّر طرق الدفع مباشرة من تفاصيل الاشتراك.
Billing History
عرض جميع المعاملات في جدول مفصل يحتوي على التاريخ، الحالة، نوع التسعير، الصلاحيات، والفواتير القابلة للتنزيل.
Billing Information
عرض وتحرير الاسم، البريد الإلكتروني، رقم الهاتف، وعنوان الفوترة من صفحة تفاصيل الاشتراك.
نظرة عامة على البوابة
تعرض الصفحة الرئيسية للبوابة جميع الاشتراكات النشطة، وطرق الدفع المحفوظة، وتاريخ الفوترة في عرض قابل للتمرير الواحد.طرق الدفع وتاريخ الفوترة
قم بالتمرير لأسفل لعرض طرق الدفع المحفوظة وتاريخ الفوترة الكامل مع مؤشرات الحالة والفواتير القابلة للتنزيل.
دعم اللغة
بوابة العملاء متوفرة بـ 21 لغة، لذا يمكن لعملائك إدارة اشتراكاتهم وطرق الدفع وسجل الفواتير باللغة التي يفضلونها.كيف تعمل اختيار اللغة
- الكشف التلقائي: عند الزيارة الأولى، يكتشف البوابة لغة العميل المفضلة من إعدادات المتصفح ويحمّل الترجمة المطابقة إذا كانت متوفرة. اللغة الإنجليزية تُستخدم كخيار افتراضي.
- التعديل اليدوي: يمكن للعملاء تغيير اللغة النشطة في أي وقت من خلال محدد اللغة في رأس البوابة (متاح على كلّ من سطح المكتب والهاتف المحمول).
- حفظ التفضيلات: يتم حفظ اللغة المختارة في الكوكي
NEXT_LOCALE(صالحة لمدة عام واحد) حتى يتذكر البوابة الخيار عبر الجلسات.
اللغات المدعومة
تغييرات الخطة (ترقية/تخفيض)
عندما يتم تنظيم المنتجات في مجموعات منتج، يمكن للعميل الترقية أو التخفيض بين الخطط مباشرة من بوابة العملاء.الإجراءات المتاحة
كيفية عمل تغييرات الخطة
- ينقر العميل على Change Plan في صفحة تفاصيل الاشتراك.
- تظهر خيارات الترقية/الرجوع المتاحة بناءً على مجموعة المنتجات.
- يختار العميل الخطة الجديدة. تعرض لوحة Confirm Plan Change الخطة الحالية مقابل الخطة المحدّثة، وتفصيلًا للعناصر (رصيد للخطة القديمة، ورسوم للخطة الجديدة)، والضريبة، والمبلغ المستحق الآن. ويمكن للعملاء أيضًا إضافة رمز خصم هنا.
- يؤكد العميل باستخدام Pay ${amount}.
- يتم حساب التوزيع النسبي ومعالجة الرسوم — إما باستخدام طريقة الدفع المحفوظة، أو عبر صفحة دفع مستضافة إذا كان النشاط التجاري يجمع مدفوعات تغيير الخطة من خلال رابط دفع (انظر أدناه).
- يتم تحديث الاشتراك إلى الخطة الجديدة. ويعتمد حدوث ذلك فورًا أو بعد نجاح تحصيل الرسوم فقط على معالجة فشل الدفع؛ أما تغيير الخطة المدفوع عبر رابط دفع فينتظر دائمًا إتمام الدفع.
لا تتوفر تغييرات الخطة إلا بين المنتجات الموجودة ضمن المجموعة نفسها. ويجب أن تكون المنتجات من أنواع الفوترة القائمة على الاشتراك أو الاستخدام.
تحصيل مدفوعات تغيير الخطة عبر رابط دفع
بشكل افتراضي، يتم تحصيل رسوم تغيير الخطة الفوري مباشرةً من طريقة الدفع المحفوظة لدى العميل. يؤدي تفعيل Collect Plan Change Payments by Payment Link إلى تغيير ذلك: فبدلًا من تحصيل الرسوم من البطاقة المحفوظة، يُرسَل العميل إلى صفحة Dodo Checkout لإجراء الدفع. ينطبق ذلك على كل من الترقيات والرجوع إلى خطة أدنى اللذين ينتج عنهما تحصيل رسوم.
يبقى الاشتراك على الخطة الحالية حتى ينجح دفع عملية Checkout — ويؤدي الدفع الفاشل أو المتروك إلى إبقاء الاشتراك دون تغيير، بحيث يمكن للعميل إعادة المحاولة في جلسة Checkout نفسها. ولا تتأثر عمليات الرجوع المجدولة (
effective_at: next_billing_date)، وتستمر في التطبيق في تاريخ الفوترة التالي دون المرور عبر Checkout.Plan Change via Payment Link (API)
كيفية طلب رابط دفع باستخدام
collect_via_payment_link ومعالجة الاستجابة.عناصر تحكم النشاط التجاري
يمكن للأنشطة التجارية إعداد سلوك اشتراكات البوابة في إعدادات الاشتراك:- Allow Subscription Updates: تفعيل أو تعطيل قدرة العملاء على ترقية اشتراكاتهم أو الرجوع بها
- Allow Subscription Cancellation: تفعيل أو تعطيل قدرة العملاء على إلغاء اشتراكاتهم بأنفسهم
- Allow Subscription Pause: تفعيل أو تعطيل قدرة العملاء على إيقاف اشتراكاتهم مؤقتًا واستئنافها بأنفسهم
- Collect Plan Change Payments by Payment Link: إرسال العملاء إلى صفحة Checkout لدفع تكلفة تغيير الخطة الفوري بدلًا من تحصيل الرسوم من طريقة الدفع المحفوظة. يكون هذا الخيار معطلًا افتراضيًا.
Product Collections
تعرّف على كيفية إعداد مجموعات المنتجات وتهيئة مسارات الترقية والرجوع.
تفاصيل الاشتراك
عندما ينقر العملاء على “Manage subscription” في أي اشتراك نشط، ينتقلون إلى صفحة تفاصيل الاشتراك. تعرض هذه الصفحة:- تفاصيل الخطة: اسم الاشتراك، والسعر، وتاريخ التجديد، وفترة الصلاحية
- طريقة الدفع: البطاقة أو طريقة الدفع المرتبطة بالاشتراك، مع زر “Edit”
- معلومات الفوترة: الاسم، والبريد الإلكتروني، ورقم الهاتف، وعنوان الفوترة، مع زر “Edit”
- سجل الفوترة: جدول مفصل بجميع المدفوعات لهذا الاشتراك
- الإيقاف المؤقت: خيار لإيقاف الاشتراك مؤقتًا، يظهر عند السماح بالإيقاف المؤقت للخدمة الذاتية
- Cancel Subscription: زر بارز لإلغاء الاشتراك
إلغاء الاشتراك
يمكن للعملاء إلغاء اشتراكهم مباشرةً من صفحة تفاصيل الاشتراك. يؤدي النقر على “Cancel Subscription” إلى فتح مربع حوار للتأكيد يتضمن خيارين:- الإلغاء في تاريخ الفوترة التالي: يظل الاشتراك نشطًا حتى نهاية فترة الفوترة الحالية، ثم يُلغى تلقائيًا.
- الإلغاء الآن: يُلغى الاشتراك فورًا.
يتحكم إعداد Allow Subscription Cancellation ضمن Settings → Subscriptions في إلغاء الاشتراك بالخدمة الذاتية، وهو مفعّل افتراضيًا. عند تعطيله، يتم تعطيل زر Cancel Subscription مع إظهار تلميح يطلب من العميل التواصل معك، ويُرفض مسارا الإلغاء في البوابة — الإلغاء الآن والإلغاء في تاريخ الفوترة التالي. ويظل العملاء الذين لديهم إلغاء مجدول قادرين على إلغائه، حتى يتمكنوا من اختيار الاستمرار. ولا تتأثر عمليات الإلغاء التي تنفذها بنفسك مطلقًا.
أسباب الإلغاء
قبل تأكيد الإلغاء، يُسأل العملاء “Why are you cancelling?” ويُطلب منهم اختيار سبب من قائمة منتقاة. يُخزَّن السبب في الاشتراك ويظهر في حمولات webhook وواجهة API، حتى تتمكن من تحليل أسباب فقدان العملاء وتخصيص تدفقات استعادة العملاء.
تُكتب القيمة المحددة في حقل الاشتراك
cancellation_feedback. ويمكن أيضًا تسجيل cancellation_comment اختياري بنص حر.
subscription.cancelled، ويمكنك تعبئتهما برمجيًا في PATCH /subscriptions/{subscription_id} عند جدولة الإلغاء أو تنفيذه عبر API.
إيقاف الاشتراك مؤقتًا
يوفر الإيقاف المؤقت للعملاء خيارًا متوسطًا بين الاحتفاظ بالاشتراك وإلغائه نهائيًا. يوقف الاشتراك المؤقت الفوترة، لكنه يحتفظ بخطته وسجله، بحيث يمكن للعميل العودة إليه لاحقًا بدلًا من البدء من جديد. يفتح العملاء مربع حوار الإيقاف المؤقت من صفحة تفاصيل الاشتراك. يوضح مربع الحوار الخطة الحالية، ويحذّر من انتهاء الوصول فورًا، ويشرح كيفية تغيّر تواريخ الفوترة. ويؤكد العميل باستخدام Pause subscription.
- يتوقف الوصول فورًا. تتوقف الميزات والتنزيلات ومفاتيح الترخيص المضمنة في الاشتراك عن العمل حتى يتم استئناف الاشتراك.
- لا يوجد تاريخ انتهاء للإيقاف المؤقت. يظل الاشتراك متوقفًا مؤقتًا حتى يستأنفه العميل.
- لا يضيع أي وقت. يتقدم تاريخ الفوترة التالي وتاريخ التجديد بمقدار مدة الإيقاف المؤقت.
active وتتم استعادة الوصول إليه.
يتحكم إعداد Allow Subscription Pause ضمن Settings → Subscriptions في الإيقاف المؤقت بالخدمة الذاتية، وهو معطل افتراضيًا. أثناء تعطيله، لا يمكن للعملاء بدء إيقاف مؤقت جديد، لكن يظل بإمكان العميل الذي أوقف اشتراكه مؤقتًا استئناف الإيقاف الذي بدأه بنفسه. ولا تتأثر عمليات الإيقاف المؤقت التي تنفذها بنفسك من لوحة المعلومات مطلقًا.
How Pausing Works
سلوك الإيقاف المؤقت بالكامل، بما في ذلك تأثيرات الفوترة، وتسوية الاستخدام، وwebhooks.
تحديث طرق الدفع
يمكن للعملاء تحديث طرق الدفع مباشرةً من صفحة تفاصيل الاشتراك بالنقر على “Edit” بجوار طريقة الدفع. وتكتسب هذه الميزة أهمية خاصة لإعادة تفعيل الاشتراكات التي تم تعليقها بسبب فشل المدفوعات.إعادة تفعيل الاشتراكات المعلقة
عند وضع اشتراك في حالةon_hold بسبب فشل الدفع، يجب على العملاء تحديث طريقة الدفع لإعادة تفعيله. وتقوم عملية التحديث تلقائيًا بما يلي:
- إنشاء رسوم للمبالغ المستحقة المتبقية
- إنشاء فاتورة للرسوم
- معالجة الدفع باستخدام طريقة الدفع الجديدة
- إعادة تفعيل الاشتراك إلى حالة
activeعند نجاح الدفع
بعد تحديث طريقة الدفع بنجاح لاشتراك في حالة
on_hold، ستظهر للعملاء صفحة تأكيد وسيتلقون إشعارات عبر البريد الإلكتروني بشأن نجاح الدفع وإعادة تفعيل الاشتراك.تدفق تحديث طريقة الدفع
1
Access subscription details
انقر على “Manage subscription” في أي اشتراك نشط من الصفحة الرئيسية للبوابة.
2
Click Edit on payment method
انقر على زر “Edit” بجوار طريقة الدفع لفتح واجهة تحديث طريقة الدفع.
3
Select or add payment method
اختر طريقة دفع محفوظة موجودة أو أضف طريقة جديدة بإدخال تفاصيل البطاقة بأمان.
4
Confirm changes
أكد التحديث. بالنسبة إلى الاشتراكات في حالة
on_hold، سيؤدي ذلك تلقائيًا إلى إنشاء رسوم للمبالغ المستحقة المتبقية.5
Complete payment (if on hold)
إذا كان الاشتراك معلقًا، فسيُعاد توجيه العملاء لإكمال دفع المبالغ المستحقة المتبقية. وبعد نجاح الدفع، يُعاد تفعيل الاشتراك تلقائيًا.
6
Confirmation
يتلقى العملاء تأكيدًا بتحديث طريقة الدفع، وبإعادة تفعيل الاشتراك إذا انطبق ذلك.
أمثلة التكامل
أنشئ جلسة Customer Portal محددة المدة لعميل معين عبر API، ثم أعد توجيه المستخدم إلى عنوان URL الخاص بالجلسة.Unified Customer Portal
بالإضافة إلى بوابات العملاء الخاصة بكل نشاط تجاري، توفر Dodo Payments Unified Customer Portal على customer.dodopayments.com، حيث يمكن للعملاء عرض جميع مشترياتهم واشتراكاتهم وإدارتها عبر أنشطة تجارية مختلفة تستخدم Dodo Payments.
ميزات Unified Portal
- رؤية مشتركة بين الأنشطة التجارية: عرض جميع المشتريات والاشتراكات من أي تاجر يستخدم Dodo Payments في مكان واحد
- إدارة مركزية: إدارة الاشتراكات عبر أنشطة تجارية مختلفة من لوحة تحكم واحدة
- سجل فوترة موحد: الوصول إلى الفواتير وسجل المدفوعات لجميع المشتريات
- تسجيل دخول موحد: تسجيل الدخول مرة واحدة باستخدام البريد الإلكتروني للوصول إلى المشتريات من جميع تجار Dodo Payments
استكشاف الأخطاء وإصلاحها
- انتهت صلاحية الرابط: أنشئ رابطًا ديناميكيًا جديدًا وأرسله.
- لم يتم التعرف على البريد الإلكتروني: اطلب من العميل استخدام البريد الإلكتروني المرتبط بعملية الشراء
- الاشتراك معلق: إذا كان الاشتراك معلقًا، يجب على العملاء تحديث طريقة الدفع من خلال البوابة لتسوية المستحقات وإعادة تفعيل الاشتراك. وستحصّل عملية التحديث تلقائيًا رسوم المبالغ المستحقة المتبقية.
- فشل تحديث طريقة الدفع: إذا فشل الدفع أثناء عملية التحديث لاشتراك في حالة
on_hold، فسيظل الاشتراك معلقًا. ويمكن للعملاء إعادة المحاولة باستخدام طريقة دفع مختلفة.
Design & Theme Customization
خصّص مظهر بوابة العملاء باستخدام السمات المُعدّة مسبقًا، والطباعة، والألوان، والمعاينة المباشرة من صفحة Design.