إعداد Apple App Store

ستحتاج إلى ما يلي، ويستغرق نحو 5 دقائق:

• وصول Admin أو Account Holder إلى App Store Connect.
• مفتاح API من App Store Connect، يمنحك ثلاث قيم: Issuer ID وKey ID وملف مفتاح خاص .p8.

لا تُرفع أي ملفات إلى Apple، ولا يُجرى أي تغيير على ملف تطبيقك الثنائي.

يأتي كل من Issuer ID وKey ID وملف .p8 من المكان نفسه في App Store Connect:

1. سجّل الدخول إلى App Store Connect، وافتح Users and Access، ثم اختر علامة التبويب Integrations واختر In-App Purchase من قسم Keys على اليسار.
2. انسخ Issuer ID المعروض أعلى الصفحة. إنها قيمة واحدة لكامل الحساب، تتشاركها كل مفتاح تُنشئه.
3. انقر زر + بجوار Active لإنشاء مفتاح جديد. سمّه Refund Sensor، واضبط Access على Admin، ثم انقر Generate.
4. انسخ Key ID من المفتاح الجديد، ثم انقر صف المفتاح لـ Download ملف .p8. تسمح Apple بتنزيله مرة واحدة فقط، فاحفظه في مكان آمن.

في Refund Sensor، افتح Add app واختر Apple App Store. الصق Issuer ID وKey ID، وارفع ملف .p8، ثم انقر Continue. نتحقق من المفتاح لدى Apple ونشفّره أثناء التخزين بـ AES-256-GCM قبل حفظه. ولا يُعرض بعدها أبدًا ولا يظهر في السجلات.

بعد التحقق من المفتاح، يجلب Refund Sensor كل تطبيق يمكنه رؤيته في حساب App Store Connect الخاص بك. ابحث بالاسم أو بمعرّف الحزمة، واختر التطبيقات التي تريد الدفاع عنها، وانقر Connect. يحصل كل تطبيق مرتبط على عنوان webhook خاص به.

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

1. انسخ عنوان webhook الخاص بالتطبيق من Refund Sensor (يظهر على بطاقة التطبيق المرتبط).
2. في App Store Connect، افتح صفحة App Information لذلك التطبيق ومرّر إلى App Store Server Notifications.
3. انقر Set Up URL لـ Production Server URL، والصق العنوان واحفظ. ثم افعل الشيء نفسه لـ Sandbox Server URL كي تصل حركة الاختبار والحركة الحية معًا إلى Refund Sensor.

لكل تطبيق مرتبط عنوانه الفريد، نُنشئه لك ونعرضه على بطاقته في Refund Sensor. انسخه من هناك بدلًا من كتابته يدويًا.

تسمح Apple بعنوان إشعارات خادم واحد فقط، وإذا كانت منصة اشتراكات تستخدمه بالفعل فلا تستبدله. بدلًا من ذلك، اطلب من تلك المنصة تحويل نسخة من كل إشعار Apple خام إلى عنوان webhook الخاص بـ Refund Sensor، فيظل كلاهما يعمل. راجع تحويل الإشعارات للخطوات الدقيقة لـ RevenueCat وAdapty وApphud.

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