كل طلب استرداد من Apple يأتي الآن مع سبب، وconsumptionRequestReason هو الطريقة التي تقرأه بها

غيّرت Apple كيفية وصول طلبات الاسترداد إلى خادمك، ولم يلاحظ الكثير من المطورين ذلك أبدًا. منذ تحديث App Store Server Notifications 2.11 الذي أُعلن عنه في WWDC24، يحمل كل إشعار CONSUMPTION_REQUEST حقلًا اسمه consumptionRequestReason. إنه السبب الذي ذكره العميل نفسه لطلب استرداد أمواله. سلسلة نصية بسيطة واحدة، وخمس قيم ممكنة، تُسلَّم داخل الحمولة نفسها التي لديك بالفعل اثنتا عشرة ساعة للرد عليها.

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

ما هو consumptionRequestReason في الواقع

consumptionRequestReason هو حقل نصي في كائن data ضمن إشعار CONSUMPTION_REQUEST. أضافته Apple في الإصدار 2.11 من App Store Server Notifications، إلى جانب تغييرات WWDC24 على تدفق الاسترداد. قبل ذلك، كان الطلب يصل مع المعاملة الموقّعة ودون أي شيء عن الدافع. كنت ترد وأنت أعمى. الآن يسافر السبب الذي ذكره العميل مع الطلب.

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

إنه يصل داخل الإشعار الذي تتعامل معه بالفعل

CONSUMPTION_REQUEST هو تدفق Apple الوحيد الذي يطلب الأدلة من المطور على الإطلاق. نظيره في Google Play هو مراجعة رد المبالغ عبر orders.reviewrefund. عندما يصل واحد، لديك 12 ساعة للرد باستدعاء Send Consumption Information، وهو طلب PUT إلى نقطة نهاية استهلاك المعاملات. أصبح consumptionRequestReason الآن جزءًا من الإشعار نفسه، لذا لا يوجد شيء جديد للاشتراك فيه. إذا كنت تحلل CONSUMPTION_REQUEST بالفعل، فإن السبب هو حقل واحد ربما كنت تتجاهله.

الأسباب الخمسة، وما يخبرك به كل واحد منها

توثّق Apple خمس قيم بالضبط. تصل واحدة لكل طلب. إليك المجموعة الكاملة وكيفية قراءة كل واحدة عمليًا.

UNINTENDED_PURCHASE هو سلة النقر العرضي

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

FULFILLMENT_ISSUE يشير إليك

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

UNSATISFIED_WITH_PURCHASE هو حيث تقرر الأدلة

هذا ندم مشترٍ عادي، وهو السبب الذي تؤدي فيه بيانات الاستهلاك لديك أكبر عمل. المنتج عمل. استخدم العميل جزءًا منه أو كله، والآن يريد استرجاع المال. consumptionPercentage مرتفع، وdeliveryStatus صادق بقيمة DELIVERED، وrefundPreference بقيمة DECLINE أو GRANT_PRORATED هي القضية التي تطلب منك Apple بناءها. أرسل الأرقام، لا حُجة.

LEGAL وOTHER

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

كيف يغيّر السبب إجابتك، حقلًا حقلًا

ترد على CONSUMPTION_REQUEST عبر استدعاء Send Consumption Information مع جسم ConsumptionRequest. يجب أن يشكّل السبب ثلاثة حقول في ذلك الجسم.

customerConsented يجب أن يكون true

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

deliveryStatus وconsumptionPercentage يحملان الحقائق

deliveryStatus يقول ما إذا كنت قد سلّمت عملية شراء تعمل. إذا كان أي شيء غير DELIVERED، تتطلب Apple أن يكون consumptionPercentage بقيمة 0. عندما تكون قد سلّمت بالفعل، يكون consumptionPercentage عددًا صحيحًا بوحدة milliunits من 0 إلى 100,000، حيث يعني 100,000 أن العميل استخدم عملية الشراء بأكملها. هذا الزوج هو جوهرك الواقعي، وهو ما ينبغي أن يحمل قضية FULFILLMENT_ISSUE أو UNSATISFIED_WITH_PURCHASE، وليس السبب نفسه.

refundPreference هو رافعتك الوحيدة

refundPreference هو حيث تذكر ما تريد. توثّق Apple ثلاث قيم: GRANT_FULL وGRANT_PRORATED وDECLINE. اقرأ السبب، وزنه مقابل بياناتك، ثم اختر. FULFILLMENT_ISSUE مع تسليم فاشل في سجلاتك يميل نحو GRANT_FULL. UNSATISFIED_WITH_PURCHASE على منتج مُستهلك بالكامل يميل نحو DECLINE أو GRANT_PRORATED. LEGAL يميل نحو GRANT_FULL.

ما الذي يكلفك إياه الاسترداد فعليًا

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

لهذا السبب يستحق السبب القراءة. لنقل إن عميلًا اشترى 5,000 رصيد، كل منها يُطلق استدعاء API مدفوعًا، وأنفق 4,000 منها، ثم قدّم طلبه تحت UNSATISFIED_WITH_PURCHASE. deliveryStatus لديك بقيمة DELIVERED، وconsumptionPercentage لديك بقيمة 80,000 milliunits، وتفضيل DECLINE أو GRANT_PRORATED هو الفرق بين تحمّل فاتورة API واسترداد معظمها. الآن اقلب السبب إلى FULFILLMENT_ISSUE مع سجلات تُظهر أن الأرصدة لم تُسجَّل أبدًا، والخطوة الصادقة الأرخص هي GRANT_FULL قبل أن يصعّد العميل الأمر إلى بنكه.

قراءة السبب دون المبالغة في رد الفعل

الفخ هو التعامل مع السبب على أنه دليل. UNINTENDED_PURCHASE ليس اعترافًا بأن المنتج لم يُستخدم، وLEGAL ليس دائمًا ادعاءً قانونيًا حقيقيًا. السبب يضيّق الحالة. سجلات التسليم وسجلات الاستهلاك لديك تحسمها. عندما تتفق مع العميل، وافق مبكرًا وبتكلفة زهيدة. عندما تتناقض مع العميل، فإن ذلك التناقض، مُعبَّرًا عنه بـ deliveryStatus وconsumptionPercentage، هو أقوى شيء يمكنك إرساله. يقرأ RefundHalt حقل consumptionRequestReason في كل CONSUMPTION_REQUEST ويقرنه ببيانات الاستخدام الحقيقية لديك تلقائيًا، بحيث يحصل كل سبب على الرد الذي يستحقه داخل نافذة الـ 12 ساعة.

التغيير صغير ويسهل تفويته، لكنه حرّك محادثة الاسترداد لصالحك. Apple تخبرك الآن بالسبب، قبل أن ترد. استخدمه.