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

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

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 (صالحة لمدة عام واحد) حتى يتذكر البوابة الخيار عبر الجلسات.

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

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

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

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

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

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

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

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

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

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

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

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

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

Product Collections

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

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

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

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

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

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

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

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

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

قبل تأكيد الإلغاء، يُطلب من العملاء “لماذا تلغي؟” ويتم تحفيزهم لاختيار سبب من قائمة مختارة بعناية. يتم تخزين السبب في الاشتراك ويظهَر في بيانات الحمولة لويب هوك وAPI، حتى تتمكن من تحليل دوافع الإلغاء وتكييف إجراءات الاستعادة الخاصة بك.

نموذج الإلغاء مع القائمة المنسدلة 'لماذا تلغي؟' تعرض أسباب مثل: غالي جدًا، وميزات مفقودة، وأخرى

القيمة	التسمية المواجهة للعميل
`too_expensive`	غالي جدًا
`missing_features`	ميزات مفقودة
`switched_service`	التحوّل إلى خدمة أخرى
`unused`	عدم الاستخدام بشكل كافٍ
`customer_service`	خدمة العملاء السيئة
`low_quality`	جودة منخفضة
`too_complex`	معقد جدًا
`other`	أخرى

القيمة المحددة تُكتب في حقل cancellation_feedback الخاص بالاشتراك. يمكن أيضًا التقاط cancellation_comment النص الحر الاختياري.

// 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"

الحقول تُضمّن أيضًا في حمولة ويب هوك subscription.cancelled، ويمكنك تعبئتها بشكل برمجي على PATCH /subscriptions/{id} عند جدولة أو تنفيذ الإلغاء عبر API.

اجمع cancellation_feedback مع تحصيل الاشتراكات لتكييف رسائل الاستعادة - مثلاً، أرسل كود خصم إلى too_expensive الملغين واستطلاع “ما الذي ينقص؟” إلى missing_features الملغين.

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

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

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

عندما يكون الاشتراك في حالة 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;