لمحة عن الاشتراكات

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

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

نظرة عامة على الاشتراكات

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

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

للحصول على نظرة عامة مفصّلة على المنتجات المتوفّرة عند الاشتراك والخطط الأساسية والعروض الترويجية، يُرجى الاطّلاع على المستندات في مركز مساعدة Play Console.

تتيح Play Billing Library أنواع الاشتراكات التالية:

  • الاشتراك: في هذا النوع، يتوافق عنصر واحد مع امتياز واحد. على سبيل المثال، الاشتراك في خدمة بث موسيقى.

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

دمج خطط الدفع المُسبَق

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

بالنسبة إلى عمليات زيادة الرصيد، يمكنك بدء مسار الفوترة كما تفعل في عملية الشراء الأصلية. ليس عليك الإشارة إلى أنّ عملية الشراء هي عملية زيادة رصيد.

تستخدم عمليات إضافة الرصيد في خطط الدفع المُسبق دائمًا وضع الاستبدال CHARGE_FULL_PRICE، وليس عليك ضبط هذا الوضع بشكل صريح. يتم تحصيل رسوم من المستخدم على الفور مقابل مدة فوترة كاملة، ويتم تمديد فترة الاستحقاق بالمدة المحدّدة في عملية زيادة الرصيد.

بعد إضافة رصيد، يتم تعديل الحقول التالية في Purchase كائن النتيجة لتعكس أحدث عملية شراء لإضافة رصيد:

  • مُعرّف الطلب
  • وقت الشراء
  • التوقيع
  • الرمز المميز للشراء
  • مواضيع تمت الموافقة عليها

تحتوي حقول Purchase التالية دائمًا على البيانات نفسها المتوفّرة في عملية الشراء الأصلية:

  • اسم الحزمة
  • حالة الشراء
  • المنتجات
  • تجديد تلقائي

إقرار الشراء بنظام الدفع المُسبَق

على غرار الاشتراكات التي يتم تجديدها تلقائيًا، يجب تأكيد خطط الدفع المُسبَق بعد الشراء. يجب تأكيد كل من عملية الشراء الأولية وأي عمليات تعبئة رصيد. لمزيد من المعلومات، يُرجى الاطّلاع على معالجة عمليات الشراء.

نظرًا لاحتمال قِصر مدة خطط الدفع المُسبَق، من المهم تأكيد عملية الشراء في أقرب وقت ممكن.

يجب تأكيد خطط الدفع المُسبَق التي تبلغ مدتها أسبوعًا أو أكثر خلال ثلاثة أيام.

يجب إرسال إشعار باستلام خطط الدفع المُسبَق التي تقل مدتها عن أسبوع خلال نصف مدة الخطة. على سبيل المثال، لدى المطوّرين يوم ونصف لإقرار خطة دفع مُسبَق مدتها ثلاثة أيام.

دمج الاشتراكات بنظام الأقساط

الاشتراك بالتقسيط هو نوع من الاشتراكات يدفع فيه المستخدمون رسوم الاشتراك على أقساط متعددة على مدار فترة زمنية، بدلاً من دفع رسوم الاشتراك بالكامل مقدمًا.

اعتبارات إضافية للاشتراكات بالتقسيط:

  • توفُّر الميزة في البلدان: لا تتوفّر ميزة "الاشتراكات بالتقسيط" إلا في البرازيل وفرنسا وإيطاليا وإسبانيا (يُرجى مراجعة Console لمعرفة آخر المعلومات حول توفُّر الميزة).
  • تحديد السعر: عند تحديد سعر اشتراك بنظام التقسيط في Play Console، يمثّل السعر قيمة الدفعة الشهرية. يؤدي ذلك، بالإضافة إلى مدة الالتزام المحدّدة، إلى إنشاء المبلغ الإجمالي للاشتراك في شاشة الشراء.
  • مدة الالتزام: إجمالي مدة الالتزام بالاشتراك الأولي، والتي يجب خلالها تسديد الدفعات الشهرية. على سبيل المثال، إذا كانت الخطة الأساسية تتضمّن مدة التزام تبلغ 15 شهرًا، سيسدّد المستخدم 15 دفعة شهرية خلال هذه الفترة.
  • عمليات التجديد: في سياق الاشتراكات بالتقسيط، يشير "التجديد" إلى انتهاء مدة الالتزام، سواء كانت مدة الالتزام الأولية أو مدة الالتزام اللاحقة. بعد الاشتراك الأولي، يتم التجديد الأول بعد انتهاء مدة الالتزام الأولية بالكامل. وتتم عمليات التجديد اللاحقة بعد استيفاء كل مدة التزام لاحقة. يمكن أن تكون أنواع التجديد للاشتراكات بالتقسيط "تجديد تلقائي شهريًا" أو "تجديد تلقائي للمدة نفسها". بالنسبة إلى "التجديد التلقائي شهريًا"، لا يوجد التزام لاحق وتعمل الخطة مثل الاشتراك الشهري حيث تشكّل كل رسوم اشتراك شهرية تجديدًا.
  • مدة الفوترة: في سياق الاشتراكات بنظام الأقساط، يشير هذا المصطلح إلى الفترة الزمنية المتكرّرة التي يتم فيها تسديد الدفعات الفردية، كما هو محدّد في الخطة الأساسية.
  • سلوكيات تغيير الخطة مقابل تغيير السعر: بالنسبة إلى تغييرات الأسعار وعمليات الإلغاء، يكون الالتزام ثابتًا. هذا يعني أنّه إذا أراد المستخدم إلغاء الاشتراك أو أراد المطوّر تغيير السعر، فإنّ التغيير يسري في نهاية مدة الالتزام. بالنسبة إلى تغييرات الخطة، لا يكون الالتزام ثابتًا. يعني ذلك أنّ تغيير الخطة لا يتطلّب الانتظار حتى نهاية مدة الالتزام، بل يسري إما على الفور أو في تاريخ الدفع التالي استنادًا إلى وضع الاستبدال المحدّد.
  • تغيير الخطة ضمن الاشتراك نفسه: لا يُسمح بتغيير الخطة من خطة أساسية بنظام الأقساط إلى خطة أساسية لا تعتمد على نظام الأقساط ضمن المنتج نفسه المتوفّر عند الاشتراك.
  • الإشعارات في الوقت الفعلي الخاصة بالمطوّرين (RTDN): يتم إرسال SUBSCRIPTION_CANCELLATION_SCHEDULEDإشعار في الوقت الفعلي خاص بالمطوّرين فورًا عند إلغاء المستخدم للاشتراك في حال تبقّي دفعات خلال مدة الالتزام. عملية الإلغاء في انتظار المراجعة ولن تسري إلا في نهاية مدة الالتزام. بعد ذلك، إذا لم يستعِد المستخدم الاشتراك، يتم إرسال إشعارات RTDN من النوع SUBSCRIPTION_CANCELED وSUBSCRIPTION_EXPIRED في نهاية مدة الالتزام.

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

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

  • توفُّر Play Billing Library: لا يتوفّر الحقل installmentDetails إلا في الإصدار 7 من Play Billing Library أو الإصدارات الأحدث. بالنسبة إلى الإصدار 5 من PBL والإصدارات الأحدث، يتم عرض اشتراك الدفع بالتقسيط باستخدام queryProductDetails()، ولكن لن يتضمّن الاشتراك معلومات مفصّلة عن الدفع بالتقسيط، مثل عدد الدفعات الملتزم بها في الخطة.

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

يجب أن يتضمّن تطبيقك رابطًا في شاشة الإعدادات أو الإعدادات المفضّلة يتيح للمستخدمين إدارة اشتراكاتهم، ويمكنك دمج هذا الرابط في المظهر والأسلوب الطبيعيَّين لتطبيقك.

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

استخدِم عنوان URL التالي لتوجيه المستخدمين إلى الصفحة التي تعرض جميع اشتراكاتهم، كما هو موضّح في الشكلَين 1 و2:

https://play.google.com/store/account/subscriptions
تعرض شاشة الاشتراكات في "متجر Google Play" حالة جميع اشتراكات المستخدم التي تتم فوترتها من خلال Google Play.
الشكل 1: تعرض شاشة الاشتراكات في "متجر Google Play" حالة جميع اشتراكات المستخدم التي تتم فوترتها من خلال Google Play.


انقر على اشتراك للاطّلاع على تفاصيل إضافية.
الشكل 2. انقر على اشتراك للاطّلاع على تفاصيل إضافية.

يمكن أن يكون هذا الرابط العميق مفيدًا لمساعدة المستخدم في استعادة اشتراك تم إلغاؤه من مركز الاشتراكات في "متجر Google Play".

لإنشاء رابط مباشر إلى صفحة إدارة اشتراك غير منتهي الصلاحية، يجب تحديد اسم الحزمة ورمز productId المرتبط بالاشتراك الذي تم شراؤه. لتحديد productId برمجيًا لاشتراك حالي، يمكنك الاستعلام عن الخلفية في تطبيقك أو طلب BillingClient.queryPurchasesAsync() للحصول على قائمة بالاشتراكات المرتبطة بمستخدم معيّن. يحتوي كل اشتراك على productId المقابل كجزء من معلومات حالة الاشتراك. يحتوي كل عنصر SubscriptionPurchaseLineItem مرتبط بعملية شراء اشتراك على قيمة productId المرتبطة بالاشتراك الذي اشتراه المستخدم في هذا البند.

استخدِم عنوان URL التالي لتوجيه المستخدمين إلى شاشة إدارة اشتراك معيّنة، مع استبدال "your-sub-product-id" و "your-app-package" بـ productId واسم حزمة التطبيق على التوالي:

https://play.google.com/store/account/subscriptions?sku=your-sub-product-id&package=your-app-package

بعد ذلك، يمكن للمستخدم إدارة طُرق الدفع والوصول إلى الميزات، بما في ذلك الإلغاء وإعادة الاشتراك والإيقاف المؤقت.

السماح للمستخدمين بترقية اشتراكهم أو الرجوع إلى إصدار سابق أو تغيير اشتراكهم

يمكنك تزويد المشتركين الحاليين بخيارات متنوّعة لتغيير خطة الاشتراك بما يتناسب مع احتياجاتهم:

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

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

يعرض الشكل 3 مثالاً لتطبيق يتضمّن ثلاث خطط مختلفة:

يحتوي هذا التطبيق على ثلاثة مستويات اشتراك.
الشكل 3. يوفّر هذا التطبيق ثلاثة مستويات للاشتراك.

يمكن أن يعرض تطبيقك شاشة مشابهة للشكل 3، ما يمنح المستخدمين خيارات لتغيير اشتراكهم. وفي جميع الحالات، يجب أن يكون واضحًا للمستخدمين ما هي خطة الاشتراك الحالية وما هي الخيارات المتاحة لهم لتغييرها.

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

أوضاع الاستبدال

يسرد الجدول التالي أوضاع الاستبدال المتاحة وأمثلة على الاستخدام، وعدد الدفعات التي تم اعتبارها مدفوعة.

وضع الاستبدال

الوصف

مثال للاستخدام

الدفعات الملتزم بها المسجّلة على أنّها مدفوعة (لاستبدال الاشتراك بالتقسيط)

WITH_TIME_PRORATION

تتم ترقية منتج الاشتراك أو الرجوع إلى إصدار سابق منه على الفور. ويتم تعديل أي وقت متبقٍّ استنادًا إلى فرق السعر، ويُضاف إلى الاشتراك الجديد من خلال تقديم تاريخ الفوترة التالي. وهذا هو الإعداد التلقائي.

الترقية إلى فئة أعلى سعرًا بدون أي دفعة إضافية فورية

0

CHARGE_PRORATED_PRICE

تتم ترقية منتج الاشتراك على الفور، وتبقى دورة الفوترة كما هي. بعد ذلك، يتم تحصيل فرق السعر عن الفترة المتبقية من المستخدم.

ملاحظة: يتوفّر هذا الخيار فقط عند ترقية عنصر اشتراك، حيث يرتفع السعر لكل وحدة زمنية.

الترقية إلى فئة أعلى سعرًا بدون تغيير تاريخ الفوترة

1

CHARGE_FULL_PRICE

تتم ترقية منتج الاشتراك أو الرجوع إلى إصدار سابق منه على الفور، ويتم تحصيل السعر الكامل من المستخدم مقابل إذن استخدام المنتج الجديد على الفور. ويتم إما ترحيل القيمة المتبقية من الاشتراك السابق إلى الميزة نفسها أو تقسيمها بالتناسب مع الوقت عند التبديل إلى ميزة مختلفة.

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

الترقية من مدة فوترة أقصر إلى مدة فوترة أطول

‫1 (ملاحظة: 0 إذا كان الاشتراك الجديد يتضمّن فترة تجريبية مجانية)

WITHOUT_PRORATION

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

يمكنك الترقية إلى فئة اشتراك أعلى مع الاحتفاظ بأي فترة مجانية متبقية.

0

DEFERRED

لا تتم ترقية عنصر الاشتراك أو الرجوع إلى إصدار سابق منه إلا عند تجديد الاشتراك، ولكن يتم إصدار عملية الشراء الجديدة على الفور مع العنصرَين التاليَين:

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

ملاحظة: بالنسبة إلى الاشتراكات بالتقسيط، يتم تغيير الخطة في بداية تاريخ الدفعة التالية.

الاشتراك في مستوى أقل تكلفة

1

KEEP_EXISTING

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

إضافة عنصر اشتراك أو إزالته من اشتراك يتضمّن ميزات إضافية عندما يجب عدم تغيير عنصر معيّن

لا ينطبق

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

ضبط وضع الاستبدال لعملية شراء

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

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

يمكنك تحديد وضع استبدال تلقائي في Google Play Console. يتيح لك هذا الإعداد اختيار متى يتم تحصيل الرسوم من المشتركين الحاليين إذا اشتروا خطة أساسية أو عرضًا ترويجيًا مختلفين للاشتراك نفسه أو أعادوا الاشتراك بعد إلغائه. الخيارات المتاحة هي التحصيل الفوري، وهو ما يعادل CHARGE_FULL_PRICE، والتحصيل في تاريخ الفوترة التالي، وهو ما يعادل WITHOUT_PRORATION. هذه هي أوضاع الاستبدال الوحيدة ذات الصلة عند التبديل بين الخطط الأساسية ضمن الاشتراك نفسه.

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

التبديل بين الخطط في الاشتراكات أو إلغاء وضع الاستبدال التلقائي

إذا كان المستخدم يغيّر منتجات الاشتراك، أي يشتري اشتراكًا مختلفًا، أو إذا أردت إلغاء وضع الاستبدال التلقائي لأي سبب، يمكنك تحديد معدّل التناسب أثناء التشغيل كجزء من مَعلمات مسار الشراء.

لتقديم ReplacementMode بشكل صحيح في SubscriptionProductReplacementParams أو SubscriptionUpdateParams كجزء من إعداد مسار الشراء في وقت التشغيل، يُرجى مراعاة القيود التالية:

  • عند الترقية أو الرجوع إلى إصدار سابق أو بدء تبديل الاشتراك نفسه إلى خطة دفع مُسبَق من خطة دفع مُسبَق أو خطة تجديد الخطة تلقائيًا أو خطة تقسيط، يكون وضع الاستبدال الوحيد المسموح به هو CHARGE_FULL_PRICE. في حال تحديد أي وضع استبدال آخر، ستتعذّر عملية الشراء وسيظهر خطأ للمستخدم.
  • عند تبديل الخطط ضمن الاشتراك نفسه إلى خطة تجديد تلقائي من خطة دفع مُسبَق أو خطة تجديد تلقائي، تكون أوضاع التناسب الصالحة هي CHARGE_FULL_PRICE وWITHOUT_PRORATION. في حال تحديد أي وضع آخر للنسبة والتناسب، ستفشل عملية الشراء وسيظهر خطأ للمستخدم.
  • لا يُسمح بالتبديل بين الخطط ضمن منتَج متوفّر عند الاشتراك نفسه من خطة أساسية بنظام الأقساط إلى خطة أساسية لا تتضمّن أقساطًا.
  • عند استخدام وضع الاستبدال "KEEP_EXISTING" في "SubscriptionProductReplacementParams" لإبقاء دفعة المنتج بدون تغيير أثناء الاستبدال، يجب أن يكون معرّف المنتج القديم هو نفسه معرّف المنتج الجديد. وضع "KEEP_EXISTING" غير متاح في SubscriptionUpdateParams.

أمثلة على الاستبدال والسلوكيات

لفهم آلية عمل كل وضع من أوضاع التناسب، فكِّر في السيناريو التالي:

لدى "سامح" اشتراك في محتوى على الإنترنت من تطبيق "البستاني". لديه اشتراك شهري في إصدار المستوى 1 من المحتوى، وهو نصي فقط. تبلغ تكلفة الاشتراك دولارَين شهريًا، ويتم تجديده في اليوم الأول من الشهر.

في 15 أبريل، اختار سامح الترقية إلى الإصدار السنوي من اشتراك المستوى 2، والذي يتضمّن تحديثات الفيديو وتبلغ تكلفته 36 دولار أمريكي في السنة.

عند ترقية الاشتراك، يختار المطوّر وضع التناسب. توضّح القائمة التالية تأثير كل وضع من أوضاع التناسب في اشتراك "سامح":

WITH_TIME_PRORATION

ينتهي اشتراك "سامح" في المستوى 1 على الفور. بما أنّه دفع مقابل شهر كامل (من 1 إلى 30 أبريل) ولكنّه أجرى الترقية في منتصف فترة الاشتراك، سيتم تطبيق نصف قيمة الاشتراك الشهري (دولار أمريكي واحد) على اشتراكه الجديد. ومع ذلك، نظرًا لأنّ تكلفة الاشتراك الجديد تبلغ 36 دولارًا أمريكيًا في السنة، فإنّ الرصيد المتوفّر الذي يبلغ دولارًا أمريكيًا واحدًا يغطي تكلفة 10 أيام فقط (من 16 إلى 25 أبريل). لذلك، في 26 أبريل، يتم تحصيل 36 دولارًا أمريكيًا منه مقابل اشتراك جديد و36 دولارًا أمريكيًا آخر في 26 أبريل من كل عام تالٍ.

يجب استدعاء PurchasesUpdatedListener في تطبيقك فور نجاح عملية الشراء، ويمكنك استرداد عملية الشراء الجديدة كجزء من استدعاء queryPurchasesAsync(). يتلقّى الخلفية على الفور إشعارًا في الوقت الفعلي خاصًا بالمطوّرين من النوع SUBSCRIPTION_PURCHASED.

CHARGE_PRORATED_PRICE

يمكن استخدام هذا الوضع لأنّ سعر الاشتراك في المستوى 2 لكل وحدة زمنية (36 دولار أمريكي في السنة = 3 دولار أمريكي في الشهر) أكبر من سعر الاشتراك في المستوى 1 لكل وحدة زمنية (2 دولار أمريكي في الشهر). ينتهي اشتراك "سامح" في المستوى 1 على الفور. وبما أنّه دفع مقابل شهر كامل ولكنه استخدم نصفه فقط، يتم تطبيق نصف اشتراك الشهر (دولار أمريكي واحد) على اشتراكه الجديد. ومع ذلك، بما أنّ تكلفة الاشتراك الجديد تبلغ 36 دولار أمريكي في السنة، فإنّ تكلفة الـ 15 يومًا المتبقية تبلغ 1.50 دولار أمريكي، وبالتالي يتم تحصيل الفرق الذي يبلغ 0.50 دولار أمريكي مقابل اشتراكه الجديد. في 1 مايو، يتم تحصيل 36 دولار أمريكي من "سامح" مقابل فئة الاشتراك الجديدة، ويتم تحصيل 36 دولار أمريكي أخرى في 1 مايو من كل عام تالٍ.

يجب استدعاء PurchasesUpdatedListener في تطبيقك فور نجاح عملية الشراء، ويمكنك استرداد عملية الشراء الجديدة كجزء من استدعاء queryPurchasesAsync(). يتلقّى الخلفية على الفور إشعارًا في الوقت الفعلي خاصًا بالمطوّرين (SUBSCRIPTION_PURCHASED).

WITHOUT_PRORATION

تتم ترقية اشتراك "سامح" من المستوى 1 إلى المستوى 2 على الفور بدون أي رسوم إضافية، وفي 1 مايو، يتم تحصيل 36 دولار أمريكي منه مقابل مستوى الاشتراك الجديد، و36 دولار أمريكي أخرى في 1 مايو من كل عام تالٍ.

يجب استدعاء PurchasesUpdatedListener في تطبيقك فور نجاح عملية الشراء، ويمكنك استرداد عملية الشراء الجديدة كجزء من استدعاء queryPurchasesAsync(). يتلقّى الخلفية على الفور إشعارًا في الوقت الفعلي خاصًا بالمطوّرين (SUBSCRIPTION_PURCHASED).

DEFERRED

يستمر اشتراك "سامح" في المستوى 1 إلى أن تنتهي صلاحيته في 30 أبريل. في 1 مايو، يبدأ سريان اشتراك المستوى 2، ويتم تحصيل 36 دولار أمريكي من "سامح" مقابل مستوى اشتراكه الجديد.

يجب استدعاء PurchasesUpdatedListener في تطبيقك فور نجاح عملية الشراء، ويمكنك استرداد عملية الشراء الجديدة كجزء من استدعاء queryPurchasesAsync(). يتلقّى الخلفية على الفور إشعارًا في الوقت الفعلي خاصًا بالمطوّرين من النوع SUBSCRIPTION_PURCHASED. يجب معالجة عملية الشراء بالطريقة نفسها التي تتم بها معالجة أي عملية شراء جديدة أخرى في ذلك الوقت. وعلى وجه الخصوص، تأكَّد من إقرارك بعملية الشراء الجديدة. يُرجى العِلم أنّ startTime للاشتراك الجديد تتم تعبئته في وقت سريان الاستبدال، أي عند انتهاء صلاحية الاشتراك القديم. في هذه المرحلة، ستتلقّى إشعارًا في الوقت الفعلي للمشتركين (RTDN) من النوع SUBSCRIPTION_RENEWED بشأن خطة الاشتراك الجديدة. يمكنك الاطّلاع على مزيد من المعلومات حول سلوك ReplacementMode.DEFERRED في مقالة التعامل مع الاستبدال المؤجَّل.

CHARGE_FULL_PRICE

ينتهي اشتراك "سامح" في المستوى 1 على الفور. يبدأ اشتراكه في المستوى 2 اليوم ويتم تحصيل 36 دولار أمريكي منه. بما أنّه دفع مقابل شهر كامل ولكنّه استخدم نصفه فقط، سيتم تطبيق نصف قيمة الاشتراك الشهري (دولار أمريكي واحد) على اشتراكه الجديد. وبما أنّ تكلفة الاشتراك الجديد تبلغ 36 دولار أمريكي في السنة، سيحصل على 1/36 من السنة تضاف إلى فترة اشتراكه (حوالي 10 أيام). وبالتالي، سيتم تحصيل الرسوم التالية من "سامح" بعد عام و10 أيام من اليوم بقيمة 36 دولار أمريكي. بعد ذلك، يتم تحصيل 36 دولارًا أمريكيًا منه كل عام تالٍ.

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

KEEP_EXISTING

لدى سامي اشتراك في المحتوى على الإنترنت من تطبيق "البستاني". لديه اشتراك شهري في الخطة 1 للمحتوى الأساسي. تبلغ تكلفة هذا الاشتراك سعرًا تمهيديًا قدره 2 دولار أمريكي شهريًا لمدة 3 أشهر، ثم 4 دولارات أمريكية شهريًا. اشترى "سام" هذا المنتج في 1 أبريل. يقدّم تطبيق Country Gardener الخطة 2 كمحتوى متخصص إضافي مقابل 3 دولارات أمريكية شهريًا. في 15 أبريل، أضاف سامح الخطة 2 إلى اشتراكه في تطبيق "البستاني" مع الاحتفاظ بالخطة 1 الحالية. جدول الدفع في Samwise هو كالتالي:

  • سعر نسبي بقيمة 1.50 دولار أمريكي لـ "الخطة 2"، مستحق في 15 أبريل.
  • سعر 5.00 دولار أمريكي شهريًا للشهرَين التاليَين يشمل كلاً من السعر التمهيدي لـ "الخطة 1" والسعر العادي لـ "الخطة 2".
  • بعد ذلك، سيتم تحصيل دفعة شهرية ثابتة بقيمة 7.00 دولار أمريكي.

تفعيل تغييرات الاشتراك داخل التطبيق

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

استخدام SubscriptionProductReplacementParams للاستبدال (مُفضَّل)

يوضّح المثال التالي كيفية تعديل اشتراك باستخدام SubscriptionProductReplacementParams.

  • يحتوي عنصر BillingFlowParams.ProductDetailsParams الآن على طريقة setSubscriptionProductReplacementParams() لتحديد معلومات الاستبدال على مستوى المنتج.

  • تتضمّن السمة SubscriptionProductReplacementParams طريقتَين للضبط:

    • setOldProductId:هذا هو المنتج القديم الذي سيتم استبداله بالمنتج في ProductDetails. الحالي
    • setReplacementMode:هذا هو وضع الاستبدال على مستوى السلعة. تتشابه الأوضاع بشكل أساسي مع SubscriptionUpdateParams، ولكن تم تعديل عملية ربط القيم.
  • يجب إنشاء مَعلمات تعديل مستوى الشراء الحالية BillingFlowParams.setSubscriptionUpdateParams() باستخدام setOldPurchaseToken().

  • بعد استدعاء setSubscriptionProductReplacementParams() لأي من ProductDetailsParams، لن يكون لـ SubscriptionUpdateParams.setSubscriptionReplacementMode() أي تأثير.

توضّح عينة التعليمات البرمجية التالية كيفية تغيير خطة اشتراك من (old_product_1، old_product_2) إلى (product_1، product_2، product_3). في هذا السيناريو، يحلّ product_1 محلّ old_product_1، ويحلّ product_2 محلّ old_product_2، وتتم إضافة product_3 إلى الاشتراك على الفور.

Kotlin

val billingClient: BillingClient = this.billingClient
val replacementModeForBasePlan: Int = SubscriptionProductReplacementParams.ReplacementMode.KEEP_EXISTING
val replacementModeForAddon: Int = SubscriptionProductReplacementParams.ReplacementMode.CHARGE_PRORATED_PRICE

val purchaseTokenOfExistingSubscription: String = "your_old_purchase_token"

// ProductDetails instances obtained from queryProductDetailsAsync();

val productDetailsParams1 =
    ProductDetailsParams.newBuilder()
        .setProductDetails(productDetails1) // Required: Set the ProductDetails object
        .setSubscriptionProductReplacementParams(
            SubscriptionProductReplacementParams.newBuilder()
                .setOldProductId("old_product_id_1")
                .setReplacementMode(replacementModeForBasePlan)
                .build()
        )
        .build()

val productDetailsParams2 =
    ProductDetailsParams.newBuilder()
        .setProductDetails(productDetails2) // Required: Set the ProductDetails object
        .setSubscriptionProductReplacementParams(
            SubscriptionProductReplacementParams.newBuilder()
                .setOldProductId("old_product_id_2")
                .setReplacementMode(replacementModeForAddon)
                .build()
        )
        .build()

// Example for a third item without replacement params
val productDetailsParams3 =
    ProductDetailsParams.newBuilder()
        .setProductDetails(productDetails3) // Required: Set the ProductDetails object
        .build()

val newProductDetailsList = listOf(
    productDetailsParams1,
    productDetailsParams2,
    productDetailsParams3
)

val billingFlowParams =
    BillingFlowParams.newBuilder()
        .setSubscriptionUpdateParams(
            SubscriptionUpdateParams.newBuilder()
                .setOldPurchaseToken(purchaseTokenOfExistingSubscription)
                .build()
        )
        .setProductDetailsParamsList(newProductDetailsList)
        .build()

// To launch the billing flow:
billingClient.launchBillingFlow(activity, billingFlowParams)

Java

BillingClient billingClient = …;

int replacementModeForBasePlan =…;
int replacementModeForAddon =…;
// ProductDetails obtained from queryProductDetailsAsync().
ProductDetailsParams productDetails1 =
  ProductDetailsParams.newBuilder()
      .setSubscriptionProductReplacementParams(
           SubscriptionProductReplacementParams.newBuilder()
               .setOldProductId("old_product_id_1")
               .setReplacementMode(replacementModeForBasePlan))
               .build();
ProductDetailsParams productDetails2 =
  ProductDetailsParams.newBuilder()
      .setSubscriptionProductReplacementParams(
           SubscriptionProductReplacementParams.newBuilder()
               .setOldProductId("old_product_id_2")
               .setReplacementMode(replacementModeForAddon))
               .build();
ProductDetailsParams productDetails3 = ...;

ArrayList newProductDetailsList = new ArrayList<>();
newProductDetailsList.add(productDetails1);
newProductDetailsList.add(productDetails2);
newProductDetailsList.add(productDetails3);

BillingFlowParams billingFlowParams =
    BillingFlowParams.newBuilder()
        .setSubscriptionUpdateParams(
          SubscriptionUpdateParams.newBuilder()
              .setOldPurchaseToken(purchaseTokenOfExistingSubscription)
             .build())
        .setProductDetailsParamsList(productDetailsList)
        .build();

billingClient.launchBillingFlow(billingFlowParams);

ضبط SubscriptionUpdateParams للاستبدال (متوقّفة نهائيًا)

يوضّح المثال التالي كيفية تعديل اشتراك باستخدام SubscriptionUpdateParams.

Kotlin

val offerToken = productDetails
        .getSubscriptionOfferDetails(selectedOfferIndex)
        .getOfferToken()

val billingParams = BillingFlowParams.newBuilder().setProductDetailsParamsList(
       listOf(
           BillingFlowParams.ProductDetailsParams.newBuilder()
               .setProductDetails(productDetails)
               .setOfferToken(offerToken)
               .build()
       )
       ).setSubscriptionUpdateParams(
           BillingFlowParams.SubscriptionUpdateParams.newBuilder()
               .setOldPurchaseToken("old_purchase_token")
               .setSubscriptionReplacementMode(
                 BillingFlowParams.ReplacementMode.CHARGE_FULL_PRICE
               )
               .build()
       ).build()

billingClient.launchBillingFlow(
    activity,
    billingParams
   )
// ...

Java

String offerToken = productDetails
    .getSubscriptionOfferDetails(selectedOfferIndex)
    .getOfferToken();

BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
    .setProductDetailsParamsList(
        ImmuableList.of(
            ProductDetailsParams.newBuilder()
                // fetched using queryProductDetailsAsync
                .setProductDetails(productDetails)
                // offerToken can be found in
                // ProductDetails=>SubscriptionOfferDetails
                .setOfferToken(offerToken)
                .build()))
    .setSubscriptionUpdateParams(
        SubscriptionUpdateParams.newBuilder()
            // purchaseToken can be found in Purchase#getPurchaseToken
            .setOldPurchaseToken("old_purchase_token")
            .setSubscriptionReplacementMode(ReplacementMode.CHARGE_FULL_PRICE)
            .build())
    .build();

BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams);
// ...

اقتراحات الاستبدال

يعرض الجدول التالي سيناريوهات مختلفة للتقسيم النسبي مع ما نوصي به لكل سيناريو:

السيناريو وضع الاستبدال المقترَح النتيجة
الترقية إلى فئة أعلى سعرًا CHARGE_PRORATED_PRICE يحصل المستخدم على إذن الوصول على الفور مع الاحتفاظ بمدة الفوترة نفسها.
الاشتراك في مستوى أقل تكلفة DEFERRED لقد دفع المستخدم بالفعل مقابل الفئة الأعلى سعرًا، لذا سيظل بإمكانه الاستفادة من مزايا الاشتراك حتى تاريخ الفوترة التالي.
الترقية أثناء الفترة التجريبية المجانية مع الاحتفاظ بها WITHOUT_PRORATION يرقّي المستخدم اشتراكه إلى فئة أعلى للفترة المتبقية من الفترة التجريبية بدون أي رسوم إضافية.
الترقية أثناء الفترة التجريبية المجانية - إنهاء الوصول إلى الفترة التجريبية المجانية CHARGE_PRORATED_PRICE يحصل المستخدم على إمكانية الوصول إلى المستوى الجديد على الفور، ويتم ترحيل القيمة المتبقية من الفترة التجريبية المجانية. يتم احتساب القيمة المُرحَّلة استنادًا إلى سعر الخطة الأساسية.
الحفاظ على جدول الدفع لبعض عناصر الاشتراك بدون تغيير أثناء إضافة عناصر اشتراك أخرى أو إزالتها من الاشتراك الذي يتضمّن ميزات إضافية KEEP_EXISTING يواصل المستخدم دفع السعر القديم مقابل المنتج الذي لم يتغيّر. تتم إضافة العناصر الجديدة على الفور. يمكن استبدال العناصر القديمة الأخرى من خلال تحديد وضع الاستبدال أو إزالتها.

التعامل مع عمليات شراء تغيير الاشتراك

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

ويكون السلوك داخل التطبيق مماثلاً لأي عملية شراء جديدة. يتلقّى تطبيقك نتيجة عملية الشراء الجديدة في PurchasesUpdatedListener، وتتوفّر عملية الشراء الجديدة في queryPurchasesAsync.

تعرض واجهة Google Play Developer API القيمة linkedPurchaseToken في مورد الاشتراك عندما تحل عملية شراء محل عملية شراء حالية. يمكنك الاطّلاع على itemReplacement ضمن SubscriptionPurchaseLineItem في عملية الشراء الجديدة لفهم تفاصيل الاستبدال على مستوى السلعة. بالإضافة إلى ذلك، يمكنك استخدام حقل offerPhase لتحديد مرحلة العرض الحالي (مثل فترة التناسب أو الفترة التجريبية المجانية) للاشتراك الجديد من أجل تقديم تجارب مخصّصة للمستخدمين. يُرجى التأكّد من إبطال الرمز المميّز المقدَّم في linkedPurchaseToken لضمان عدم استخدام الرمز المميّز القديم للوصول إلى خدماتك. يمكنك الاطّلاع على الترقيات والاشتراكات الأقل مستوى وإعادة الاشتراك للحصول على معلومات حول التعامل مع عمليات شراء الترقيات والاشتراكات الأقل مستوى.

عند تلقّي الرمز المميّز الجديد للشراء، اتّبِع عملية التحقّق نفسها التي اتّبعتها للتحقّق من رمز مميّز جديد للشراء. تأكَّد من إقرار عمليات الشراء هذه باستخدام BillingClient.acknowledgePurchase() من Google Play Billing Library أو Purchases.subscriptions:acknowledge من Google Play Developer API.

التعامل مع الاستبدال المؤجَّل

يتيح لك وضع الاستبدال المؤجَّل السماح للمستخدم باستهلاك المزايا المتبقية في خطته القديمة قبل بدء الخطة الجديدة.

عند استخدام ReplacementMode.DEFERRED لعملية شراء جديدة، تعرض السمة queryPurchasesAsync() رمزًا مميزًا جديدًا لعملية الشراء بعد مسار الشراء الذي يظل مرتبطًا بالمنتج القديم إلى أن يتم الاستبدال المؤجَّل في تاريخ التجديد التالي، وبعد ذلك يتم عرض المنتج الجديد.

في السابق، كان بإمكانك توفير تجربة المستخدم هذه من خلال واجهة برمجة التطبيقات ProrationMode.DEFERRED التي تم إيقافها نهائيًا، ولكن تم إيقاف ProrationMode.DEFERRED نهائيًا مع الإصدار 6 من Play Billing Library. اطّلِع على الجدول التالي لمعرفة أوجه الاختلاف في السلوك:

الوقت

‫ProrationMode.DEFERRED (متوقّفة نهائيًا)

ReplacementMode.DEFERRED

بعد نجاح مسار الشراء مباشرةً (التطبيق)

يتم استدعاء PurchasesUpdatedListener بعد الشراء مع حالة توضّح ما إذا كانت الترقية أو الرجوع إلى إصدار سابق قد تم بنجاح.

ويستمر حق الاستفادة من الخطة القديمة حتى تاريخ التجديد التالي. لضمان منح التطبيق الإذن الصحيح، تعرض واجهة برمجة التطبيقات queryPurchasesAsync() عنصر شراء يتضمّن رمز الشراء المميّز الأصلي والإذن الأصلي إلى أن تتم عملية الاستبدال.

لا يظهر رمز الشراء المميّز الجديد، لذا لا يمكن معالجته في هذه المرحلة.

يتم استدعاء PurchasesUpdatedListener بعد الشراء مع حالة توضّح ما إذا كانت الترقية أو الرجوع إلى إصدار سابق قد تم بنجاح.

تعرض واجهة برمجة التطبيقات queryPurchasesAsync() عملية الشراء باستخدام رمز الشراء الجديد على الفور، والامتياز الأصلي المرتبط بها.

يظهر الرمز المميّز الجديد للشراء، لذا يجب معالجته في هذه المرحلة مع مراعاة وقت الاستبدال.

بعد نجاح مسار الشراء مباشرةً (في الخلفية)

لا يتم إرسال إشعار RTDN من النوع SUBSCRIPTION_PURCHASED بعد مسار الشراء. لم يتم إعلام الخلفية بعملية الشراء الجديدة بعد.

يتم إرسال إشعار SUBSCRIPTION_PURCHASED RTDN مع معرّف product_id القديم فورًا بعد مسار الشراء لرمز الشراء المميّز الجديد.

يؤدي استدعاء طريقة purchases.subscriptionsv2.get باستخدام الرمز المميّز الجديد لعملية الشراء إلى عرض عملية شراء تتضمّن startTime يشير إلى وقت الشراء مع بندَين:

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

يتم إرسال SUBSCRIPTION_EXPIRED لرمز الشراء القديم. عند طلب طريقة purchases.subscriptionsv2.get باستخدام رمز الشراء القديم، سيظهر على أنّه منتهي الصلاحية (يتم نقل حق استخدام الخطة القديمة إلى عملية الشراء الجديدة للمدة المتبقية).

عند الاستبدال - التجديد الأول بعد مسار الشراء (التطبيق)

تعرض الدالة queryPurchasesAsync() عنصر شراء جديدًا يتضمّن الرمز المميّز للشراء الجديد وحق الاستخدام.

يظهر الآن رمز الشراء المميّز الجديد، لذا يجب معالجته.

تعرض واجهة برمجة التطبيقات queryPurchasesAsync() عملية الشراء باستخدام الرمز المميّز الجديد لعملية الشراء على الفور، والاستحقاق الجديد المرتبط بها.

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

عند الاستبدال - التجديد الأول بعد مسار الشراء (الخلفية)

يمكن الآن معالجة عملية الشراء الجديدة وتأكيدها عند إرسال أول إشعار RTDN من النوع SUBSCRIPTION_RENEWED.

يمكن استخدام linkedPurchaseToken في مورد الاشتراك لتحديد المستخدم الذي يجب تعديل اشتراكه في الخلفية، إن أمكن، ليشمل الميزة الجديدة.

تمت معالجة عملية الشراء الجديدة والإقرار بها عند إرسال إشعار RTDN من النوع SUBSCRIPTION_PURCHASED لرمز الشراء الجديد وتسجيله على أنّه startTime.

باستخدام ReplacementMode.DEFERRED، تتّبع عمليات التجديد الأولى السلوك العادي لأي عملية تجديد أخرى، ولن تحتاج إلى التعامل مع منطق خاص لعمليات الاستبدال عند حدوث هذا الحدث.

عند طلب طريقة purchases.subscriptionsv2.get باستخدام الرمز المميّز الجديد للشراء، يتم عرض عملية شراء تتضمّن عنصرَين:

  • يمثّل أحدهما الاستحقاق القديم، مع ضبط `expiryTime` على وقت في الماضي وعدم ضبط قيمة لسمة DeferredItemReplacement.
  • أحدهما يمثّل الاستحقاق الجديد، مع ضبط `expiryTime` في المستقبل وتفعيل علامة auto_renewing_enabled.

يجب استخدام ReplacementMode.DEFERRED من الآن فصاعدًا بدلاً من ProrationMode.DEFERRED الذي تم إيقافه نهائيًا، لأنّه يقدّم السلوك نفسه في ما يتعلّق بتغييرات أذونات الوصول، ولكنّه يوفّر طريقة لإدارة عملية الشراء تكون أكثر اتساقًا مع سلوكيات عمليات الشراء الجديدة الأخرى.

إدارة العملاء

باستخدام الإشعارات في الوقت الفعلي الخاصة بالمطوّرين، يمكنك رصد قرار المستخدم بإلغاء الاشتراك في الوقت الفعلي. عندما يلغي المستخدم اشتراكه، يمكنك إرسال إشعارات فورية أو رسائل داخل التطبيق إليه قبل انتهاء صلاحية اشتراكه لطلب إعادة الاشتراك.

للحدّ من عمليات الإلغاء التي تبدأ في Google Play، يمكنك ضبط عروض الاحتفاظ بالمشتركين. يعرض Google Play عرضًا ترويجيًا للاحتفاظ بالمشتركين المؤهَّلين عندما يحاولون إلغاء اشتراكهم، وإذا وافقوا على العرض، يستمر اشتراكهم بسعر مخفَّض.

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

قبل انتهاء صلاحية الاشتراك بعد انتهاء صلاحية الاشتراك
في التطبيق في "متجر Google Play" في التطبيق في "متجر Google Play"
ميزة "استعادة العملاء" اشتراك داخل التطبيق استعادة اشتراك داخل التطبيق إعادة الاشتراك
ينتقل المستخدم إلى مسار الدفع نعم لا نعم نعم
يظل اشتراك المستخدم مرتبطًا برقم SKU نفسه يمكن للمستخدم الاشتراك في رمز التخزين التعريفي نفسه أو رمز مختلف نعم يمكن للمستخدم الاشتراك في رمز التخزين التعريفي نفسه أو رمز مختلف نعم
إنشاء رمز مميّز جديد للشراء نعم لا نعم نعم
مفعَّل تلقائيًا لا نعم، يجب أن يوفّر جميع المطوّرين الدعم لا

التطبيقات التي لا تستخدم الإصدار 2.0 من Billing Library أو الإصدارات الأحدث: لا

التطبيقات التي تستخدم الإصدار 2.0 من Billing Library أو الإصدارات الأحدث: نعم ويمكن للمطوّرين إيقاف هذه الميزة في Console.

عند تحصيل الرسوم من المستخدم

في حال استخدام رمز التخزين التعريفي نفسه: نهاية مدة الفوترة الحالية

في حال استخدام رمز تخزين تعريفي مختلف: يعتمد ذلك على وضع التناسب.

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

رصد التغيير في حالة الاشتراك

رابط عميق لمتجر Google Play

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

قبل انتهاء صلاحية الاشتراك - داخل التطبيق

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

في معظم الأحيان، ستحتاج إلى تقديم السعر ورمز التخزين التعريفي نفسهما للمستخدم الذي سبق له الاشتراك، على النحو التالي:

  • ابدأ عملية شراء اشتراك جديد باستخدام رمز التخزين التعريفي نفسه.
  • يحلّ الاشتراك الجديد محلّ الاشتراك القديم ويتم تجديده في تاريخ انتهاء الصلاحية نفسه. يتم وضع علامة "منتهي الصلاحية" على الاشتراك القديم على الفور.
  • على سبيل المثال، لدى "أحمد" اشتراك في تطبيق Example Music App، ومن المقرر أن تنتهي صلاحية الاشتراك في 1 أغسطس. في 10 يوليو، أعاد الاشتراك في الاشتراك الشهري بالسعر نفسه شهريًا. يتم احتساب الاشتراك الجديد بشكل نسبي مع الرصيد المتبقي، ويتم تفعيله على الفور، ويتم تجديده في 1 أغسطس.

إذا أردت تقديم سعر مختلف، مثل فترة تجريبية مجانية جديدة أو خصم لاستعادة المشتركين، يمكنك تقديم رمز تخزين تعريفي مختلف للمستخدم:

  • ابدأ الترقية أو الرجوع إلى إصدار سابق باستخدام رمز التخزين التعريفي المختلف في وضع الاستبدال WITHOUT_PRORATION.
  • يحلّ الاشتراك الجديد محلّ الاشتراك القديم ويتم تجديده في تاريخ انتهاء الصلاحية نفسه. يتم تحصيل سعر رمز التخزين التعريفي الجديد من المستخدم، بما في ذلك أي أسعار تمهيدية، في تاريخ انتهاء الصلاحية الأصلي. إذا تم إنشاء الاشتراك القديم باستخدام رقم تعريف حساب مخفي، يجب تمرير رقم التعريف نفسه إلى BillingFlowParams للترقيات والاشتراكات في خطة أدنى.
  • على سبيل المثال، لدى "أحمد" اشتراك في تطبيق Example Music App، ومن المقرر أن تنتهي صلاحية الاشتراك في 1 أغسطس. في 10 يوليو، أعاد الاشتراك في اشتراك سنوي بسعر تمهيدي. يتم تفعيل الاشتراك الجديد على الفور، ويتم تحصيل السعر التمهيدي من المستخدم في 1 أغسطس.
  • إذا قررت تضمين فترة تجريبية مجانية أو سعر تمهيدي في رمز التخزين التعريفي (SKU) لاستعادة المشتركين، فتأكَّد من أنّ المستخدم مؤهَّل من خلال إزالة العلامة من المربّع السماح بفترة تجريبية مجانية واحدة لكل تطبيق في Google Play Console، ما يمنع المستخدم من الحصول على أكثر من فترة تجريبية مجانية واحدة لكل تطبيق.

عند تلقّي الرمز المميّز للشراء، يمكنك معالجة عملية الشراء كما تفعل مع اشتراك جديد. بالإضافة إلى ذلك، تعرض واجهة Google Play Developer API القيمة linkedPurchaseToken في مورد الاشتراك. يُرجى التأكّد من إبطال الرمز المميّز المقدَّم في linkedPurchaseToken لضمان عدم استخدام الرمز المميّز القديم للوصول إلى خدماتك.

قبل انتهاء صلاحية الاشتراك - في متجر Google Play

عندما يكون الاشتراك ملغًى ولكنّه لا يزال نشطًا، يمكن للمستخدمين استعادته في مركز الاشتراكات على Google Play من خلال النقر على إعادة الاشتراك (المعروف سابقًا باسم استعادة). يؤدي ذلك إلى الاحتفاظ بالاشتراك نفسه ورمز الشراء نفسه.

قسم الاشتراكات في تطبيق &quot;متجر Google Play&quot; يعرض اشتراكًا تم إلغاؤه مع زر &quot;إعادة الاشتراك&quot;
الشكل 8 قسم "الحساب" > "الاشتراكات" في تطبيق "متجر Google Play" يعرض اشتراكًا تم إلغاؤه مع زر إعادة الاشتراك.

لمزيد من المعلومات حول استعادة الاشتراكات، يُرجى الاطّلاع على عمليات الاستعادة.

بعد انتهاء صلاحية الاشتراك - داخل التطبيق

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

  • لتقديم خصم للمستخدمين، يمكنك تقديم معرّف منتج بسعر خاص لاشتراكك، ويُعرف أيضًا باسم رمز التخزين التعريفي لاستعادة المشتركين. يمكنك تقديم العرض في تطبيقك، أو يمكنك إعلام المستخدم بالعرض خارج التطبيق، مثلاً في رسالة إلكترونية.
  • لبدء اشتراك من خلال حملة استعادة المشتركين السابقين، عليك تشغيل مسار الشراء في تطبيق Android باستخدام Google Play Billing Library. هذه هي العملية نفسها التي تتم مع الاشتراك الجديد، ولكن يمكنك تحديد رمز التخزين التعريفي المتاح للمستخدم.
  • إذا قررت تضمين فترة تجريبية مجانية أو سعر تمهيدي في رمز التخزين التعريفي (SKU) لاستعادة المشتركين، فتأكَّد من أنّ المستخدم مؤهَّل من خلال إزالة العلامة من المربّع السماح بفترة تجريبية مجانية واحدة لكل تطبيق في Google Play Console، والذي يمنع المستخدم من الحصول على أكثر من فترة تجريبية مجانية واحدة لكل تطبيق.
  • إذا أعاد المستخدم الاشتراك في رمز التخزين التعريفي نفسه، لن يكون مؤهلاً للاستفادة من الفترات التجريبية المجانية أو السعر التمهيدي. تأكَّد من أنّ واجهة المستخدم تعكس ذلك.

عند تلقّي الرمز المميّز للشراء، يمكنك معالجة عملية الشراء كما تفعل مع اشتراك جديد. لن تتلقّى linkedPurchaseToken في مورد الاشتراك.

بعد انتهاء صلاحية الاشتراك - في "متجر Google Play"

في حال تفعيل هذه الميزة، يمكن للمستخدمين إعادة الاشتراك في رمز التخزين التعريفي نفسه لمدة تصل إلى عام واحد بعد انتهاء صلاحيته من خلال النقر على إعادة الاشتراك في مركز الاشتراكات في Google Play. يؤدي ذلك إلى إنشاء رمز مميّز جديد للاشتراك والشراء.

قسم الاشتراكات في تطبيق &quot;متجر Google Play&quot; يعرض اشتراكًا ملغًى ومنتهي الصلاحية مع زرَّي &quot;إعادة الاشتراك&quot; و&quot;إزالة&quot;
الشكل 9: قسم "الحساب" > "الاشتراكات" في تطبيق "متجر Google Play" يعرض اشتراكًا تم إلغاؤه وانتهت صلاحيته مع زرَّي إعادة الاشتراك وإزالة.

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

الترويج للاشتراكات

يمكنك إنشاء رموز ترويجية لمنح مستخدمين محدّدين فترة تجريبية مجانية ممتدة لاشتراك حالي. لمزيد من المعلومات، يُرجى الاطّلاع على الرموز الترويجية.

بالنسبة إلى الفترات التجريبية المجانية، يتحقّق Google Play من أنّ المستخدم لديه طريقة دفع صالحة قبل بدء الفترة التجريبية المجانية. قد تظهر عملية التحقّق هذه لبعض المستخدمين كرسوم مؤقتة أو رسوم على طريقة الدفع. هذه الرسوم أو المبالغ المحجوزة مؤقتة، ويتم إلغاؤها أو ردّها لاحقًا.

بعد انتهاء الفترة التجريبية، يتم تحصيل قيمة الاشتراك بالكامل من طريقة الدفع الخاصة بالمستخدم.

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

تأجيل الفوترة لمشترك

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

بالنسبة إلى خطط الدفع المُسبَق، يمكنك استخدام واجهة defer billing API لتأجيل وقت انتهاء الصلاحية.

تتيح لك ميزة "الفوترة المؤجَّلة" تنفيذ ما يلي:

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

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

على سبيل المثال، لدى "سارة" اشتراك شهري في المحتوى على الإنترنت لتطبيق Fishing Quarterly، ويتم تحصيل مبلغ 1.25 جنيه إسترليني منها في اليوم الأول من كل شهر. في شهر مارس، شاركت في استطلاع على الإنترنت لناشر التطبيق. يكافئها الناشر بستة أسابيع مجانية عن طريق تأجيل الدفعة التالية حتى 15 مايو، أي بعد ستة أسابيع من تاريخ الفوترة المقرر سابقًا في أبريل

  1. لا يتم تحصيل رسوم من "دارسي" مقابل شهر أبريل أو بداية شهر مايو، ويظل بإمكانها الوصول إلى المحتوى. في 15 مايو، يتم تحصيل رسوم الاشتراك العادية التي تبلغ 1.25 جنيه إسترليني للشهر. أصبح تاريخ التجديد التالي هو 15 يونيو.

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

التعامل مع حالات رفض الدفع

إذا كانت هناك مشاكل في الدفع لتجديد الاشتراك، ستحاول Google تجديد الاشتراك بشكل دوري لبعض الوقت قبل إلغائه. يمكن أن تتكوّن فترة استرداد الاشتراك هذه من فترة سماح، تليها فترة تعليق الاشتراك. خلال هذه الفترة، ترسل Google رسائل إلكترونية وإشعارات إلى المستخدم تطلب منه تعديل طريقة الدفع.

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

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

يمكنك تحديد مدة فترة السماح لكل خطة أساسية تتجدّد تلقائيًا وحالة تعليق الاشتراك في Google Play Console. قد يؤدي تحديد مُدد أقل من القيم التلقائية إلى تقليل عدد الاشتراكات التي يتم استردادها بعد رفض الدفعات.

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

يمكنك إجراء ذلك بنفسك، كما هو موضّح في قسمَي فترة السماح وتعليق الاشتراك، أو يمكنك تنفيذ واجهة برمجة التطبيقات الخاصة بالمراسلة داخل التطبيق، حيث تعرض Google رسالة للمستخدمين في تطبيقك.

عند حدوث مشكلة في الدفع، يمكن أن يعرض Google Play إشعارًا للمستخدمين. ولتسهيل ذلك، يمكنك استخدام ميزة المراسلة داخل التطبيق لإبلاغهم بأي دفعات معلَّقة. إذا فعّلت ميزة المراسلة داخل التطبيق، ستظهر رسالة بشأن مشاكل الدفع خلال فترة السماح وتعليق الاشتراك مرة واحدة في اليوم. ويمنح ذلك المستخدمين فرصة لإصلاح مشكلة الدفع بدون مغادرة التطبيق. لمزيد من المعلومات، يُرجى الاطّلاع على المراسلة داخل التطبيق.

المراسلة داخل التطبيق

إذا فعّلت ميزة المراسلة داخل التطبيق باستخدام InAppMessageCategoryId.TRANSACTIONAL، سيعرض Google Play رسالة للمستخدمين عند حدوث مشكلة في الدفع أو زيادة في السعر تتطلّب موافقة.

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

ننصحك باستدعاء واجهة برمجة التطبيقات هذه كلما فتح المستخدم التطبيق لتحديد ما إذا كان يجب عرض الرسالة.

إذا نجح المستخدم في استرداد اشتراكه أو أكّد زيادة السعر، ستتلقّى رمز الاستجابة SUBSCRIPTION_STATUS_UPDATED مع رمز مميّز للشراء. بعد ذلك، عليك استخدام رمز الشراء هذا لطلب واجهة Google Play Developer API وإعادة تحميل حالة الاشتراك في تطبيقك.

دمج ميزة "المراسلة داخل التطبيق"

لعرض رسائل داخل التطبيق للمستخدم، استخدِم BillingClient.showInAppMessages().

في ما يلي مثال على بدء عملية المراسلة داخل التطبيق:

Kotlin

val inAppMessageParams = InAppMessageParams.newBuilder()
    .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL)
    .build()

// Note: To display the in-app message, PBL requires an activity instance that
// can provide a valid window token. This token is necessary for the Play Store
// to display the message overlay correctly on top of the application's window.
// The passed Activity must be in a state where its window is created and
// attached to the WindowManager.
billingClient.showInAppMessages(
    activity,
    inAppMessageParams,
    object : InAppMessageResponseListener {
        override fun onInAppMessageResponse(inAppMessageResult: InAppMessageResult) {
            if (inAppMessageResult.responseCode == InAppMessageResponseCode.NO_ACTION_NEEDED) {
                // The flow has finished and there is no action needed from developers.
            } else if (inAppMessageResult.responseCode
                == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED
            ) {
                // The subscription status changed. For example, a subscription
                // is recovered from a suspended state, or a user confirms a
                // price increase. Developers should expect the purchase
                // token to be returned with this response code and use
                // the purchase token with the Google Play Developer API.
            }
        }
    }
)

Java

InAppMessageParams inAppMessageParams = InAppMessageParams.newBuilder()
        .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL)
        .build();

// Note: To display the in-app message, PBL requires an activity instance that
// can provide a valid window token. This token is necessary for the Play Store
// to display the message overlay correctly on top of the application's window.
// The passed Activity must be in a state where its window is created and
// attached to the WindowManager.
billingClient.showInAppMessages(activity,
        inAppMessageParams,
        new InAppMessageResponseListener() {
            @Override
            public void onInAppMessageResponse(InAppMessageResult inAppMessageResult) {
                if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.NO_ACTION_NEEDED) {
                    // The flow has finished and there is no action needed from developers.
                } else if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) {
                    // The subscription status changed. For example, a subscription
                    // is recovered from a suspended state, or a user confirms a
                    // price increase. Developers should expect the purchase
                    // token to be returned with this response code and use
                    // the purchase token with the Google Play Developer API.
                }
            }
        });

التعامل مع عمليات الإلغاء والحالات المعلّقة

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

الإلغاء أو الإبطال

يمكنك استخدام Google Play Developer API من أجل إلغاء أو إبطال اشتراك. تتوفّر هذه الوظيفة أيضًا في Google Play Console.

  • الإلغاء: يمكن للمستخدمين إلغاء اشتراك على Google Play. يمكنك أيضًا توفير خيار للمستخدمين لإلغاء الاشتراك في تطبيقك أو على موقعك الإلكتروني. يجب أن يتعامل تطبيقك مع عمليات الإلغاء هذه كما هو موضّح في عمليات الإلغاء.

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

يوضّح الجدول التالي الاختلافات بين الإلغاء والإبطال.

إيقاف التجديد إبطال إمكانية الوصول
إلغاء نعم لا
إبطال نعم نعم

التعامل مع المعاملات في انتظار المراجعة للاشتراكات

يمكن أن تحدث المعاملات في انتظار المعالجة في عملية الشراء الأولية أو إضافة الرصيد أو الترقية أو الرجوع إلى إصدار سابق. تبدأ عملية شراء الاشتراك بالحالة SUBSCRIPTION_STATE_PENDING قبل الانتقال إلى SUBSCRIPTION_STATE_ACTIVE. إذا انتهت صلاحية المعاملة أو ألغاها المستخدم، ستنتقل إلى الحالة SUBSCRIPTION_STATE_PENDING_PURCHASE_EXPIRED. ويجب عدم تعديل أذونات المستخدم إلا بعد اكتمال المعاملة.

إنّ تغيير حالة الاشتراك لعملية الشراء الأولية التي تتضمّن معاملات في انتظار المعالجة هو أمر بسيط. يتلقّى تطبيقك Purchase بالحالة PENDING عندما يبدأ المستخدم معاملة في انتظار المعالجة. عند اكتمال المعاملة، يتلقّى تطبيقك Purchase مرة أخرى مع تعديل الحالة إلى PURCHASED. يتم إرسال رسالة SubscriptionNotification من النوع SUBSCRIPTION_PURCHASED إلى عميل RTDN. اتّبِع العملية العادية للتحقّق من عملية الشراء، ومنح المستخدم إمكانية الوصول إلى المحتوى، والإقرار بعملية الشراء. في حال انتهاء صلاحية المعاملة أو إلغائها، يتم إرسال رسالة SubscriptionNotification من النوع SUBSCRIPTION_PENDING_PURCHASE_CANCELED إلى عميل RTDN. وفي هذه الحالات، من المفترض ألا يتمكّن المستخدم من الوصول إلى المحتوى.

تتضمّن عمليات إضافة الرصيد أو الترقية أو الرجوع إلى إصدار سابق مع المعاملات في انتظار المعالجة تغييرات في حالة كلّ من الاشتراكات القديمة والجديدة. عندما يبدأ المستخدم معاملة معلّقة لإضافة رصيد أو ترقية أو الرجوع إلى إصدار سابق، يتلقّى تطبيقك Purchase للاشتراك القديم مع عنصر PendingPurchaseUpdate. في هذه المرحلة، لا يزال المستخدم يملك الاشتراك القديم ولم يحصل على الاشتراك الجديد بعد. يؤدي استدعاء getProducts() وgetPurchaseToken() في عنصر PendingPurchaseUpdate إلى عرض معرّفات المنتجات ورمز الشراء المميّز للاشتراك الجديد. عند اكتمال المعاملة، يتلقّى تطبيقك Purchase مع ضبط رمز الشراء المميّز ذي المستوى الأعلى للاشتراك الجديد وضبط الحالة على PURCHASED. يتم إرسال رسالة SubscriptionNotification من النوع SUBSCRIPTION_PURCHASED إلى عميل RTDN. في هذه الحالة فقط، يجب استبدال الرمز المميّز القديم للشراء بالرمز المميّز الجديد وتعديل إذن وصول المستخدم إلى المحتوى. إذا انتهت صلاحية المعاملة أو تم إلغاؤها، يتم إرسال رسالة SubscriptionNotification من النوع SUBSCRIPTION_PENDING_PURCHASE_CANCELED إلى عميل RTDN. وفي هذه الحالات، من المفترض أن يظل بإمكان المستخدم الوصول إلى محتوى الاشتراك القديم.