# Certificats Apple Wallet
Pour émettre des cartes Apple Wallet affichant l'identité visuelle de votre entreprise et recevoir des mises à jour en temps réel, vous devez établir des certificats et des informations d'identification de notifications push via le Apple Developer Program.
Vous voulez le « pourquoi » avant le « comment » ? Commencez par [Apple & Google wallet](https://docs.thewalletcrew.io/fr/configurer/wallet/apple-and-google-wallet).
#### **Ce que vous accomplirez :**
* Créer un Pass Type ID qui identifie votre organisation en tant qu'émetteur de la carte
* Générer et configurer des certificats qui signent vos cartes Wallet
* Configurer le service de notifications push d'Apple (APNs) pour les mises à jour en temps réel des cartes
* Connecter vos identifiants de compte Apple Developer à la plateforme The Wallet Crew
#### **Prérequis :**
* Adhésion active au Apple Developer Program (99 $/an pour les organisations)
* Accès administrateur à votre compte Apple Developer
* Autorité pour créer des certificats et des clés d'authentification
* Accès à la console d'administration The Wallet Crew
#### **Exigences d'inscription au Apple Developer Program :**
Avant de commencer cette configuration, assurez-vous que votre organisation est inscrite au Apple Developer Program en tant que **Organisation** (et non en tant qu'individu). Cette inscription requiert :
* **Numéro D-U-N-S** de Dun & Bradstreet pour la vérification de l'entreprise
* **Adresse e-mail professionnelle** liée au domaine de votre entreprise (évitez les comptes personnels Gmail/Yahoo)
* **Site web accessible publiquement** reflétant l'identité légale de votre entreprise
* **Autorité juridique de signature** en tant que propriétaire, dirigeant ou employé autorisé pour signer les accords d'Apple
Si vous n'êtes pas encore inscrit, rendez-vous sur la page d'inscription au Apple Developer Program pour commencer le processus. L'inscription en tant qu'organisation (plutôt qu'en tant qu'individu) garantit que le nom de votre entreprise apparaît sur les cartes Wallet et permet la gestion multi-utilisateurs du compte.
#### **Choisir votre voie de configuration :**
* **Option 1 - Délégation de compte :** Accorder à l'équipe The Wallet Crew un accès administrateur pour tout configurer en votre nom (plus rapide, nécessite peu d'expertise technique)
* **Option 2 - Auto-configuration :** Gérer la configuration complète au sein de votre organisation (maintient un contrôle d'accès strict, nécessite des connaissances techniques du portail Apple Developer)
Les deux options offrent une fonctionnalité identique. L'Option 1 réduit la charge de travail de votre équipe mais nécessite d'accorder un accès administrateur temporaire à The Wallet Crew. L'Option 2 conserve un contrôle interne complet mais exige une familiarité avec les outils développeur d'Apple et la gestion des certificats.
## Lancement
### Option 1 — délégation de compte
Cette approche permet à l'équipe The Wallet Crew de gérer toute la configuration technique tout en conservant la propriété de votre compte Apple Developer. Vous accorderez un accès administrateur temporaire, et nous configurerons les certificats, clés et identifiants selon les bonnes pratiques d'Apple.
#### Accorder l'accès administrateur
Accédez à App Store Connect Users et connectez-vous avec les identifiants de votre compte Apple Developer.
Cliquez sur **Ajouter (+)** le bouton pour inviter un nouvel utilisateur. Saisissez `contact@neostore.cloud` comme adresse e-mail et assignez le rôle **Admin** . Ce niveau d'autorisation permet à l'équipe The Wallet Crew de créer des Pass Type IDs, de générer des certificats, de configurer des clés de notifications push et d'effectuer toutes les étapes nécessaires de configuration.
Page des utilisateurs App Store Connect montrant comment inviter un nouvel administrateur
L'équipe The Wallet Crew recevra une notification d'invitation et procédera à la création du Pass Type ID, à la génération des certificats et à la configuration d'APNs. Nous vous informerons lorsque la configuration sera terminée et fournirons la documentation de toutes les ressources créées. Vous pourrez révoquer cet accès administrateur après avoir confirmé que l'émission et les mises à jour des cartes Wallet fonctionnent correctement.
**Ce qui se passe ensuite :** Après que vous ayez accordé l'accès, nous créons votre Pass Type ID (formaté comme `pass.com.thewalletcrew.{tenantId}`), générons le certificat de signature, configurons les notifications push et téléversons le tout sur votre tenant. Cela se termine généralement en 1 à 3 jours ouvrables. Nous confirmerons par e-mail et partagerons un court résumé de ce qui a été créé.
### Option 2 — configuration par vos soins
Vous gérez la configuration complète dans votre compte Apple Developer et la console d'administration The Wallet Crew. Cette option nécessite une familiarité avec l'infrastructure de certificats d'Apple mais maintient un contrôle d'accès interne strict.
#### Comprendre les composants
Avant de continuer, il est utile de comprendre ce que vous allez créer :
Votre **Pass Type ID** est l'identifiant de l'émetteur (par exemple `pass.com.thewalletcrew.{tenantId}`). Le **CSR** est un fichier de demande généré dans The Wallet Crew qu'Apple utilise pour créer votre certificat. Le **certificat de signature** est ce qui signe cryptographiquement chaque carte. La **clé d'authentification APNs** est ce qui nous permet de déclencher des mises à jour pour les cartes déjà installées sur les appareils.
Suivez ces étapes pour configurer votre adhésion Apple pour The Wallet Crew.
{% stepper %}
{% step %}
**Connexion et ouverture des Identifiants**
1. Connectez-vous à la console du Apple Developer Program :
2. Allez dans Certificates, IDs & Profiles > Identifiers
{% endstep %}
{% step %}
**Créer un Pass Type ID**
1. Cliquez sur le bouton + et sélectionnez Pass Type IDs, puis cliquez sur Continuer.
2. Remplissez le formulaire. Définissez la description sur `carte d'adhésion`. Définissez l'identifiant sur la valeur indiquée dans The Wallet Crew sous `identifiant de type de carte`.
La valeur doit suivre le modèle `pass.com.thewalletcrew.{tenantId}` où `{tenantId}` est votre identifiant de marque.
{% hint style="danger" %}
Considérez l'identifiant du Pass Type ID comme permanent. Une fois que vous avez émis des cartes, le modifier casse généralement les mises à jour et peut nécessiter une ré-émission complète.
{% endhint %}
Copiez cette valeur exacte et collez-la dans le champ d'identifiant du Apple Developer Portal.
La console The Wallet Crew montrant la valeur de l'identifiant Pass Type à copier dans le Apple Developer Portal
{% hint style="warning" %}
Si vous devez modifier cet identifiant pour une raison quelconque, cliquez sur l'icône de verrou à côté du champ dans la console The Wallet Crew et coordonnez le changement avec votre contact chez The Wallet Crew pour assurer une synchronisation correcte. Ne le faites jamais sans le consentement de votre contact chez The Wallet Crew.
{% endhint %}
Cliquez **Continuer** pour revoir vos paramètres, puis cliquez sur **Enregistrer** pour créer le Pass Type ID.
{% endstep %}
{% step %}
**Accéder aux détails du Pass Type ID**
Après avoir enregistré votre Pass Type ID, vous serez renvoyé à la liste des identifiants. Localisez et cliquez sur le Pass Type ID que vous venez de créer pour ouvrir sa page de détails.
Liste des identifiants du Apple Developer Portal montrant le Pass Type ID créé
Dans la page de détails du Pass Type ID, cliquez sur le bouton **Créer un certificat** . Cela ouvrira le flux de création de certificat d'Apple
Laissez cet onglet de navigateur ouvert et passez à l'onglet de la console d'administration The Wallet Crew. Si vous ne l'avez pas ouvert, accédez à la configuration Apple de The Wallet Crew.
{% endstep %}
{% step %}
**Générer une Certificate Signing Request (CSR)**
Dans la console The Wallet Crew, repérez la section **Certificate Signing Request (CSR)** et cliquez sur **Générer CSR**. Le système créera un fichier de demande de signature cryptographique. Une fois la génération terminée, cliquez sur **Télécharger CSR** pour enregistrer le fichier sur votre ordinateur. Le nom de fichier sera similaire à `pass.cloud.thewalletcrew.{yourbrand}.csr`.
Configuration Apple de The Wallet Crew montrant l'action Générer CSR
Configuration Apple de The Wallet Crew montrant l'action Télécharger CSR
{% endstep %}
{% step %}
**Téléverser le CSR sur Apple et télécharger le certificat**
Retournez à l'onglet du Apple Developer Portal où le formulaire de création de certificat vous attend. Laissez le champ **Nom du certificat** vide afin qu'Apple le génère automatiquement, puis téléversez le fichier `.csr` que vous avez téléchargé depuis The Wallet Crew.
Cliquez **Continuer** pour traiter le CSR. Apple générera votre certificat de signature en utilisant les informations cryptographiques du CSR de The Wallet Crew.
Formulaire de création de certificat du Apple Developer Portal montrant le téléversement du CSR
Écran de téléchargement du Apple Developer Portal pour le certificat de pass généré
Sur la page de confirmation, cliquez sur **Télécharger** pour enregistrer le fichier du certificat (nommé `pass.cer`) sur votre ordinateur. Ce fichier de certificat est l'identifiant cryptographique qui signera toutes les cartes Wallet émises par votre organisation.
{% endstep %}
{% step %}
**Téléverser le certificat sur The Wallet Crew**
Retournez à la page Configuration Apple de The Wallet Crew. Repérez la section **Téléversement de certificat** .
Cliquez **Choisir le fichier** et sélectionnez le fichier de `pass.cer` certificat que vous avez téléchargé depuis Apple. Le système The Wallet Crew vérifiera que le certificat correspond à votre CSR et est correctement configuré.
Examinez les informations du certificat affichées (date d'expiration, détails de l'émetteur) et cliquez sur **Appliquer le certificat** pour compléter le téléversement. Le certificat est maintenant actif et sera utilisé pour signer toutes les cartes Wallet que vous créez.
Configuration Apple de The Wallet Crew montrant le téléversement du certificat et Appliquer le certificat
{% endstep %}
{% step %}
**Créer une clé d'authentification APNs dans Apple**
Le service de notifications push d'Apple (APNs) permet des mises à jour en temps réel des cartes Wallet après leur installation sur les appareils des utilisateurs. Lorsque vous mettez à jour un solde, modifiez les détails d'un événement ou changez le contenu d'une carte, APNs avertit l'appareil de l'utilisateur de télécharger la dernière version.
Accédez à la page des clés Apple Developer et cliquez sur le **bouton +** pour créer une nouvelle clé.
Remplissez le formulaire d'enregistrement de la clé : nommez la clé (par exemple « Wallet Push Notifications »), activez **le service de notifications push d'Apple (APNs)**, puis cliquez sur **Configurer** à côté d'APNs pour choisir l'environnement.
Dans la boîte de dialogue de configuration APNs, sélectionnez **Production** comme environnement (pas Sandbox). L'environnement Production est requis pour que les cartes Wallet reçoivent des mises à jour en usage réel. Cliquez sur **Enregistrer** pour confirmer ce paramètre.
Formulaire d'enregistrement de clé du Apple Developer Portal avec APNs activé
Cliquez **Continuer** pour revoir la configuration de votre clé, puis cliquez sur **Enregistrer** pour créer la clé. Apple affichera votre Key ID, c'est une information critique dont vous aurez besoin à l'étape suivante, copiez-la donc dans un endroit sûr.
Cliquez **Télécharger** pour enregistrer votre fichier de clé d'authentification (nommé `AuthKey_XXXXXXXXXX.p8`).
**Important :** Apple ne vous permet de télécharger ce fichier qu'une seule fois. Si vous le perdez, vous devrez révoquer cette clé et en créer une nouvelle. Stockez le fichier `.p8` téléchargé de manière sécurisée — traitez-le comme un mot de passe.
{% endstep %}
{% step %}
**Téléverser la clé APNs sur The Wallet Crew**
Accédez à la page de configuration APNs de The Wallet Crew.
Remplissez le formulaire de configuration APNs : collez le **Key ID** que vous avez copié depuis Apple (10 caractères) et téléversez le fichier `AuthKey_XXXXXXXXXX.p8` que vous avez téléchargé.
Cliquez **Enregistrer** ou **Appliquer** pour téléverser les identifiants APNs. La plateforme The Wallet Crew validera la clé et configurera les notifications push pour votre tenant.
Configuration APNs de The Wallet Crew montrant l'ID de clé et le téléversement du fichier .p8
**Configuration terminée :** Votre intégration Apple Wallet est maintenant entièrement configurée. Vous pouvez créer des cartes Wallet, elles seront signées avec votre certificat et capables de recevoir des mises à jour en temps réel via APNs.
{% endstep %}
{% endstepper %}
## Renouvellement du certificat
Les certificats Apple Wallet expirent annuellement et doivent être renouvelés pour continuer à émettre des cartes. Apple enverra des e-mails de rappel avant l'expiration, mais vous devriez renouveler les certificats de manière proactive au moins deux semaines avant la date d'expiration pour éviter toute interruption de service.
**Chronologie :** Le renouvellement du certificat prend environ 15 minutes. Les cartes existantes dans les Wallets des utilisateurs continuent de fonctionner pendant le renouvellement — il n'y a pas d'interruption.
{% stepper %}
{% step %}
**Initier le renouvellement du certificat dans Apple**
Connectez-vous au compte Apple Developer. Sélectionnez **Certificates, IDs & Profiles** dans la navigation de gauche, puis cliquez sur **Certificates**.
Cliquez sur **bouton +** pour créer un nouveau certificat. Sélectionnez **Pass Type ID Certificate** dans la liste des types de certificats, puis cliquez sur **Continuer**.
{% endstep %}
{% step %}
**Générer CSR dans The Wallet Crew**
1. Ouvrez la console d'administration The Wallet Crew et cliquez sur **Générer CSR**. Même si vous avez un ancien fichier CSR, vous devez en générer un nouveau pour le renouvellement.
2. Cliquez **Générer CSR** pour créer une nouvelle demande de signature de certificat. Une fois la génération terminée, cliquez sur **Télécharger CSR** pour enregistrer le fichier. Le nom du fichier sera similaire à `pass.cloud.thewalletcrew.{yourbrand}.csr`.
Configuration Apple de The Wallet Crew montrant Générer CSR pour le renouvellement
Configuration Apple de The Wallet Crew montrant Télécharger CSR pour le renouvellement
{% endstep %}
{% step %}
**Téléverser le CSR sur Apple et télécharger le certificat renouvelé**
Retournez au Apple Developer Portal. Dans le flux de création de certificat, téléversez le nouveau fichier CSR que vous venez de télécharger depuis The Wallet Crew.
Cliquez **Continuer** pour générer le certificat renouvelé, puis cliquez sur **Télécharger** pour enregistrer le nouveau `pass.cer` fichier.
Écran de téléchargement du Apple Developer Portal pour le certificat de pass renouvelé
{% endstep %}
{% step %}
**Téléverser le certificat renouvelé sur The Wallet Crew**
Accédez à la page Configuration Apple de The Wallet Crew. Téléversez le fichier de `pass.cer` certificat renouvelé.
Vérifiez la nouvelle date d'expiration pour confirmer qu'elle a été prolongée d'une année supplémentaire, puis cliquez sur **Appliquer le certificat**.
**Renouvellement terminé :** Votre certificat est renouvelé pour une année supplémentaire. Toutes les cartes existantes continuent de fonctionner sans interruption et les nouvelles cartes seront signées avec le certificat renouvelé.
Configuration Apple de The Wallet Crew montrant le téléversement du certificat renouvelé et Appliquer le certificat
{% endstep %}
{% endstepper %}
## FAQ
Qu'est-ce qu'un Pass Type ID et pourquoi en ai-je besoin ?
Un Pass Type ID est votre identifiant d'émetteur dans l'écosystème d'Apple (par exemple `pass.com.thewalletcrew.{tenantId}`). Il indique à Apple et aux appareils iOS quelle organisation est autorisée à émettre et signer des cartes, c'est pourquoi il est requis pour tout déploiement Apple Wallet. La plupart des marques utilisent un seul Pass Type ID pour tous leurs types de carte.
Quelle est la différence entre un CSR, un certificat et une clé APNs ?
Le CSR est un fichier de demande généré dans The Wallet Crew que vous téléversez sur Apple. Apple l'utilise pour générer votre certificat de signature, qui est la référence utilisée pour signer chaque carte. La clé APNs est distincte. Elle permet à The Wallet Crew de s'authentifier auprès du service Apple Push Notification afin de déclencher des mises à jour pour les cartes déjà installées sur les appareils.
Pourquoi ai-je besoin d'un certificat (.cer) et d'une clé APNs (.p8) ?
Apple Wallet divise la « confiance » en deux éléments. Le `.cer` certificat signe vos cartes, afin que les appareils puissent vérifier que la carte est authentique et n'a pas été altérée. La `.p8` clé APNs
authentifie le canal de push, afin qu'Apple accepte les notifications de mise à jour pour vos cartes et que les appareils sachent qu'ils doivent actualiser.
Combien de temps prend l'inscription au Apple Developer Program ?
Pour les organisations, Apple approuve généralement l'inscription en 2 à 5 jours ouvrables. Parfois, ils demandent des vérifications supplémentaires concernant votre numéro D‑U‑N‑S ou l'identité de l'entreprise. Une fois approuvée, la configuration du certificat Wallet prend habituellement environ 1 à 2 heures.
Puis-je utiliser un compte Apple Developer individuel au lieu d'une organisation ?
Techniquement oui, mais ce n'est rarement une bonne idée. Les comptes individuels affichent un nom personnel sur les cartes et ne prennent pas en charge les mêmes flux de travail d'équipe. La plupart des entreprises doivent s'inscrire en tant qu'organisation (même tarif de 99 $/an).
Que se passe-t-il si mon certificat expire ?
Si le certificat expire, l'émission et la mise à jour des cartes peuvent échouer. Les cartes déjà installées peuvent toujours s'afficher, mais elles ne recevront pas les mises à jour de manière fiable. Renouvelez au moins deux semaines avant l'expiration ; Apple envoie généralement des rappels environ 30 jours avant.
Dois-je renouveler la clé d'authentification APNs ?
Non. Les clés APNs n'expirent pas, vous ne les renouvelez donc pas. Vous ne renouvelle normalement que le certificat Pass Type ID chaque année. Si vous révoquez la clé APNs dans le portail d'Apple, vous devez en créer une nouvelle et la téléverser dans The Wallet Crew.
Puis-je révoquer l'accès délégué après la configuration initiale ?
Oui. Une fois que tout est configuré, vous pouvez supprimer l'utilisateur administrateur délégué d'App Store Connect et l'intégration continuera de fonctionner. La délégation n'est nécessaire que pour la configuration initiale, et elle est optionnelle pour les renouvellements.
Que faire si je ne trouve pas mon identifiant Pass Type dans la console The Wallet Crew ? **Vous le trouverez sur la page de configuration Apple sous**Identifiant de type de carte
. Si c'est vide ou s'il y a des erreurs, contactez votre interlocuteur chez The Wallet Crew. Votre tenant peut nécessiter une petite étape de configuration avant que la configuration Apple soit disponible.
Pourquoi dois-je utiliser l'environnement APNs « production » et non « sandbox » ?
Apple Wallet utilise l'environnement APNs de production, même pour les tests. Sandbox est destiné au développement d'apps iOS, pas aux cartes. Si vous configurez sandbox par erreur, les mises à jour push ne fonctionneront pas de manière fiable.
Comment savoir si ma configuration fonctionne correctement ?
Créez une carte de test dans The Wallet Crew et ajoutez-la à un iPhone. Si elle s'installe et affiche le nom de votre organisation, la signature fonctionne. Ensuite, modifiez un champ simple (comme un solde ou un texte) et confirmez que la carte installée se rafraîchit en quelques secondes.
Que dois-je faire du fichier .p8 de la clé APNs après le téléversement ? `.p8` Stockez le fichier
comme un mot de passe, idéalement dans un gestionnaire de mots de passe ou un stockage sécurisé de documents. Vous pourriez en avoir besoin ultérieurement pour des audits, des reconfigurations ou si Apple vous demande de vérifier votre configuration APNs. Ne le mettez pas dans le contrôle de version et ne l'envoyez pas par e-mail non chiffré.
Puis-je utiliser le même compte Apple Developer pour plusieurs marques ?
Nous avons déjà des cartes existantes. Comment migrer vers The Wallet Crew ?
Il s'agit d'une **migration** Oui, mais chaque marque doit utiliser son propre Pass Type ID. Un compte Apple Developer peut héberger plusieurs Pass Type IDs, chacun avec son propre certificat. Dans The Wallet Crew, chaque tenant correspond à sa propre configuration Apple.
de cartes en production, pas un « renouvellement » normal. **Pour Apple, la contrainte clé est l'identité de l'émetteur. En pratique, vous conservez le**même Pass Type ID
Suivez le guide dédié : [Move passes to The Wallet Crew](https://docs.thewalletcrew.io/fr/configurer/wallet/import-and-export/move-pass-from-and-to-the-wallet-crew/move-passes-to-the-wallet-crew).
, exportez les données techniques existantes des cartes (comme le numéro de série + le jeton d'authentification), puis redirigez les mises à jour vers The Wallet Crew. [Si vous quittez The Wallet Crew, utilisez :\
Exporter les cartes de The Wallet Crew vers un autre fournisseur](https://docs.thewalletcrew.io/fr/configurer/wallet/import-and-export/move-pass-from-and-to-the-wallet-crew/export-passes-from-the-wallet-crew-to-another-provider).
