العودة إلى المدونةعام

بطاقات ولاء Apple Wallet وGoogle Wallet: 20 سؤالاً

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

عشرون سؤالاً عن بطاقات الولاء في Apple Wallet وGoogle Wallet، مُجابة من وثائق المطورين لدى Apple وGoogle، مع ذكر الصفحة لكل جواب.

بواسطة Zakaria Fahim · ٥ سبتمبر ٢٠٢٦ · 8 دقائق قراءة

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

جوابان يخصّان Fideliya لا المنصتين، وهما يقولان ذلك. وما عدا ذلك هو ما تقوله المنصة عن نفسها.

المسألةApple WalletGoogle Wallet
نمط الولاءstoreCardصف ولاء وكائن ولاء
كيف يضيفها الزبونMail أو Safari بنوع application/vnd.apple.pkpassرابط JWT موقّع
كيف تُحدَّثخدمة الويب لديك مع إشعار عبر HTTPSتحديث الصف أو الكائن عبر الواجهة البرمجية
حد الرسائلغير مذكور كعدد3 رسائل تُطلق إشعاراً خلال 24 ساعة
وعد التسليمالإشعارات ليست مضمونة التسليميجب أن تكون الإشعارات مفعّلة لدى المستخدم
تطبيق مرافقالبطاقات ينبغي ألا تشترطهالروابط تعمل في الويب والبريد والرسائل

ما بطاقة الولاء في المحفظة؟

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

أي نمط بطاقة هو بطاقة الولاء؟

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

هل يلزم تطبيق؟

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

كيف تُضاف البطاقة على iPhone؟

عبر Mail أو Safari. تنصّ Apple على أن كليهما يدعم البطاقات منذ iOS 6 وmacOS v10.8.2، وأنهما على iOS يضيفان البطاقات إلى المكتبة مباشرة، وأنهما على macOS يستعملان iCloud لإضافتها إلى أجهزة المستخدم العاملة بـ iOS. وكلاهما يتوقع نوع MIME المسمّى application/vnd.apple.pkpass.

كيف تُضاف البطاقة على Android؟

عبر رابط Add to Google Wallet. تصفه Google بأنه عنوان مُولَّد ديناميكياً يحمل رمز JSON Web Token مُرمَّزاً وموقّعاً، على الصورة pay.google.com/gp/v/save متبوعاً بذلك الرمز، وتقول إنه يعمل حيثما تعمل الروابط، بما في ذلك المواقع والبريد والرسائل القصيرة.

ماذا داخل رابط Add to Google Wallet؟

رمز JWT موقّع يصف البطاقة. تذكر Google أن الطول الآمن للرمز المُرمَّز 1800 حرف، وتوصي بعرض الرابط زرَّ Add to Google Wallet على الأسطح التي تدعم الصور القابلة للربط، وتشير إلى أن الحفظ لا يبدأ إلا في سياق هوية Google مسجّلة الدخول.

هل يوافق الزبون على البطاقة؟

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

كيف تُحدَّث البطاقة؟

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

هل الإشعارات مضمونة؟

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

كم رسالة تستطيع بطاقة Google إرسالها؟

تذكر Google حداً أقصى قدره 3 رسائل تُطلق إشعار دفع خلال 24 ساعة، وتصف TEXT_AND_NOTIFY بأنه نوع الرسالة الذي يضيف رسالة إلى تفاصيل البطاقة ويُطلق الإشعار. وإشعارات التحديث على حقول بعينها تخضع للسقف نفسه.

ما رسالة التغيير؟

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

ما الذي لا يتغيّر أبداً؟

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

ما الذي يميّز البطاقة؟

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

ما الرموز الشريطية المقبولة؟

تسمّي Apple صيغ PKBarcodeFormatQR وPKBarcodeFormatPDF417 وPKBarcodeFormatAztec وPKBarcodeFormatCode128 صالحةً من iOS 9، فلا تحتاج أي منها إلى بديل. وتشير أيضاً إلى أن watchOS لا يدعم Code128، وأن البطاقة التي لا تحمل سوى رمز Code128 لا تعرض هناك أي رمز شريطي.

كم حقلاً يتسع الوجه؟

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

ما صور بطاقة المتجر؟

تذكر Apple الشعار والأيقونة والشريط لنمط بطاقة المتجر. ويقع الشعار في الزاوية العليا بجانب نص الشعار بمساحة 160 في 50 نقطة، وتشير Apple إلى أنه ينبغي أن يكون أضيق من ذلك عادةً. والأيقونة، التي تظهر على شاشة القفل وفي Mail، قياسها 29 في 29 نقطة.

هل تظهر البطاقة بأكثر من لغة؟

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

هل تظهر البطاقة قرب المحل؟

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

ما الصف والكائن في Google Wallet؟

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

ماذا يلزم النشاط قبل الإصدار؟

خمسة أمور، أربعة من Apple وواحد من Google.

  1. معرّف نوع بطاقة مطابق لشهادة التوقيع.
  2. معرّف فريق مطابق لمعرّف الفريق في تلك الشهادة.
  3. توقيع PKCS #7 يتضمن شهادة WWDR الوسيطة.
  4. خدمة ويب على HTTPS، تشترطها Apple لكل اتصال ببطاقة.
  5. حساب مُصدِر لدى Google Wallet، ورمز موقّع لكل رابط حفظ.

المصادر

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

كل جواب أعلاه من إحدى سبع صفحات أولية، جُلبت كلها يوم 5 سبتمبر 2026: فصول About Wallet وPass Design and Creation وDistributing Passes وUpdating a Pass من دليل Apple للمطورين، ودليل Google لبطاقات الولاء، ودليل الإضافة من الويب، ودليل إطلاق الإشعارات. وتربط ملاحظة المصادر أعلى المقال كل سؤال بصفحته. ولا يظهر في هذه الصفحة أي إحصاء أو سعر أو نسبة، ولا شيء فيها مستنتَج من مادة تسويقية.

Fideliya منصة برامج ولاء أصلية للمحفظة للأعمال الصغيرة. وجانب Apple موصوف في بطاقات الولاء في Apple Wallet، والخطط في صفحة الأسعار.

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

ما بطاقة الولاء في المحفظة؟

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

أي نمط بطاقة لدى Apple هو بطاقة الولاء؟

بطاقة المتجر. تنصّ Apple على أن نمط storeCard يناسب بطاقات ولاء المتاجر وبطاقات الخصم وبطاقات النقاط وبطاقات الهدايا. ويُصدر Fideliya بطاقة ولائه بوصفها storeCard، فتستقر في Wallet تحت النمط نفسه الذي تستقر تحته بطاقة متجر.

هل يحتاج الزبون إلى تطبيق لاستخدام بطاقة المحفظة؟

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

كيف يضيف الزبون البطاقة على iPhone؟

عبر Mail أو Safari، اللذين تقول Apple إنهما يضيفان البطاقات مباشرة إلى المكتبة على iOS ويتوقعان نوع MIME المسمّى application/vnd.apple.pkpass. ويقدّم Fideliya بطاقة Apple بهذا النوع من صفحة الانضمام، فتُفتح وتُضاف دون خطوة وسيطة.

كيف يضيف الزبون البطاقة على Android؟

عبر رابط Add to Google Wallet، الذي تصفه Google بأنه عنوان مُولَّد ديناميكياً يحمل رمز JSON Web Token مُرمَّزاً وموقّعاً. ويبني Fideliya هذا الرابط على pay.google.com/gp/v/save لكل زبون، فتعمل صفحة الانضمام نفسها على Android وiPhone.

ماذا يحمل رابط Add to Google Wallet؟

رمز JWT موقّع داخل عنوان. تذكر Google أن الطول الآمن للرمز المُرمَّز 1800 حرف، وأن الحفظ لا يبدأ إلا في سياق هوية Google مسجّلة الدخول. ويوقّع Fideliya الرمز على الخادم، فلا يفعل الزبون سوى الضغط على زر.

هل يوافق الزبون على إضافة البطاقة؟

نعم. تشترط Apple إذناً صريحاً وتنصّ على أن المستخدم يجب أن يرى البطاقة ويوافق عليها قبل إضافتها إلى Wallet. فلا تستطيع بطاقة Fideliya أن تظهر في محفظة دون أن ينظر إليها الزبون ويختار الاحتفاظ بها.

كيف تُحدَّث البطاقة بعد إصدارها؟

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

هل إشعارات المحفظة مضمونة الوصول؟

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

كم رسالة تستطيع بطاقة Google Wallet إرسالها؟

تذكر Google حداً أقصى قدره 3 رسائل تُطلق إشعار دفع خلال 24 ساعة. ويبقى Fideliya دون ذلك بكثير: الرصيد رسالة واحدة شهرياً في Free وثلاث في Pro وعشر في Enterprise، محسوبة بالشهر لا باليوم.

ما رسالة التغيير في بطاقة Apple؟

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

هل يتغيّر الرقم التسلسلي أو رمز المصادقة؟

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

ما الذي يميّز البطاقة تمييزاً فريداً؟

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

ما صيغ الرموز الشريطية التي تقبلها بطاقة Apple؟

تسمّي Apple صيغ QR وPDF417 وAztec وCode128 صالحةً من iOS 9، وتشير إلى أن watchOS لا يدعم Code128. ويستخدم Fideliya صيغة PKBarcodeFormatQR، وهي الأوسع قراءةً والتي يقرأها ماسحه العامل في المتصفح.

كم حقلاً يتسع وجه البطاقة؟

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

ما الصور التي تستخدمها بطاقة المتجر؟

تذكر Apple الشعار والأيقونة والشريط لنمط بطاقة المتجر، مع 160 في 50 نقطة مخصصة للشعار و29 في 29 للأيقونة. ويضع Fideliya شعار النشاط وصورة الغلاف في هذه الخانات نفسها، ولذلك يُقصّ الشعار العريض بدل تصغيره.

هل تظهر البطاقة الواحدة بأكثر من لغة؟

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

هل تظهر بطاقة الولاء على شاشة القفل قرب المحل؟

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

ما الفرق بين الصف والكائن في Google Wallet؟

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

ماذا يلزم النشاط قبل إصدار البطاقات؟

تشترط Apple معرّف نوع بطاقة مطابقاً لشهادة التوقيع، ومعرّف فريق، وتوقيع PKCS #7 يتضمن شهادة WWDR الوسيطة، وخدمة ويب على HTTPS. وتشترط Google حساب مُصدِر ورمزاً موقّعاً. ويحتفظ Fideliya بذلك كله مركزياً، فيقدّم النشاط شعاراً ومكافأة.

هل أنت مستعد لإنشاء بطاقة الولاء الخاصة بك؟

إعداد في أقل من 5 دقائق. لا توجد تطبيقات على عملائك تحميلها.

ابدأ مجاناً
قارن Fideliya بالبدائلاحسب عائد الاستثمار
بطاقات ولاء Apple Wallet وGoogle Wallet: 20 سؤالاً — Fideliya Blog