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

بوابة العملاء هي منطقة آمنة مُستضافة حيث يمكن لعملائك إدارة الاشتراكات، وعرض الفواتير، والوصول إلى تفاصيل مفاتيح الترخيص—دون الحاجة للتواصل مع الدعم.

Create Portal Session (API)

أنشئ برمجيًا جلسات بوابة آمنة ومحددة زمنياً.

Subscriptions

إدارة الخطط المتكررة، والترقيات، والتخفيضات، والإضافات.

بوابة العملاء المُجددة التي تظهر الاشتراكات النشطة وطرق الدفع وسجل الفواتير

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

توفر البوابة تجربة خدمة ذاتية موثوقة ومميزة للعملاء لـ:

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

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

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

طرق الوصول

يمكن للعملاء الوصول إلى البوابة باستخدام رابط ثابت أو رابط ديناميكي لمرة واحدة.

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

يمكن للعملاء طلب الوصول إلى البوابة عن طريق إدخال بريدهم الإلكتروني في رابط ثابت لا ينتهي صلاحيته. يختلف تنسيق رابط البوابة الثابت حسب البيئة: وضع الاختبار (للاختبار والتطوير):

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

وضع الإنتاج (للإنتاج مع معاملات حقيقية):

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

استبدل {business_id} بمعرّف عملك الفعلي، ثم شارك الرابط المناسب مع العملاء حتى يتمكنوا من إدخال بريدهم الإلكتروني والحصول على وصول آمن إلى البوابة.

Merchant flow

انتقل إلى المبيعات → العملاء.
انقر على مشاركة الدعوة.
انسخ الرابط الثابت وشاركه مع عميلك.

Customer flow

افتح الرابط الثابت.
أدخل البريد الإلكتروني المستخدم أثناء الشراء.
استلم رابط تسجيل دخول آمن للوصول إلى البوابة.

يتم التعرف على العملاء الحاليين تلقائيًا.

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

رابط سحري شخصي لمرة واحدة يرسل العملاء مباشرة إلى البوابة. ينتهي الرابط بعد 24 ساعة.

تنتهي صلاحية الروابط الديناميكية بعد 24 ساعة. إذا انتهت، فأنشئ وأرسل رابطًا جديدًا.

Merchant flow

انتقل إلى المبيعات → العملاء.
انقر على مشاركة الدعوة.
انسخ الرابط الديناميكي وشاركه مع عميلك.

Customer flow

افتح الرابط الديناميكي.
ادخل مباشرة إلى بوابة العملاء دون إدخال بريد إلكتروني.

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

يوفر بوابة العملاء المُجددة واجهة نظيفة وموحدة مع شريط جانبي يسار وأقسام منظمة لجميع احتياجات إدارة الحساب.

Active Subscriptions

عرض جميع الاشتراكات النشطة مع اسم الخطة، والسعر، وتاريخ التجديد، وسريان المدة. انقر على “إدارة الاشتراك” لعرض التفاصيل، وتحرير معلومات الفوترة، أو الإلغاء.

Payment Methods

عرض جميع طرق الدفع المحفوظة (البطاقات، UPI، إلخ) في لمحة. حرّر طرق الدفع مباشرة من تفاصيل الاشتراك.

Billing History

عرض جميع المعاملات في جدول مفصل يحتوي على التاريخ، الحالة، نوع التسعير، الصلاحيات، والفواتير القابلة للتنزيل.

Billing Information

عرض وتحرير الاسم، البريد الإلكتروني، رقم الهاتف، وعنوان الفوترة من صفحة تفاصيل الاشتراك.

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

تعرض الصفحة الرئيسية للبوابة جميع الاشتراكات النشطة، وطرق الدفع المحفوظة، وتاريخ الفوترة في عرض قابل للتمرير الواحد.

الصفحة الرئيسية لبوابة العملاء التي تعرض الاشتراكات النشطة وطرق الدفع

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

قم بالتمرير لأسفل لعرض طرق الدفع المحفوظة وتاريخ الفوترة الكامل مع مؤشرات الحالة والفواتير القابلة للتنزيل.

طرق الدفع وسجل الفواتير مع تنزيلات الفواتير

دعم اللغة

بوابة العملاء متوفرة بـ 21 لغة، لذا يمكن لعملائك إدارة اشتراكاتهم وطرق الدفع وسجل الفواتير باللغة التي يفضلونها.

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

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

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

اللغة	الرمز	اللغة	الرمز
الإنجليزية (الافتراضية)	`en`	الإندونيسية	`id`
العربية	`ar`	الإيطالية	`it`
الكتالونية	`ca`	اليابانية	`ja`
الصينية	`zh`	الكورية	`ko`
الهولندية	`nl`	الماليزية	`ms`
الفرنسية	`fr`	البولندية	`pl`
الألمانية	`de`	البرتغالية	`pt`
العبرية	`he`	الرومانية	`ro`
الروسية	`ru`	الإسبانية	`es`
السويدية	`sv`	التايلندية	`th`
التركية	`tr`

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

عندما يتم تنظيم المنتجات في مجموعات منتج، يمكن للعميل الترقية أو التخفيض بين الخطط مباشرة من بوابة العملاء.

هل تريد تمكين الترقية/التخفيض للاشتراكات الحالية؟ أضف منتجات اشتراكك إلى مجموعة منتج. بمجرد تجميعها، يمكن للعملاء التبديل بين الخطط في نفس المجموعة عبر بوابة العملاء.

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

الإجراء	الوصف	متى يكون متاحًا
ترقية	الانتقال إلى خطة أعلى في نفس المجموعة	تمكين التحديثات الاشتراكية للأعمال
تخفيض	الانتقال إلى خطة أدنى في نفس المجموعة	تمكين التحديثات الاشتراكية للأعمال

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

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

التغييرات في الخطط متاحة فقط بين المنتجات في نفس المجموعة. يجب أن تكون المنتجات من أنواع الفواتير الاشتراكية أو القائمة على الاستخدام.

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

يمكن للشركات ضبط سلوك تغييرات الخطة في إعدادات الاشتراكات:

السماح بتحديثات الاشتراك: تمكين أو تعطيل القدرة للعملاء على الترقية أو التخفيض في اشتراكاتهم

Product Collections

تعرف على كيفية إعداد مجموعات المنتجات وتكوين مسارات الترقية/التخفيض.

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

عندما ينقر العملاء على “إدارة الاشتراك” في أي اشتراك نشط، يتم نقلهم إلى صفحة تفاصيل الاشتراك. تُظهر هذه الصفحة:

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

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

يمكن للعملاء إلغاء اشتراكهم مباشرة من صفحة تفاصيل الاشتراك. يؤدي النقر على “إلغاء الاشتراك” إلى فتح حوار تأكيد مع خيارين:

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

حوار إلغاء الاشتراك مع خيارات الإلغاء في تاريخ الفاتورة التالي أو الإلغاء الفوري

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

يمكن للعملاء تحديث طرق الدفع الخاصة بهم مباشرة من صفحة تفاصيل الاشتراك عن طريق النقر على “تحرير” بجوار طريقة الدفع. هذه الميزة مهمة بشكل خاص لإعادة تفعيل الاشتراكات التي تم تعليقها بسبب الفشل في الدفع.

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

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

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

الاشتراكات في حالة on_hold لن تتجدد تلقائيًا. يجب على العملاء تحديث طريقة الدفع لتصفية المدفوعات وإعادة تفعيل الاشتراك.

بعد تحديث طريقة الدفع بنجاح لاشتراك on_hold، سيرى العملاء صفحة تأكيد وسيتلقون إخطارات عبر البريد الإلكتروني حول الدفع الناجح وإعادة تفعيل الاشتراك.

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

Access subscription details

انقر على “إدارة الاشتراك” في أي اشتراك نشط من صفحة البوابة الرئيسية.

Click Edit on payment method

انقر على زر “تحرير” بجوار طريقة الدفع لفتح واجهة تحديث طريقة الدفع.

Select or add payment method

اختر طريقة الدفع المحفوظة الموجودة أو أضف طريقة جديدة بإدخال تفاصيل البطاقة بأمان.

Confirm changes

أكد التحديث. بالنسبة للاشتراكات on_hold، سيؤدي هذا تلقائيًا إلى إنشاء شحنة للمدفوعات المستحقة.

Complete payment (if on hold)

إذا كان الاشتراك قيد الانتظار، سيتم توجيه العملاء لإكمال الدفع للمدفوعات المستحقة. عند نجاح الدفع، يتم إعادة تفعيل الاشتراك تلقائيًا.

Confirmation

يتلقى العملاء تأكيدًا بأن طريقة الدفع قد تم تحديثها وإذا كان ذلك ممكنًا، بأن الاشتراك قد تم إعادة تفعيله.

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

أنشئ جلسة بوابة العملاء محددة بزمن لعميل معين عبر API، ثم أعد توجيه المستخدم إلى رابط الجلسة.

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

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