إدارة الاشتراكات وعمليات الشراء لمرة واحدة

قد تحتاج إلى اتخاذ إجراءات إدارية بشأن الاشتراكات أو عمليات الشراء التي تتم لمرة واحدة. كجزء من الأعمال اليومية. على سبيل المثال، قد تحتاج خدمة العملاء إلى إصدار دفعات إجمالية أو جزئية للمستخدمين، أو قد تحتاج إلى إبطال الاستحقاقات في بعض الحالات. يمكنك إدارة الطلبات من Play Console أو إذا إذا كنت تريد إدارتها من نظامك الخاص، يمكنك إجراء ذلك باستخدام واجهة برمجة التطبيقات Google Play Developer API:

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

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

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

قد تحتاج أيضًا إلى تشغيل عمليات الإلغاء من الخلفية. purchases.subscriptions.cancel إلغاء شراء اشتراك. على سبيل المثال، يمكنك استخدام هذه الطريقة لإيقاف خدمة قديمة. لا يؤدي إلغاء الاشتراك إلى رد الأموال، ويستمر المستخدم في حتى نهاية المدة الزمنية الحالية للفوترة. جارٍ إلغاء يؤدي استخدام هذه الطريقة إلى منع المستخدم من استعادة الاشتراك في "متجر Play"، ولكن سيظل بإمكان المستخدمين الاشتراك مرة أخرى من خلال تطبيقك إذا تحتاجون إليها.

يؤدي تنفيذ هذا الإجراء إلى تشغيل مطوّر برامج "SUBSCRIPTION_CANCELED" في الوقت الفعلي. . تعامل مع عمليات الإلغاء هذه على النحو الموضَّح في عمليات الإلغاء:

تأجيل الفوترة

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

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

في ما يلي بعض الأمثلة حول كيفية استخدام الفوترة المؤجلة:

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

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

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

مثال:

1. تريد خدمة بث FitnessGoals تشغيل إعلان ترويجي بتشجيع التمرين المنتظم في فبراير.

2. قرّر الفريق تقديم خدمة لمدة شهر إضافي لأي مشترك. الذين يمارسون أهداف اللياقة البدنية 10 مرات على الأقل خلال شهر فبراير.

3. إنه يتتبع نتائج التحدي، وفي 1 مارس يستدعي subscriptions.defer API لكل عملية شراء اشتراك نشِطة تنتمي إلى للمستخدمين الذين واجهوا التحدي في فبراير.

4. يستفيد هؤلاء المستخدمون من ممارسة تمارين منتظمة لمدة شهر إضافي مقاطع فيديو مجانية، ويخبر المستخدمون جميع أصدقائهم بمدى استفادتهم من "أهداف اللياقة البدنية" ويساعدهم في الحفاظ على صحتهم.

إصدار عمليات ردّ الأموال وإبطال الاشتراكات

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

ردّ أموال طلب بالكامل حسب مُعرّف الطلب

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

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

مثال:

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

2. تستخدم قناة Football- Not-Soccer orders.refund واجهة برمجة التطبيقات بدون ضبط مَعلمة لردّ أموال عمليات شراء القمصان إلى الفائزون.

إبطال اشتراك وردّ أمواله من خلال الرمز المميّز للشراء

بالنسبة إلى بعض حالات الاستخدام، قد تحتاج إلى إبطال إذن الوصول إلى اشتراك المستخدم. واسترداد الأموال. تقدِّم خدمة "الفوترة في Play" طرق إبطال تشمل جميع طرق الإبطال عمليات ردّ الأموال وردّ الأموال بشكل نسبي من خلال subscriptionsv2.revoke واجهة برمجة التطبيقات. باستخدام نقطة النهاية هذه، يمكنك تحديد revocationContext لتحديد كيفية حساب رد الأموال.

يؤدي تنفيذ هذا الإجراء إلى تشغيل مطوّر برامج في الوقت الفعلي في SUBSCRIPTION_REVOKED. إشعار يجب أن يتعامل تطبيقك مع عمليات الإلغاء هذه على النحو الموضَّح في عمليات الإبطال:

مثال:

• إجراء عملية الشراء باستخدام الرمز المميّز للشراء: 1a2b3c4d5e6f7g8h9i0j
• تطبيق يحمل اسم الحزمة com.your.app
• نية إصدار عملية ردّ أموال مقسَّمة حسب الاستخدام

طلب HTTP POST:

https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.your.app/purchases/subscriptionsv2/tokens/1a2b3c4d5e6f7g8h9i0j:revoke

نص الطلب:

{
  "revocationContext": {
    "proratedRefund": {}
  }
}

ردّ الأموال بالكامل

إذا كنت بحاجة إلى إنهاء اشتراك واسترداد المبلغ الكامل المدة الزمنية الحالية للفوترة، يمكنك رد الأموال بالكامل. يمكنك استخدام purchases.subscriptionsv2.revoke وتعيين "fullRefund": {} كنوع رد الأموال.

مثال:

1. لدى ماريا اشتراك يتم تجديده تلقائيًا لمدة 30 يومًا في خدمة البث SuperMovies. خطة شهرية. واجهت ماريا بعض المشكلات الفنية التي تمنعها من الوصول إلى المحتوى. تتواصل مع خدمة العملاء في اليوم الثالث من الفوترة تفيد بعدم حصولها على إمكانية الوصول إلى هذا الاشتراك.

2. تحدد خدمة العملاء تفاصيل شراء اشتراك ماريا في نظام المستخدم ويشغِّل اتصالاً بـ purchases.subscriptionsv2.revoke لطلب استرداد الأموال بالكامل.

3. تخبر خدمة العملاء ماريا أنه ينبغي عليها الحصول على 100% منها تم ردّ مبلغ سعر الاشتراك ولم تعُد مشتركة في الخطة.

تقسيم عمليات ردّ الأموال

إذا أردت إنهاء اشتراك وردّ جزء من المبلغ المتبقّي وقت الوصول إلى الموقع الإلكتروني، أو إصدار ردّ نسبي يمكنك استخدام purchases.subscriptionsv2.revoke وتعيين "proratedRefund": {} كنوع رد الأموال.

مثال:

1. لدى ماريا اشتراك يتم تجديده تلقائيًا لمدة 30 يومًا في خدمة البث SuperMovies. خطة شهرية. وقد استخدمت الخدمة بسعادة لبعض الوقت. اتصلت ماريا بخدمة العملاء في اليوم 15 من دورة الفوترة قائلةً إنها تنتقل للخارج ولن تتمكن من استخدام الخدمة مرة أخرى بدءًا من في اليوم التالي.

2. تحدد خدمة العملاء تفاصيل شراء اشتراك ماريا في نظام المستخدم ويشغِّل اتصالاً بـ purchases.subscriptionsv2.revoke يطلبون استرداد أموال مقسَّمة حسب الاستخدام.

3. تخبر خدمة العملاء ماريا أنه ينبغي عليها الحصول على حوالي 50٪ منها تم رد سعر الاشتراك وإنهاء إمكانية الوصول إلى الخدمة فورًا.