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

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

ما هو رمز سبب الاسترداد فعليًا

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

تختم Google Play سببًا ومصدرًا على كل عملية إبطال

تُرجِع Voided Purchases API الخاصة بـ Google Play سجلًا واحدًا لكل عملية شراء معكوسة، ويحمل كل سجل عددين صحيحين مهمّين. يقول voidedReason لماذا أُبطلت عملية الشراء. ويقول voidedSource مَن أطلقها. معًا يحوّلان استردادًا مجرّدًا إلى جملة: أُبطل هذا الطلب بسبب ردّ مبلغ، بدأته Google، أو أُبطل بوصفه ندمًا، بدأه المستخدم. تقرؤهما بالاستقصاء الدوري لـ API أو بالاشتراك في إشعار المطوّر الفوري الذي يُطلَق حين يصل الإبطال. في كلتا الحالتين، الرقمان هما الحمولة الجديرة بالاحتفاظ.

تمنحك Apple إشارة أضيق، لكنها حادّة

لا تسلّمك Apple سببًا من تسعة اتجاهات. في معاملة مُستردّة، تضبط Apple قيمة revocationReason على إحدى قيمتين. القيمة 1 تعني أن App Store ردّ المبلغ للمعاملة بسبب مشكلة فعلية أو متصوَّرة داخل تطبيقك. والقيمة 0 تعني أنه ردّه لسبب آخر، مثل شراء عرضي. لا يظهر هذا الحقل إلا في المعاملات التي استُردّت أو أُلغيت، مع revocationDate، داخل معلومات المعاملة الموقَّعة لإشعار REFUND من App Store Server Notification. قيمتان ليستا كثيرًا، لكن القيمة المهمة، وهي 1، هي Apple تخبرك أن الاسترداد كان بشأن منتجك، لا بشأن تراجع العميل عن قراره.

الأسباب التسعة التي تمنحك إياها Google Play

voidedReason الخاص بـ Google هو الأغنى بين الاثنين، وكل قيمة جديرة بأن تعرفها بمجرد رؤيتها لأن كل واحدة تشير إلى مكان مختلف. إليك المجموعة الكاملة، مباشرةً من مورد VoidedPurchase، مع ما يخبرك كل رمز بفعله فعليًا.

voidedSource يخبرك مَن ضغط الزناد

بجوار السبب يقع voidedSource، وهو يجيب عن سؤال مختلف: مَن عكس هذه العملية. القيمة 0 تعني أن المستخدم فعلها، عبر الخدمة الذاتية أو عبر بنك. والقيمة 1 تعني أن المطوّر فعلها، أي أنت أو أدواتك الخاصة تُصدر استردادًا. والقيمة 2 تعني أن Google فعلتها، بحكمها الخاص، بما في ذلك الردّ التلقائي لشراء غير مُقرّ به. حين ترى ارتفاعًا مفاجئًا في عمليات الإبطال، يكون المصدر هو التقسيم الأول. جدار من المصدر 2 هو Google تتصرّف على حسابك، وذلك عادةً إشارة تعود لتؤشّر إلى تكاملك أنت لا إلى عملائك.

صنّف كل استرداد إلى إصلاح أو مجادلة أو قبول

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

الإصلاح: عمليات الاسترداد التي سبّبها منتجك

بعض الرموز تقارير أخطاء ترتدي ثوب استرداد. المعيب (3) ولم يُستلم (2) على Google، وقيمة revocationReason هي 1 على Apple، كلها تقول الشيء نفسه: دفع العميل ولم يُسلّم تطبيقك. الشراء غير المُقرّ به (8) هو الأحدّ بينها لأن الذنب يقع كليًا في شيفرة الفوترة لديك. هذه أرخص عمليات الاسترداد للقضاء عليها، لأنك تقضي عليها بإصلاح شيء تملكه أنت، لا بإقناع أحد. عدد متصاعد في هذه الكومة هو عيب في المنتج مرفق برقم بالدولار.

المجادلة: عمليات الاسترداد التي يحرّكها أحدهم

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

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

الندم (1) والشراء العرضي (4) هما تبدّل رأي العميل نفسه. وتقع قيمة revocationReason هي 0 لدى Apple هنا أيضًا. لم تفشل أي ميزة ولم يقع أي احتيال. يمكنك تلطيف كومة العرضي بتأكيد شراء أوضح، لكنك لا تستطيع مجادلة استرداد الندم بعيدًا، والوقت المُنفَق في المحاولة وقت مسلوب من كومة الإصلاح حيث يكون المال فعليًا.

مطبّ الـ 30 days الذي يجعل رموز السبب سهلة الضياع

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

لا تنظر Voided Purchases API إلى الوراء سوى 30 days

تصرّح Google بوضوح أن الـ API لا يمكنها إظهار سوى عمليات الشراء المُبطلة خلال الـ 30 days الماضية. لا تُرجَع عمليات الإبطال الأقدم مهما كانت قيمة startTime التي تمرّرها، وقيمة startTime نفسها لا يمكن ضبطها إلى أبكر من 30 days مضت. والأسوأ لتكامل ساذج، أن نافذة الـ 30 days تُقاس بوقت رؤية أنظمة Google لعملية شراء كمُبطلة، لا بوقت إجراء الشراء ولا حتى بقيمة voidedTimeMillis في السجل. لذا فإن رمز سبب استرداد لا تسحبه داخل تلك النافذة يضيع، ومهمة تصدير شهرية بها أي فجوة ستُسقط بصمت عمليات الإبطال التي كانت أبطأ من أن تلتقطها.

كم تساوي رموز السبب بالمال

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

رمز واحد فاتورة كتبتها بنفسك

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

رمز ردّ المبلغ يحمل الآن رسمًا

voidedReason 7، ردّ المبلغ، تغيّرت تكلفته في August 3, 2026. بالنسبة إلى طلبات Google Play المقدَّمة في ذلك التاريخ أو بعده، يكلّف ردّ المبلغ الخاسر المطوّرَ سعرَ الشراء ناقصًا رسوم خدمة Play، زائدًا رسوم ردّ المبلغ التي يتقاضاها البنك، بينما تغطّي Google رسوم خدمتها هي فقط. ولأن رسوم ردّ المبلغ ثابتة وأسعار المنتجات ليست كذلك، فإن الرسم وحده على عملية شراء داخل التطبيق رخيصة قد يتجاوز ما دفعه العميل. عدّ عمليات الإبطال ذات الرمز 7 لديك أصبح الآن عدًّا لبند تكلفة، لا مجرد بيعة مفقودة، وهذا بالضبط سبب استحقاق كومة ردّ المبلغ صفًّا خاصًا بها في أي تقرير استرداد تبنيه.

كيف تتوافق Apple وGoogle

يجيب المتجران عن السؤال نفسه بدقّتين مختلفتين، لذا يتعيّن على تقرير استرداد عابر للمتجرين أن يوحّدهما بدلًا من أن يتوقّع تطابقهما.

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

يلتقط RefundHalt رمز السبب في كل عملية استرداد لحظة وصولها، على كلا المتجرين، ويحتفظ به جيدًا داخل نافذة الـ 30 days الخاصة بـ Google كي لا يفلت شيء. يصنّف كل عملية إبطال إلى إصلاح أو مجادلة أو قبول، فيصلك ارتفاع مفاجئ في الرمز 3 معيب كتنبيه منتج، ويصلك ارتفاع مفاجئ في الرمز 8 غير مُقرّ به كخلل تكامل، لا كهبوط غامض في الإيرادات. يجيب عن CONSUMPTION_REQUEST من Apple خلال 12 ساعة وعن مراجعة ردّ المبلغ من Google Play خلال 24، ويلغي الوصول لحظة وصول استرداد أو ردّ مبلغ. لا يمكنك تغيير الرمز الذي يختمه متجر على عملية استرداد. يمكنك التأكد من أنك تقرأ كل واحد، وتتصرّف بناءً على تلك التي من شأنك فعلًا إصلاحها.