Customer Portal هو موقع مستضاف يدير فيه عملاؤك اشتراكاتهم، ويعرضون الفواتير وينزلونها، ويسترجعون مفاتيح الترخيص من دون التواصل مع الدعم.
Create Portal Session (API)
أنشئ رابط بوابة لعميل واحد، صالح لمدة 24 ساعة.
Subscriptions
الخطط المتكررة، والترقيات، وخفض المستوى، والإضافات.
ما هي Customer Portal؟
البوابة هي موقع للخدمة الذاتية يحمل اسم نشاطك التجاري، ويمكن للعملاء من خلاله:- الوصول إلى سجل الفوترة: عرض المدفوعات السابقة وتنزيل الفواتير.
- إدارة الاشتراكات: عرض تفاصيل الاشتراك، وإيقافه مؤقتًا واستئنافه، وإلغاؤه فورًا أو في تاريخ الفوترة التالي، وفقًا لإعداداتك.
- تحديث طرق الدفع: تغيير طريقة الدفع لاشتراك، أو إعادة تنشيط اشتراك موضوع قيد التعليق.
- استرجاع مفاتيح الترخيص: عرض مفاتيح الترخيص المرتبطة بعمليات الشراء.
- العودة إلى تطبيقك: عند تمرير
return_url، تعرض البوابة رابط عودة إلى نشاطك التجاري. وعلى الأجهزة المحمولة، يعيد سهم الرجوع في الترويسة العميل إلى نظرة عامة على البوابة.
إذا حظرت عميلًا، تصبح بوابته للقراءة فقط. ولا يزال بإمكانه تسجيل الدخول وعرض الفواتير والاشتراكات ومفاتيح الترخيص، لكنه لا يستطيع إلغاء الاشتراك أو إيقافه مؤقتًا أو استئنافه، أو تغيير الخطط، أو تحديث طريقة الدفع. يعيد ملف البوابة
read_only: true حتى يتمكن تكامل مخصص من تعطيل عناصر التحكم الخاصة به.المزايا الرئيسية
- تقليل حجم طلبات الدعم: يتولى العملاء طلبات الفوترة الشائعة بأنفسهم.
- وصول أسرع: يحصل العملاء على الفواتير ومفاتيح الترخيص فور تسجيل دخولهم.
- تقليل مخاطر فقدان العملاء: يرى العملاء تواريخ التجديد وتفاصيل الخطة قبل تحصيل الرسوم منهم.
- روابط موقعة تنتهي صلاحيتها: كل رابط تسجيل دخول موقّع وتنتهي صلاحيته بعد 24 ساعة.
- تجربة محلية: تتوفر البوابة بـ21 لغة وتختار إحدى اللغات من إعدادات متصفح العميل.
طرق الوصول
يصل العملاء إلى البوابة عبر رابط ثابت أو رابط ديناميكي.الرابط الثابت (الوصول عبر البريد الإلكتروني)
لا تنتهي صلاحية الرابط الثابت. يفتحه العميل، ويدخل عنوان بريده الإلكتروني، ويتلقى رابط تسجيل الدخول عبر البريد الإلكتروني. يعتمد الرابط الثابت على البيئة: وضع الاختبار (للاختبار والتطوير):{business_id} بمعرّف نشاطك التجاري، ثم شارك الرابط مع عملائك. يتضمن الرابط الثابت في مربع الحوار مشاركة الدعوة هذا المعرّف بالفعل.
1
Merchant Flow
- انتقل إلى المبيعات ← العملاء وافتح عميلًا، أو استخدم عمود دعوة في القائمة.
- انقر على مشاركة الدعوة.
- انسخ الرابط الثابت وشاركه مع عميلك.
2
Customer Flow
- افتح الرابط الثابت.
- أدخل عنوان البريد الإلكتروني المستخدم عند الشراء وانقر على الحصول على رابط الوصول.
- افتح رابط تسجيل الدخول المرسل عبر البريد الإلكتروني. وهو صالح لمدة 24 ساعة.
تعرض الصفحة دائمًا رسالة التأكيد نفسها. يرسل Dodo Payments رابطًا فقط عندما يكون العنوان تابعًا لعميل لدى نشاطك التجاري، لذلك لا تكشف الصفحة هوية عملائك.
لا تُرسل رسائل تسجيل الدخول عبر البريد الإلكتروني في وضع الاختبار. لفتح بوابة في وضع الاختبار، استخدم الرابط الديناميكي أو أنشئ جلسة عبر API.
الرابط الديناميكي (الرابط السحري)
يسجل الرابط الديناميكي دخول عميل واحد مباشرةً إلى البوابة، من دون خطوة البريد الإلكتروني. وتنتهي صلاحيته بعد 24 ساعة من إنشائه.
1
Merchant Flow
- انتقل إلى المبيعات ← العملاء وافتح العميل.
- انقر على مشاركة الدعوة.
- انسخ الرابط الديناميكي وشاركه مع عميلك.
2
Customer Flow
- افتح الرابط الديناميكي.
- تُفتح Customer Portal مباشرةً من دون إدخال عنوان بريد إلكتروني.
ميزات Customer Portal
نظرة عامة على البوابة هي صفحة واحدة. على أجهزة الكمبيوتر، تصف لوحة على اليسار البوابة. وتعرض المنطقة الرئيسية اشتراكات العميل وطرق الدفع وسجل الفوترة.Active Subscriptions
يعرض كل اشتراك اسم خطته وسعرها وتاريخ تجديدها وصلاحيتها. يفتح إدارة الاشتراك تفاصيله، حيث يمكن للعميل تعديل تفاصيل الفوترة أو تغيير الخطة أو الإيقاف المؤقت أو الإلغاء.
Payment Methods
طرق الدفع المحفوظة، مثل البطاقات مع شبكتها وآخر أربعة أرقام منها، وUPI، والمحافظ، وطرق الدفع البنكية. غيّر طريقة دفع الاشتراك من صفحة تفاصيله.
Billing History
كل دفعة في جدول يتضمن التاريخ والحالة والمبلغ ونوع التسعير والاستحقاقات وتنزيل الفاتورة.
Billing Information
الاسم والبريد الإلكتروني ورقم الهاتف وعنوان الفوترة، وتظهر في صفحة تفاصيل الاشتراك. ويمكن للعملاء تعديل الاسم وعنوان الفوترة.
نظرة عامة على Customer Portal
تعرض صفحة النظرة العامة الاشتراكات النشطة وطرق الدفع المحفوظة وسجل الفوترة في عرض واحد قابل للتمرير.طرق الدفع وسجل الفوترة
في أسفل الصفحة توجد طرق الدفع المحفوظة وسجل الفوترة، مع حالة لكل دفعة ورابط تنزيل لكل فاتورة.
دعم اللغات
تتوفر Customer Portal بـ21 لغة، حتى يتمكن العملاء من إدارة الاشتراكات وطرق الدفع وسجل الفوترة بلغتهم الخاصة.كيف يعمل اختيار اللغة
- الاكتشاف التلقائي: عند الزيارة الأولى، تقرأ البوابة اللغة المفضلة من المتصفح وتحملها إذا كانت مدعومة. وإلا فتستخدم الإنجليزية.
- التجاوز اليدوي: يمكن للعملاء تغيير اللغة في أي وقت باستخدام محدد اللغة في الزاوية السفلية اليمنى من الصفحة، على أجهزة الكمبيوتر والأجهزة المحمولة.
- تفضيل محفوظ: تخزن البوابة الاختيار في ملف تعريف الارتباط
NEXT_LOCALEلمدة عام واحد، فتتذكر اللغة بين الزيارات.
اللغات المدعومة
تغييرات الخطة (الترقية/الرجوع)
يمكن للعملاء الترقية أو خفض المستوى من البوابة بين المنتجات الموجودة في مجموعة المنتجات نفسها.الإجراءات المتاحة
آلية عمل تغييرات الخطة
- ينقر العميل على تغيير الخطة في صفحة تفاصيل الاشتراك.
- تعرض البوابة الخطط الأخرى في مجموعة المنتجات.
- يختار العميل خطة. تعرض لوحة تأكيد تغيير الخطة الخطة الحالية والمحدّثة، وتفصيل بنود السطر (رصيد للخطة القديمة ورسوم للخطة الجديدة)، والضريبة، والمبلغ المستحق الآن. ويمكن للعميل أيضًا إدخال رمز خصم هنا.
- يؤكد العميل باستخدام زر الدفع الذي يعرض المبلغ المستحق.
- يحسب Dodo Payments التوزيع النسبي ويحصل الرسوم إما من طريقة الدفع المحفوظة أو في صفحة دفع مستضافة إذا كنت تجمع مدفوعات تغيير الخطة عبر رابط دفع (راجع جمع مدفوعات تغيير الخطة عبر رابط دفع).
- ينتقل الاشتراك إلى الخطة الجديدة. ويعتمد حدوث ذلك فورًا أو بعد نجاح تحصيل الرسوم فقط على معالجة فشل الدفع. أما تغيير الخطة المدفوع عبر رابط دفع، فينتظر دائمًا إتمام الدفع.
تعمل تغييرات الخطة فقط بين المنتجات الموجودة في المجموعة نفسها، ويجب أن يكون المنتج المستهدف منتج اشتراك أو منتجًا قائمًا على الاستخدام. أما المنتجات ذات الدفعة الواحدة فسيتم رفضها.
جمع مدفوعات تغيير الخطة عبر رابط الدفع
افتراضيًا، يحمّل تغيير الخطة الفوري الرسوم من طريقة الدفع المحفوظة للعميل. عند تفعيل تحصيل مدفوعات تغيير الخطة عبر رابط دفع، تفتح البوابة بدلًا من ذلك صفحة دفع مستضافة من Dodo Payments في علامة تبويب جديدة، ويدفع العميل هناك. وينطبق ذلك على الترقيات وخفض المستوى اللذين ينتج عنهما رسم.
يبقى الاشتراك على خطته الحالية حتى ينجح الدفع في صفحة الدفع. ويترك الدفع الفاشل أو المتروك الاشتراك دون تغيير، ويمكن للعميل إعادة المحاولة في جلسة الدفع نفسها. أما عمليات خفض المستوى المجدولة (
effective_at: next_billing_date) فلا تمر عبر صفحة الدفع؛ بل تُطبّق في تاريخ الفوترة التالي كالمعتاد.Plan Change via Payment Link (API)
كيفية طلب رابط دفع باستخدام
collect_via_payment_link ومعالجة الاستجابة.عناصر تحكم النشاط التجاري
اضبط ما يمكن للعملاء فعله باشتراكاتهم ضمن الإعدادات ← الاشتراكات:- السماح بتحديثات الاشتراك: يتيح للعملاء الترقية أو خفض المستوى. وهو متوقف افتراضيًا.
- السماح بالإلغاء الفوري: يتيح للعملاء إنهاء اشتراكهم وفقدان الوصول فورًا. وهو مفعّل افتراضيًا.
- السماح بالإلغاء في تاريخ الفوترة التالي: يتيح للعملاء الإلغاء في نهاية الفترة التي دفعوا مقابلها. وهو مفعّل افتراضيًا.
- السماح بإيقاف الاشتراك مؤقتًا: يتيح للعملاء إيقاف اشتراكاتهم واستئنافها بأنفسهم. وهو متوقف افتراضيًا.
- تحصيل مدفوعات تغيير الخطة عبر رابط دفع: يرسل العملاء إلى صفحة دفع لسداد تكلفة تغيير الخطة الفوري بدلًا من تحصيلها من طريقة الدفع المحفوظة. وهو متوقف افتراضيًا.
Product Collections
أعد مجموعات المنتجات واضبط مسارات الترقية وخفض المستوى.
تفاصيل الاشتراك
يفتح إدارة الاشتراك في أي اشتراك نشط صفحة تفاصيله، التي تعرض:- تفاصيل الخطة: اسم الاشتراك وسعره وتاريخ التجديد وفترة الصلاحية.
- طريقة الدفع: طريقة الدفع الخاصة بالاشتراك، مع زر تعديل.
- معلومات الفوترة: الاسم والبريد الإلكتروني ورقم الهاتف وعنوان الفوترة، مع زر تعديل للاسم وعنوان الفوترة.
- سجل الفوترة: جدول بجميع مدفوعات هذا الاشتراك.
- إيقاف الاشتراك مؤقتًا: يظهر عند السماح بالإيقاف الذاتي.
- إلغاء الاشتراك: يفتح مربع حوار الإلغاء.
إلغاء الاشتراك
يلغي العملاء الاشتراك من صفحة تفاصيله. يفتح إلغاء الاشتراك مربع حوار يتضمن خيارين:- الإلغاء في تاريخ الفوترة التالي: يظل الاشتراك نشطًا حتى انتهاء فترة الفوترة الحالية، ثم يُلغى.
- الإلغاء الآن: يُلغى الاشتراك فورًا.
يتحكم إعدادان ضمن الإعدادات ← الاشتراكات في هذين الخيارين بشكل منفصل: السماح بالإلغاء الفوري والسماح بالإلغاء في تاريخ الفوترة التالي. وكلاهما مفعّل افتراضيًا. يؤدي إيقاف أحدهما إلى إزالة هذا الخيار فقط، بحيث يمكنك تقديم أحدهما دون الآخر. وعند إيقاف كليهما، يتعطل إلغاء الاشتراك، وتطلب تلميحاته من العميل التواصل معك. ويرى العميل الذي لديه إلغاء مجدول بالفعل التراجع عن الإلغاء، حتى يتمكن من البقاء، والإلغاء فورًا، وهو الإجراء نفسه مثل الإلغاء الآن. ولا تؤثر هذه الإعدادات في عمليات الإلغاء التي تجريها بنفسك.
أسباب الإلغاء
قبل التأكيد، يجب على العميل الإجابة عن لماذا تلغي؟ باختيار سبب من قائمة ثابتة. ويمكنه أيضًا إضافة تعليق اختياري يصل إلى 500 حرف ضمن تعليقات إضافية. يخزن Dodo Payments كليهما في الاشتراك ويعيدهما في حمولات webhook وAPI، حتى تتمكن من تحليل أسباب مغادرة العملاء وتخصيص رسائل استعادة العملاء.
يُخزّن السبب في الحقل
cancellation_feedback للاشتراك، والتعليق في cancellation_comment.
subscription.cancelled. لتعيينهما بنفسك، مرّرهما إلى PATCH /subscriptions/{subscription_id} عند إلغاء الاشتراك أو جدولة إلغائه عبر API.
إيقاف الاشتراك مؤقتًا
يمنح الإيقاف المؤقت العملاء خيارًا بين الاحتفاظ بالاشتراك وإلغائه. يتوقف الاشتراك المؤقت عن الفوترة لكنه يحتفظ بخطته وسجله، حتى يتمكن العميل من استئنافه لاحقًا بدلًا من الشراء مجددًا. يفتح العملاء مربع حوار إيقاف اشتراكك مؤقتًا من صفحة تفاصيل الاشتراك. يعرض مربع الحوار الخطة الحالية، ويحذّر من انتهاء الوصول فورًا، ويوضح كيفية تحرك تواريخ الفوترة. يؤكد العميل باستخدام إيقاف الاشتراك مؤقتًا.
- يتوقف الوصول فورًا. تتوقف الميزات والتنزيلات ومفاتيح الترخيص المضمنة مع الاشتراك عن العمل حتى استئناف الاشتراك.
- لا يوجد تاريخ انتهاء للإيقاف المؤقت. يظل الاشتراك متوقفًا مؤقتًا حتى يستأنفه العميل.
- لا يضيع أي وقت مدفوع. يتحرك تاريخ الفوترة التالي وتاريخ التجديد إلى الأمام بمقدار مدة الإيقاف المؤقت.
active ويُستعاد الوصول.
يتحكم إعداد السماح بإيقاف الاشتراك مؤقتًا ضمن الإعدادات ← الاشتراكات في الإيقاف الذاتي، وهو متوقف افتراضيًا. أثناء إيقافه، لا يستطيع العملاء بدء إيقاف مؤقت جديد، لكن لا يزال بإمكان العميل استئناف إيقاف بدأه بنفسه. ولا تتأثر عمليات الإيقاف التي تبدأها من لوحة المعلومات.
How Pausing Works
سلوك الإيقاف المؤقت الكامل، بما في ذلك تأثيرات الفوترة وتسوية الاستخدام وwebhooks.
تحديث طرق الدفع
يغيّر العملاء طريقة دفع الاشتراك باستخدام تعديل بجوار طريقة الدفع في صفحة تفاصيل الاشتراك. وهذه هي الطريقة نفسها التي يعيد بها العميل تنشيط اشتراك موضوع قيد التعليق بعد فشل الدفع.إعادة تفعيل الاشتراكات قيد التعليق
ينتقل الاشتراك إلىon_hold عند فشل الدفع. تعرض البوابة الرسالة اشتراكك قيد التعليق حاليًا وتطلب من العميل تحديث طريقة الدفع. وعند إجراء ذلك، يقوم Dodo Payments بما يلي:
- ينشئ رسمًا بالمبالغ المتبقية
- ينشئ فاتورة للرسم
- يحصل الدفعة باستخدام طريقة الدفع الجديدة
- يعيد تنشيط الاشتراك إلى
activeعند نجاح الدفع
عند دفع مستحقات الاشتراك
on_hold، تصبح الاشتراكة active مرة أخرى.إعادة تفعيل الاشتراكات خلال فترة السماح
إذا ضبطت فترة سماح، ينقل التجديد الفاشل الاشتراك إلىpast_due بدلًا من on_hold. ويحتفظ العميل بالوصول حتى الموعد النهائي.
تعمل الاستعادة بالطريقة نفسها: يحدّث العميل طريقة الدفع، ويعود الاشتراك إلى active. وإذا لم يفعل شيئًا، ينتقل الاشتراك عند الموعد النهائي إلى on_hold أو cancelled، وفقًا لإعداداتك، وينتهي الوصول.
تدفق تحديث طريقة الدفع
1
Access Subscription Details
انقر على إدارة الاشتراك للاشتراك من نظرة عامة على البوابة.
2
Click Edit on Payment Method
انقر على تعديل بجوار طريقة الدفع.
3
Select or Add Payment Method
اختر طريقة دفع محفوظة، أو انقر على إضافة طريقة دفع وأدخل التفاصيل الجديدة.
4
Confirm Changes
أكد التحديث. بالنسبة إلى اشتراك
on_hold، ينشئ ذلك رسمًا بالمبالغ المتبقية.5
Complete Payment (If On Hold)
إذا كان الاشتراك قيد التعليق، يُعاد توجيه العميل لدفع المبالغ المتبقية. وعند نجاح الدفع، يُعاد تنشيط الاشتراك.
6
Confirmation
تؤكد البوابة تحديث طريقة الدفع، وتؤكد كذلك، بالنسبة إلى الاشتراك قيد التعليق، أنه أصبح نشطًا مجددًا.
أمثلة التكامل
لإرسال عميل من تطبيقك إلى البوابة، أنشئ جلسة بوابة على خادمك وأعد توجيه العميل إلىlink المُعاد. ويكون الرابط صالحًا لمدة 24 ساعة.
send_email: true.
Customer Portal الموحدة
إلى جانب بوابة نشاطك التجاري، يدير Dodo Payments Customer Portal موحدة على customer.dodopayments.com. وهناك يرى العملاء عمليات الشراء والاشتراكات من كل نشاط تجاري يبيع عبر Dodo Payments ويديرونها.
ميزات البوابة الموحدة
- رؤية متعددة الأنشطة التجارية: عرض عمليات الشراء والاشتراكات من كل تاجر لدى Dodo Payments في مكان واحد.
- إدارة مركزية: إدارة الاشتراكات مع أنشطة تجارية مختلفة من موقع واحد.
- سجل فوترة موحد: الوصول إلى الفواتير وسجل المدفوعات لجميع عمليات الشراء.
- تسجيل دخول واحد: تسجيل الدخول مرة واحدة باستخدام عنوان بريد إلكتروني للوصول إلى عمليات الشراء من جميع تجار Dodo Payments.
استكشاف الأخطاء وإصلاحها
- انتهت صلاحية الرابط: أنشئ رابطًا ديناميكيًا جديدًا وأرسله إلى العميل.
- البريد الإلكتروني غير معروف: اطلب من العميل استخدام عنوان البريد الإلكتروني الذي استخدمه عند الشراء. ولا تُرسل رسالة تسجيل دخول إلى عنوان لا يخص عميلًا لدى نشاطك التجاري.
- الاشتراك قيد التعليق: يحدّث العميل طريقة الدفع في البوابة. ويحصل Dodo Payments على المبالغ المتبقية ويعيد تنشيط الاشتراك عند نجاح الدفع.
- فشل تحديث طريقة الدفع: إذا فشل الدفع أثناء تحديث اشتراك
on_hold، يظل الاشتراك قيد التعليق. ويمكن للعميل إعادة المحاولة باستخدام طريقة دفع مختلفة.
Design & Theme Customization
خصّص البوابة باستخدام السمات والطباعة والألوان الجاهزة، مع معاينة مباشرة، من صفحة التصميم.