يخبرك App Store order ID المطبوع على إيصال العميل بما اشتراه، وما إذا كانت Apple قد ردّت له المبلغ بالفعل

قبل أن ترد على رسالة استرداد من عميل iPhone، اطلب منه App Store order ID المكتوب على إيصال Apple. هذه السلسلة الواحدة، بعد تمريرها إلى نقطة النهاية Look Up Order ID من Apple، تخبرك بالمنتج الذي اشتراه، ومتى اشتراه، وما إذا كانت Apple قد ردّت له المبلغ بالفعل. من دونها، تطابق لقطة شاشة وعنوان بريد إلكتروني مع قاعدة بياناتك وتأمل خيرًا. ومعها، تعرف خلال ثوانٍ إن كنت تتحدث مع عميل دفع فعلًا، أو عميل ردّت له Apple ماله، أو شخص يحمل إيصالًا من تطبيق آخر.

من أين يأتي App Store order ID

وثائق Apple واضحة. عندما يجري العملاء عملية شراء واحدة أو أكثر داخل تطبيقك، يرسل App Store إليهم إيصالًا بالبريد الإلكتروني، ويحتوي هذا الإيصال على order ID. ويمكن للعملاء أيضًا العثور على أرقام order ID في سجل مشترياتهم على App Store. صفحة سجل المشتريات لدى Apple موجودة على reportaproblem.apple.com وفي تطبيق App Store ضمن Apps & Purchase History، وتعرض آخر 90 يومًا افتراضيًا، مع عوامل تصفية للمشتريات الأقدم.

إذن المفتاح في يد العميل أصلًا. كل ما على نموذج الدعم لديك أن يطلبه.

لماذا لا يكفي عنوان البريد الإلكتروني

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

ماذا تعيد Look Up Order ID

Look Up Order ID جزء من App Store Server API، ومتاحة منذ الإصدار 1.1.0. تستدعي GET https://api.storekit.apple.com/inApps/v1/lookup/{orderId} باستخدام JWT الموقّع الخاص بك. تقول Apple إن الاستجابة تستند إلى سجل مشتريات العميل داخل التطبيق، بغض النظر عمّا إذا كان قد ثبّت التطبيق أو حذفه أو أعاد تثبيته.

هل هذا إيصال صالح لتطبيقي؟

هذا هو السؤال الذي يجيب عنه OrderLookupStatus أولًا. القيمة 1 تعني أن order ID لم يُطابق أي مشتريات في تطبيقك. الحالات الشائعة هي خطأ في الكتابة، أو إيصال لتطبيق آخر، أو إيصال ليس من App Store أصلًا. لا تردّ مالًا ولا تمنح رصيدًا ولا تستعد شيئًا عند القيمة 1. اطلب من العميل التحقق من الإيصال مرة أخرى.

هل ردّت Apple قيمة هذا الشراء بالفعل؟

تحقق من revocationDate في كل معاملة بعد فك ترميزها. إذا كان مضبوطًا، فقد ردّت Apple قيمة هذا الشراء أو سحبته من Family Sharing، والعميل استعاد ماله. ومن المفترض أن تكون App Store Server Notifications قد أرسلت REFUND للمعاملة نفسها، لذا فهذه أيضًا طريقة رخيصة للتأكد من أن خادمك ألغى الوصول فعلًا.

ما الذي لا يستطيع order ID فعله على App Store

لا يستطيع إصدار استرداد. ليس لدى المطورين زر لاسترداد App Store. تقرر Apple الاستردادات، ويوجّه مقال الدعم الخاص بها العملاء إلى reportaproblem.apple.com، حيث يختارون "I'd like to" ثم "Request a refund"، ويحددون سببًا، ثم يختارون العنصر. وتقول Apple أيضًا إن الرسوم المعلّقة لا يمكن ردّها حتى يصل إلى العميل إيصال البريد الإلكتروني.

المكان الوحيد الذي يكون لك فيه رأي هو CONSUMPTION_REQUEST من Apple. عندما يطلب عميل من Apple استردادًا، قد ترسل Apple هذا الإشعار، ولديك 12 ساعة للرد عبر Send Consumption Information. البحث بـ order ID أداة دعم. لا يفتح تلك النافذة ولا يمدّدها.

كم تكلفك رسالة استرداد عندما تتخطى البحث

الدعم من دون order ID هو المكان الذي يتسرب منه المال بهدوء. تتكرر ثلاثة أنماط مرة بعد مرة.

• مجاملة فوق الاسترداد. تردّ Apple قيمة الشراء، ويراسلك العميل أيضًا، فيمنحه الدعم رصيدًا مجانيًا أو شهرًا إضافيًا. كل رصيد تمنحه يعمل على compute وAPI calls وstorage تدفع أنت ثمنها، على حساب استعاد ماله بالفعل.
• وصول لم يُلغَ قط. إذا فشلت معالجة REFUND لديك، يواصل العميل المسترد ماله الاستخدام. بحث يُظهر revocationDate بينما تقول قاعدة بياناتك إن الاشتراك ما زال نشطًا هو تقرير خلل يحمل ثمنًا.
• حساب خاطئ، وحل خاطئ. استعادة الحساب المرتبط ببريد معاد توجيهه أو منحه رصيدًا، بينما يعود order ID لشخص آخر، يمنح خدمة مدفوعة لشخص لم يشترها قط.

لا يحتاج أي من هذه الأنماط إلى نزاع أو مهلة كي يضرّك. إنها مجرد ردود دعم صدرت دون حقائق. استدعاء API واحد لكل تذكرة يزيل التخمين.

هل يعني revocationReason 1 أنني أخطأت؟

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

كيف يختلف order ID في Google Play

تعمل Google Play بالعكس. تقول وثائق الفوترة من Google إن المستخدمين يتلقون رسالة بريد إلكتروني تحمل order ID فريدًا لكل عملية شراء لمنتج لمرة واحدة، ولعملية شراء الاشتراك الأولى، ولكل تجديد متكرر، وإنك تستطيع استخدام order ID لإدارة الاستردادات في Play Console. تبحث في Order management بـ order ID أو بعنوان البريد الإلكتروني الكامل للمستخدم، ثم تردّ المبلغ بنفسك.

في Google Play، يهم order ID أكثر لأنك أنت من يضغط الزر. يقول Play Console إن ردّ قيمة أحدث طلب اشتراك يزيل الاشتراك فورًا ويلغي التجديدات المستقبلية، بينما ردّ قيمة طلب أقدم هو استرداد فقط ويبقى الاشتراك نشطًا. الاستردادات الجزئية مدعومة فقط للطلبات المقدمة بعد مارس 2018، ولا يمكنك ردّ جزء من قيمة تطبيق مدفوع.

ضع order ID في مقدمة مسار دعم الاسترداد لديك

• اطلب order ID في نموذج الدعم، مع تلميح من سطر واحد: إنه موجود في رسالة إيصال Apple أو Google Play.
• على iOS، استدعِ Look Up Order ID، وفك ترميز كل معاملة، واعرض للدعم productId وpurchaseDate وrevocationDate وrevocationReason في شاشة واحدة.
• إذا كانت قيمة OrderLookupStatus هي 1، توقف واطلب الإيصال الصحيح. لا تمنح شيئًا.
• إذا كان revocationDate مضبوطًا، فتأكد من أن الوصول أُلغي بالفعل على خادمك، ثم أغلق التذكرة. بلا مجاملة إضافية.
• إذا لم يكن مضبوطًا وأراد العميل استعادة ماله، فوجّهه إلى reportaproblem.apple.com وأبقِ معالج CONSUMPTION_REQUEST لديك جاهزًا لنافذة الساعات الـ12. يرد RefundHalt على هذا الطلب ببيانات الاستهلاك التي تطلبها Apple.
• على Android، ابحث عن الطلب الصحيح تمامًا في Play Console قبل الاسترداد، واختر عن قصد بين الاسترداد فقط والاسترداد مع إلغاء الوصول.