الانتقال إلى المحتوى
App Store Refund Management

كيف تتابع طلبات استرداد Apple وترد عليها في الوقت المناسب

تعرّف على كيف تساعد متابعة طلبات استرداد Apple مطوري التطبيقات على مراقبة عمليات الاسترداد وحماية إيرادات الاشتراكات

5 min read
كيف تتابع طلبات استرداد Apple وترد عليها في الوقت المناسب

اسأل معظم الفرق إن كانت تتابع عمليات استرداد Apple وسيجيبون بنعم. اسأل عمّا يخزّنونه فعلاً، وسيتبيّن أنه صف واحد لكل عملية استرداد، يُكتب بعد وقوعها، مع تاريخ ومبلغ.

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

هذه الفجوة مهمة لأن أجزاءً من هذه العملية تنتهي صلاحيتها. تمنح Apple مهلة 12 ساعة لإحدى الخطوات، وبمجرد انقضائها لا يمكن إعادة فتحها. إذا كنت تبحث عن الصورة الأوسع بدلاً من آليات المتابعة، فإن دليلنا حول كيفية إدارة عمليات استرداد App Store دون خسارة إيرادات تطبيقك يغطي ذلك. أما هذا المقال فيتناول ما ينبغي تسجيله، ومتى ينبغي التصرف.

أبرز النقاط

• Apple هي من تتخذ قرار الاسترداد النهائي. المطورون لا يوافقون على الطلبات ولا يرفضونها.

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

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

• إرسال الرد وقبوله أمران مختلفان. تابع النتيجة، لا المحاولة.

• يجب أن تصل نتيجة الاسترداد إلى منطق صلاحيات الوصول (entitlement) لديك وإلى سجلات الإيرادات، وإلا فالمتابعة لم تكتمل.

• الأتمتة تمنع في الغالب تفويت الأحداث وانقضاء المهل. وليس لها أي تأثير على ما تقرره Apple.

ما المقصود بمتابعة طلبات استرداد Apple؟

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

هذه الحالات مهمة لأنها أحداث مختلفة فعلاً، ومع ذلك تدمجها الفرق عادةً في حالة واحدة:

الحالة

ما تخبرك به

تم استلام الطلب

يوجد طلب استرداد، وقد أبلغتك Apple به

فرصة الرد مفتوحة

Apple تطلب مدخلات منك، والعدّاد يعمل

تم إرسال الرد

أرسلت شيئاً ما

تم قبول الرد

Apple قبلته فعلاً — وهذا يختلف عن مجرد إرساله

تمت الموافقة على الاسترداد

منحت Apple الاسترداد

تم رفض الاسترداد

لم تمنحه Apple

تم عكس الاسترداد

ألغت Apple استرداداً كانت قد منحته سابقاً

تم تحديث صلاحية الوصول

تطبيقك يعكس الآن النتيجة

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

كيف يتابع المطورون طلبات استرداد Apple؟

يتابع المطورون نشاط استرداد Apple من خلال نظام الإشعارات على جانب الخادم من Apple وسجلات المعاملات الخاصة بهم. ويعتمد المسار الدقيق على نوع الحدث وعلى ما إذا كانت Apple تطلب مدخلات. تصل الأحداث إلى عنوان URL تحدده عبر App Store Server Notifications، على شكل حمولات موقّعة يتحقق منها الخادم الخلفي لديك ويعالجها.

هناك نوعان من الأحداث المتعلقة بالاسترداد يستحقان الفصل بينهما في المعالج (handler) لديك. أحدهما يطلب منك شيئاً. والآخر يخبرك بما حدث.

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

أما النوع المُخبِر فيغطي النتائج: REFUND عند المنح، وREFUND_DECLINED عند الرفض، وREFUND_REVERSED عندما تلغي Apple استرداداً كانت قد منحته سابقاً. والثالث هو الذي تنساه معظم المعالجات.

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

ما المعلومات التي ينبغي للمطورين متابعتها؟

قسّمها حسب مصدر المعلومات، لأن جانباً واحداً فقط منها هو المرجع الموثوق.

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

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

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

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

كيفية متابعة عمليات استرداد App Store خطوة بخطوة

1. استلام الحدث المتعلق بالاسترداد

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

2. التحقق من الإشعار

تحقق من التوقيع مقابل سلسلة شهادات Apple وتأكد من معرّف الحزمة (bundle ID) قبل التصرف بناءً على الحمولة. نقطة النهاية التي تثق بكل ما تستقبله هي نقطة يمكن لأي شخص آخر الكتابة إليها.

3. تحديد المعاملة ذات الصلة

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

4. التحقق مما إذا كانت Apple تطلب مدخلات

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

5. جمع معلومات الاستهلاك المدعومة

اسحب القيم من سجلاتك: هل تم تسليم المشتريات، هل قُدّم محتوى تجريبي، وكم تم استهلاكه. توضح وثائق Send Consumption Information من Apple الحقول وقيمها الصالحة. وقبل أي من ذلك، تحقق من الموافقة — تشترط Apple موافقة صالحة من العميل لمشاركة البيانات، والحصول عليها مسؤولية المطور، والطلبات التي تفتقر إليها تُرفض مباشرة.

6. الإرسال ضمن المهلة الموثقة

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

7. متابعة النتيجة النهائية

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

8. تحديث صلاحية الوصول

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

9. المطابقة مع سجلات الإيرادات

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

كيفية الرد على طلبات استرداد Apple

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

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

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

ماذا يحدث بعد أن تقرر Apple بشأن الاسترداد؟

ترسل Apple النتيجة كإشعار وتعكس الرسوم من جانبها. ثم ينتقل العمل إليك.

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

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

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

لماذا تصبح المتابعة اليدوية لاستردادات Apple صعبة

ليس بسبب الإهمال. فالعمل ببساطة لا يتوافق مع أوقات توفر الأشخاص.

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

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

هل يمكن أتمتة متابعة استردادات Apple؟

نعم، وينبغي أتمتة معظمها، لأن كل خطوة تقريباً حتمية النتيجة.

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

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

كيف يساعد RefundSensor في إدارة استردادات Apple

إدارة عمليات استرداد App Store هي الفئة التي ينتمي إليها هذا العمل، وRefundSensor مبني لجانب المطور منه: مراقبة مسارات استرداد Apple، وأتمتة خطوات الرد المدعومة، والاحتفاظ بأحداث الاسترداد ونتائجه وسجلاته في مكان واحد بدلاً من تشتتها عبر أكثر من dashboard.

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

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

أين توثَّق هذه القواعد

ثلاثة مصادر من Apple تقف خلف الادعاءات التقنية أعلاه. اقرأها مباشرة، وراجعها دورياً — فهذا المجال تغيّر أكثر من مرة.

طلب استرداد للتطبيقات أو المحتوى — العملية الموجهة للعملاء. مفيدة لفهم من أين تنشأ الطلبات، والتحديث خلال 24 إلى 48 ساعة الذي يُطلب من العملاء توقعه، وملاحظة Apple بأن الأهلية تختلف حسب البلد أو المنطقة.

Send Consumption Information — مسار رد المطور: شرط الموافقة، ومهلة 12 ساعة، وحقول الطلب. اقرأه قبل بناء أي معالجة للردود.

App Store Server Notifications — كيف تصل أحداث الاسترداد إلى الخادم الخلفي لديك، وصيغة الحمولة الموقّعة، وأنواع الإشعارات، بما فيها CONSUMPTION_REQUEST وREFUND وREFUND_DECLINED وREFUND_REVERSED.

إذا كانت أحداث الاسترداد لا تزال تُراقب يدوياً

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

إذا كان هذا يصف إعدادك، فإن RefundSensor يتولى جانب المطور من مسارات استرداد Apple مراقبة الأحداث، وإبقاء الردود ضمن المهلة، والتأكد من وصول النتائج إلى سجلاتك ومنطق صلاحيات الوصول لديك.


الأسئلة الشائعة

من خلال App Store Server Notifications وسجلات المعاملات الخاصة بك. تصل الأحداث إلى نقطة نهاية خادم محددة مسبقاً على شكل حمولات موقّعة. تتحقق منها، وتربط المعاملة بعميل، وتسجل الحدث، وترد إذا طلبت Apple مدخلات، وتخزّن النتيجة عند وصولها.

تتبّع طلب الاسترداد عبر كل حالة يمر بها من جانب المطور: استلام الطلب، وفرصة الرد، وإرسال الرد وقبوله، ونتيجة Apple، وتحديث صلاحية الوصول الذي يغلق الطلب. تخزين النتيجة النهائية فقط يُفقدك المعلومات التي تحتاجها لتفسير ما حدث.

نعم. ترسل Apple النتيجة كإشعار خادم. REFUND يعني أنه تم منحه، وREFUNDDECLINED يعني أنه لم يُمنح، وREFUNDREVERSED يعني أن استرداداً مُنح سابقاً قد أُلغي. كما تحمل المعاملات المستردة تاريخ إلغاء ورمز سبب في حمولة المعاملة.

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

إشعار من App Store Server Notifications يخبر خادمك بأن Apple تريد معلومات عن عملية شراء أثناء تقييمها لطلب استرداد. إنه ليس إشعار استرداد وليس قراراً. يتطلب الرد موافقة العميل، وتطلب Apple الرد خلال 12 ساعة.

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

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

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

#Apple Refund Request Tracking#Apple Refunds. App Store Refunds#Apple Refund Management#Refund Tracking#Subscription Revenue Protection
Refund SensorRefund Sensor TeamRefund defense for App Store and Google Play developers