بوابة العملاء

​

ما هي بوابة العملاء؟

• الوصول إلى سجل الفوترة: عرض الفواتير وتنزيل الإيصالات.
• إدارة الاشتراكات: عرض تفاصيل الاشتراك، وإيقاف الاشتراكات مؤقتًا واستئنافها، وإلغاء الاشتراكات فورًا أو في تاريخ الفوترة التالي.
• تحديث طرق الدفع: تغيير طرق الدفع للاشتراكات النشطة أو إعادة تفعيل الاشتراكات المعلّقة.
• استرداد مفاتيح الترخيص: الوصول إلى جميع المفاتيح المرتبطة بعمليات الشراء.
• التنقل بسهولة: استخدام زر الرجوع للتنقل بين أقسام البوابة دون فقدان السياق.

​

الفوائد الرئيسية

• خفض حجم الدعم: يحل العملاء طلبات الفوترة الشائعة بأنفسهم
• الوصول السريع للقيمة: وصول فوري للفواتير والمفاتيح
• تقليل خطر الإلغاء: رؤية واضحة لتجديدات وتفاصيل الخطط
• آمن بتصميمه: الوصول المرمز برموز وروابط منتهية الصلاحية
• تجربة محلية: البوابة متوفرة بـ 21 لغة، مع الكشف التلقائي وفقًا لتفضيلات متصفح العميل

​

طرق الوصول

​

رابط ثابت (الوصول عبر البريد الإلكتروني)

https://test.customer.dodopayments.com/login/{business_id}

https://customer.dodopayments.com/login/{business_id}

​

رابط ديناميكي (رابط سحري)

​

ميزات البوابة

​

نظرة عامة على البوابة

​

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

​

دعم اللغة

​

كيف تعمل اختيار اللغة

• الكشف التلقائي: عند الزيارة الأولى، يكتشف البوابة لغة العميل المفضلة من إعدادات المتصفح ويحمّل الترجمة المطابقة إذا كانت متوفرة. اللغة الإنجليزية تُستخدم كخيار افتراضي.
• التعديل اليدوي: يمكن للعملاء تغيير اللغة النشطة في أي وقت من خلال محدد اللغة في رأس البوابة (متاح على كلّ من سطح المكتب والهاتف المحمول).
• حفظ التفضيلات: يتم حفظ اللغة المختارة في الكوكي NEXT_LOCALE (صالحة لمدة عام واحد) حتى يتذكر البوابة الخيار عبر الجلسات.

​

اللغات المدعومة

​

تغييرات الخطة (ترقية/تخفيض)

​

الإجراءات المتاحة

​

كيفية عمل تغييرات الخطة

1. يعرض العميل اشتراكه الحالي في البوابة
2. تظهر خيارات الترقية/التخفيض المتاحة بناءً على مجموعة المنتجات
3. يختار العميل الخطة الجديدة
4. يتم حساب التكلفة وفقًا للمعدل الجديد ومعالجة الدفع فورًا (إذا كان ذلك ممكنًا)
5. يتم تحديث الاشتراك إلى الخطة الجديدة

​

عناصر التحكم في الأعمال

• السماح بتحديثات الاشتراك: تفعيل أو تعطيل إمكانية ترقية العملاء لاشتراكاتهم أو تخفيضها
• السماح بإلغاء الاشتراك: تفعيل أو تعطيل إمكانية إلغاء العملاء لاشتراكاتهم بأنفسهم
• السماح بإيقاف الاشتراك مؤقتًا: تفعيل أو تعطيل إمكانية إيقاف العملاء لاشتراكاتهم مؤقتًا واستئنافها بأنفسهم

​

تفاصيل الاشتراك

• تفاصيل الخطة: اسم الاشتراك والسعر وتاريخ التجديد وفترة الصلاحية
• طريقة الدفع: البطاقة أو طريقة الدفع المرتبطة بالاشتراك، مع زر “تعديل”
• معلومات الفوترة: الاسم والبريد الإلكتروني ورقم الهاتف وعنوان الفوترة، مع زر “تعديل”
• سجل الفوترة: جدول مفصل بجميع المدفوعات لهذا الاشتراك
• الإيقاف المؤقت: خيار لإيقاف الاشتراك مؤقتًا، يظهر عند السماح بالإيقاف المؤقت للخدمة الذاتية
• إلغاء الاشتراك: زر بارز لإلغاء الاشتراك

​

إلغاء الاشتراك

• الإلغاء في تاريخ الفاتورة التالي: يبقى الاشتراك نشطًا حتى نهاية فترة الفاتورة الحالية، ثم يتم إلغاؤه تلقائيًا.
• الإلغاء الآن: يتم إلغاء الاشتراك على الفور.

​

أسباب الإلغاء

// Read the captured feedback after a customer cancels
const subscription = await client.subscriptions.retrieve('sub_123');
console.log(subscription.cancellation_feedback); // e.g., "too_expensive"
console.log(subscription.cancellation_comment);  // e.g., "Switching to a competitor"

​

إيقاف الاشتراك مؤقتًا

• يتوقف الوصول فورًا. تتوقف الميزات والتنزيلات ومفاتيح الترخيص المضمنة في الاشتراك عن العمل حتى يتم استئناف الاشتراك.
• لا يوجد تاريخ لانتهاء الإيقاف المؤقت. يظل الاشتراك متوقفًا مؤقتًا حتى يستأنفه العميل.
• لا يضيع أي وقت. يتقدم كل من تاريخ الفوترة التالي وتاريخ التجديد بمقدار مدة الإيقاف المؤقت.

​

تحديث طرق الدفع

​

إعادة تفعيل الاشتراكات المعلّقة

1. إنشاء رسوم للمبالغ المستحقة المتبقية
2. إنشاء فاتورة للرسوم
3. معالجة الدفع باستخدام طريقة الدفع الجديدة
4. إعادة تفعيل الاشتراك إلى حالة active عند نجاح الدفع

​

تدفق تحديث طريقة الدفع

​

أمثلة على التكامل

const session = await client.customers.customerPortal.create('cus_123');

// Redirect the user to the hosted Customer Portal
window.location.href = session.link;

​

Unified Customer Portal

​

ميزات Unified Portal

• الرؤية عبر الأنشطة التجارية: عرض جميع عمليات الشراء والاشتراكات من أي تاجر يستخدم Dodo Payments في مكان واحد
• الإدارة المركزية: إدارة الاشتراكات عبر الأنشطة التجارية المختلفة من لوحة معلومات واحدة
• سجل فوترة موحّد: الوصول إلى الفواتير وسجل المدفوعات لجميع عمليات الشراء
• تسجيل دخول موحّد: تسجيل الدخول مرة واحدة باستخدام البريد الإلكتروني للوصول إلى عمليات الشراء لدى جميع التجار الذين يستخدمون Dodo Payments

​

استكشاف الأخطاء وإصلاحها

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