> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/apple-and-google-wallet/apple-wallet-certificates.md).
# Certificats Apple Wallet
Configurez le compte Apple Developer, les certificats et les identifiants d’envoi APNs qui permettent à The Wallet Crew d’émettre des cartes Apple Wallet pour une marque.
Pour émettre des cartes Apple Wallet qui affichent l’identité propre de la marque et reçoivent des mises à jour en temps réel, les certificats et les identifiants de notification push doivent être établis via le programme Apple Developer.
Les identifiants restent auprès de la marque : Apple les délivre à la marque, qui délègue l’émission des cartes à The Wallet Crew.
Vous voulez le « pourquoi » avant le « comment » ? Commencez par [Apple et Google Wallet](/configure/fr/advanced-configuration/wallet/apple-and-google-wallet.md).
## Avant de commencer
### Ce que couvre ce guide
* Créez un ID de type de Carte qui identifie l’organisation comme l’émetteur de la carte
* Générez et configurez les certificats qui signent les cartes Wallet
* Configurez le service Apple Push Notification (APNs) pour les mises à jour en temps réel des cartes
* Connectez les identifiants du compte Apple Developer à la plateforme The Wallet Crew
### Prérequis
* Adhésion active au programme Apple Developer (99 $/an pour les organisations)
* Accès administrateur au compte Apple Developer
* Autorisation de créer des certificats et des clés d’authentification
* Accès à la console d’administration The Wallet Crew
### Conditions d’inscription au programme Apple Developer
Avant de commencer cette configuration, assurez-vous que l’organisation s’est inscrite au programme Apple Developer en tant que **Organisation** (et non en tant que particulier). Cette inscription nécessite :
* **numéro D-U-N-S** de Dun & Bradstreet pour la vérification de l’entreprise. Apple l’envoie généralement par e-mail avec l’objet `Votre numéro D-U-N-S est inclus.` de `Apple Developer `
* **Adresse e-mail professionnelle** liée au domaine de l’entreprise (évitez les comptes Gmail/Yahoo personnels)
* **Site web accessible publiquement** reflétant l’identité juridique de l’entreprise
* **Pouvoir juridique de signature** en tant que propriétaire, dirigeant ou employé autorisé à signer les accords d’Apple
Si l’inscription n’a pas encore eu lieu, rendez-vous sur la page d’inscription au programme Apple Developer pour commencer le processus. L’inscription en tant qu’organisation (plutôt qu’en tant que particulier) garantit que le nom de l’entreprise apparaît sur les cartes Wallet et permet la gestion de compte multi-utilisateur.
## Lancement
### Choisissez un mode de configuration
* **Option 1 — délégation du compte :** Accordez à The Wallet Crew un accès administrateur pour configurer l’intégration. C’est l’option la plus rapide.
* **Option 2 — auto-configuration :** Gérez l’ensemble de la configuration au sein de l’organisation. Cela maintient un contrôle d’accès strict et nécessite une bonne connaissance d’Apple Developer.
Les deux options offrent les mêmes fonctionnalités. La délégation du compte réduit la charge de mise en œuvre. L’auto-configuration conserve un contrôle interne complet.
### Option 1 — délégation du compte
Cette approche permet à l’équipe The Wallet Crew de gérer toute la configuration technique tandis que la marque conserve la propriété de son compte Apple Developer. Un accès administrateur temporaire est accordé, et nous configurons les certificats, les clés et les identifiants selon les bonnes pratiques d’Apple.
#### Accorder l’accès administrateur
Accédez à Utilisateurs d’App Store Connect et connectez-vous avec les identifiants du compte Apple Developer.
Cliquez sur le **Ajouter (+)** bouton pour inviter un nouvel utilisateur. Saisissez `contact@neostore.cloud` comme adresse e-mail et attribuez **Administrateur** rôle. Ce niveau d'autorisation permet à l'équipe Wallet Crew de créer des IDs de type Carte, de générer des certificats, de configurer des clés de notification push et d'effectuer toutes les étapes de configuration nécessaires.
Page des utilisateurs d’App Store Connect montrant comment inviter un nouvel utilisateur administrateur
L’équipe Wallet Crew recevra une notification d’invitation et procédera à la création du Carte Type ID, à la génération du certificat et à la configuration d’APNs. Nous informons la marque une fois la configuration terminée et fournissons la documentation de toutes les ressources créées. Cet accès administrateur peut être révoqué après avoir confirmé que l’émission et les mises à jour des cartes Wallet fonctionnent correctement.
**Que se passe-t-il ensuite :** Une fois l'accès accordé, nous créons l'ID de type de Carte (formaté comme `Carte.com.thewalletcrew.{tenantId}`), générer le certificat de signature, configurer les notifications push et téléverser tout dans le locataire. Cela se termine généralement en 1 à 3 jours ouvrables. Nous confirmerons par e-mail et partagerons un bref résumé de ce qui a été créé.
### Option 2 — configuration par vous-même
La configuration complète est gérée dans le compte Apple Developer de la marque et dans la console d’administration de Wallet Crew. Cette option nécessite une bonne connaissance de l’infrastructure de certificats d’Apple, mais elle maintient un contrôle d’accès interne strict.
#### Comprendre les composants
Avant de continuer, il est utile de comprendre ce qui est créé :
Le **ID de type de Carte** est l'identifiant de l'émetteur (par exemple `Carte.com.thewalletcrew.{tenantId}`). Le **CSR** est un fichier de demande généré dans The Wallet Crew qu'Apple utilise pour créer le certificat. Le **certificat de signature** est ce qui signe cryptographiquement chaque Carte. Le **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 le programme d’adhésion Apple pour The Wallet Crew.
{% stepper %}
{% step %}
**Connectez-vous et ouvrez Identifiers**
1. Connectez-vous à la console du programme développeur Apple :
2. Allez dans Certificates, IDs & Profiles > Identifiers
{% endstep %}
{% step %}
**Créez un ID de type Carte**
1. Cliquez sur le bouton + et sélectionnez les IDs de type Carte, puis cliquez sur Continuer.
2. Remplissez le formulaire. Définissez la description sur `Carte d’adhésion`. Définissez l’identifiant sur la valeur affichée dans The Wallet Crew sous `identifiant de type de Carte`.
La valeur doit suivre le modèle `Carte.com.thewalletcrew.{tenantId}` où `{tenantId}` est l’identifiant de la marque.
{% hint style="danger" %}
Traitez l’identifiant Carte Type ID comme permanent. Une fois que des cartes ont été émises, le modifier casse généralement les mises à jour et peut forcer une réémission complète.
{% endhint %}
Copiez cette valeur exacte et collez-la dans le champ d’identifiant du portail Apple Developer.
La console The Wallet Crew affichant la valeur de l’identifiant de type de Carte à copier dans Apple Developer Portal
{% hint style="warning" %}
Si cet identifiant doit être modifié pour une raison quelconque, cliquez sur l’icône de cadenas à côté du champ dans la console The Wallet Crew et coordonnez la modification avec le point de contact chez The Wallet Crew afin de garantir une synchronisation correcte. Ne le faites jamais sans le consentement de ce point de contact.
{% endhint %}
Cliquez **Continuer** pour examiner les paramètres, puis cliquez sur **Enregistrer** pour créer le Carte Type ID.
{% endstep %}
{% step %}
**Accédez aux détails du Carte Type ID**
Après avoir enregistré le Carte Type ID, Apple revient à la liste des identifiants. Repérez et cliquez sur le Carte Type ID que vous venez de créer pour ouvrir sa page de détails.
Liste des identifiants du portail Apple Developer montrant le Carte Type ID créé
Sur la page des détails du Carte Type ID, cliquez sur le **Créer le certificat** bouton. Cela ouvrira le flux de création de certificat d'Apple
Laissez cet onglet de navigateur ouvert et basculez vers l'onglet de la console d'administration The Wallet Crew. S'il n'est pas ouvert, accédez à la configuration Apple de The Wallet Crew.
{% endstep %}
{% step %}
**Générer une demande de signature de certificat (CSR)**
Dans la console The Wallet Crew, localisez la **Demande de signature de certificat (CSR)** section 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 le CSR** pour enregistrer le fichier localement. Le nom du fichier sera similaire à `carte.cloud.thewalletcrew.{yourbrand}.csr`.
La configuration Apple de Wallet Crew montrant l’action Generate CSR
La configuration Apple de Wallet Crew montrant l’action Download CSR
{% endstep %}
{% step %}
**Importer le CSR vers Apple et télécharger le certificat**
Revenez à l’onglet du navigateur du portail Apple Developer où le formulaire de création de certificat est en attente. Laissez le **Nom du certificat** champ vide afin qu’Apple le génère automatiquement, puis importez le `.csr` fichier téléchargé depuis The Wallet Crew.
Cliquez **Continuer** pour traiter le CSR. Apple générera le certificat de signature à l'aide des informations cryptographiques du CSR de The Wallet Crew.
Formulaire de création de certificat du portail Apple Developer montrant le téléversement du CSR
Écran de téléchargement du certificat du portail Apple Developer pour le certificat de Carte généré
Sur la page de confirmation, cliquez sur **Télécharger** pour enregistrer le fichier du certificat (nommé `Carte.cer`) localement. Ce fichier de certificat est l'identifiant cryptographique qui signera toutes les cartes Wallet émises par l'organisation.
{% endstep %}
{% step %}
**Téléversez le certificat vers The Wallet Crew**
Revenez à la page de configuration Apple de The Wallet Crew. Localisez le **Téléversement du certificat** section.
Cliquez **Choisir un fichier** et sélectionnez le `Carte.cer` fichier de certificat téléchargé depuis Apple. Le système The Wallet Crew vérifiera que le certificat correspond au CSR et qu'il est correctement configuré.
Vérifiez les informations du certificat affichées (date d'expiration, détails de l'émetteur) et cliquez sur **Appliquer le certificat** pour terminer le téléchargement. Le certificat est maintenant actif et sera utilisé pour signer toutes les cartes Wallet créées.
La configuration Apple de Wallet Crew montrant le téléchargement du certificat et le bouton Appliquer le certificat
{% endstep %}
{% step %}
**Créer une clé d'authentification APNs dans Apple**
Le service de notifications push Apple (APNs) permet des mises à jour en temps réel des cartes Wallet après leur installation sur les appareils des clients. Lorsqu'un solde de carte, les détails d'un événement ou tout autre contenu de carte sont mis à jour, APNs avertit l'appareil du client afin de télécharger la dernière version.
Accédez à la page Clés du développeur Apple et cliquez sur le **bouton +** pour créer une nouvelle clé.
Complétez le formulaire d'enregistrement de la clé : nommez la clé (par exemple « Notifications push Wallet »), activez **service de notifications push Apple (APNs)**, puis cliquez **Configurer** à côté d’APNs pour choisir l’environnement.
Dans la boîte de dialogue de configuration APNs, sélectionnez **Production** l’environnement (et non Sandbox). L’environnement de production est requis pour que les cartes Wallet reçoivent des mises à jour en conditions réelles d’utilisation. Cliquez **Enregistrer** pour confirmer ce paramètre.
Formulaire d’enregistrement de clé du portail Apple Developer avec APNs activé
Cliquez **Continuer** pour vérifier la configuration de la clé, puis cliquez **Enregistrer** pour créer la clé. Apple affichera l’ID de clé, une information essentielle nécessaire à l’étape suivante, donc copiez-la dans un emplacement sûr.
Cliquez **Télécharger** pour enregistrer le fichier de clé d’authentification (nommé `AuthKey_XXXXXXXXXX.p8`).
**Important :** Apple ne permet de télécharger ce fichier qu’une seule fois. S’il est perdu, la clé doit être révoquée et une nouvelle créée. Conservez le fichier téléchargé `.p8` en lieu sûr — traitez-le comme un mot de passe.
{% endstep %}
{% step %}
**Téléverser la clé APNs vers The Wallet Crew**
Accédez à la page de configuration APNs de The Wallet Crew.
Remplissez le formulaire de configuration APNs : collez le **ID de clé** copié depuis Apple (10 caractères) et téléversez le `AuthKey_XXXXXXXXXX.p8` fichier téléchargé depuis Apple.
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 le locataire.
Configuration APNs de The Wallet Crew affichant l’ID de clé et le téléversement du fichier .p8
**Configuration terminée :** L’intégration Apple Wallet est maintenant entièrement configurée. Des cartes Wallet peuvent être créées, et elles seront signées avec le certificat et capables de recevoir des mises à jour en temps réel via APNs.
{% endstep %}
{% endstepper %}
## Renouvellement du certificat
Les certificats Apple Wallet expirent chaque année et doivent être renouvelés pour continuer à émettre des cartes. Apple enverra des e-mails de rappel avant l’expiration, mais les certificats doivent être renouvelés de manière proactive au moins deux semaines avant la date d’expiration afin d’éviter toute interruption de service.
{% hint style="info" %}
**Calendrier :** Le renouvellement du certificat prend environ 15 minutes. Les cartes existantes continuent de fonctionner pendant le renouvellement, sans interruption.
{% endhint %}
{% hint style="warning" %}
### Le renouvellement n’affecte pas la production
Le renouvellement d’un certificat dans l’environnement de préproduction ne met pas à jour la production. Téléversez le certificat renouvelé séparément dans le locataire de production.
{% endhint %}
{% stepper %}
{% step %}
**Lancer le renouvellement du certificat chez Apple**
Accédez au compte Apple Developer et connectez-vous. Sélectionnez **Certificats, identifiants et profils** dans la navigation de gauche, puis cliquez **Certificats**.
Cliquez sur le **bouton +** pour créer un nouveau certificat. Sélectionnez **Certificat de type Carte** dans la liste des types de certificats, puis cliquez **Continuer**.
{% endstep %}
{% step %}
**Générer la CSR dans The Wallet Crew**
1. Ouvrez la console d’administration The Wallet Crew et cliquez **Générer CSR**. Même si un fichier CSR précédent existe, un nouveau doit être généré 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 **Télécharger le CSR** pour enregistrer le fichier. Le nom du fichier sera similaire à `carte.cloud.thewalletcrew.{yourbrand}.csr`.
Configuration Apple de The Wallet Crew montrant Générer le CSR pour le renouvellement
Configuration Apple de The Wallet Crew montrant Télécharger le CSR pour le renouvellement
{% endstep %}
{% step %}
**Téléversez le CSR vers Apple et téléchargez le certificat renouvelé**
Retournez au portail Apple Developer. Dans le workflow de création de certificat, téléversez le nouveau fichier CSR tout juste téléchargé depuis The Wallet Crew.
Cliquez **Continuer** pour générer le certificat renouvelé, puis cliquez **Télécharger** pour enregistrer le nouveau `Carte.cer` fichier.
Écran de téléchargement du portail Apple Developer pour le certificat de Carte renouvelé
{% endstep %}
{% step %}
**Téléversez le certificat renouvelé vers The Wallet Crew**
Accédez à la page de configuration Apple de The Wallet Crew. Téléversez le `Carte.cer` fichier du certificat.
Vérifiez la nouvelle date d'expiration pour confirmer qu'elle a été prolongée d'une année, puis cliquez **Appliquer le certificat**.
**Renouvellement terminé :** Le 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 %}
## Résoudre les problèmes de renouvellement du certificat
### Plusieurs certificats dans Apple Developer
Deux certificats pour le même ID de type de Carte sont attendus pendant le renouvellement. Le certificat existant reste actif pendant qu'Apple ajoute le certificat renouvelé.
The Wallet Crew utilise automatiquement le certificat actif le plus récent. L'ancien certificat expire naturellement et ne nécessite pas de révocation.
Ne révoquez pas l'ancien certificat tant qu'il reste valide. La révocation peut interrompre brièvement l'émission des Cartes avant que le certificat renouvelé ne se propage.
Après l'expiration de l'ancien certificat, il peut être supprimé dans Apple Developer. Le supprimer n'a aucun impact sur la plateforme The Wallet Crew.
### Le téléversement du CSR affiche un ancien fichier
Lors du renouvellement, l'écran de téléversement du CSR dans la console d'administration peut afficher une liste déroulante de fichiers précédents. Cela se produit lorsque la session du navigateur met en cache les fichiers précédemment sélectionnés.
Sélectionner **Téléverser un nouveau fichier** ou **Parcourir** à côté de la liste déroulante. Le lien peut apparaître visuellement atténué, mais il accepte tout de même un nouveau fichier CSR.
Si le lien est indisponible, ouvrez la page dans une fenêtre privée ou de navigation incognito. Cela démarre une nouvelle session de navigateur. Si le problème persiste, contactez l'assistance The Wallet Crew avec une capture d'écran. L'équipe peut téléverser directement le certificat renouvelé dans le tenant.
## FAQ
Qu'est-ce qu'un ID de type de Carte et pourquoi en ai-je besoin ?
Un ID de type de Carte est l'identifiant de l'émetteur dans l'écosystème Apple (par exemple `Carte.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 ID de type de Carte 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 et téléversé vers Apple. Apple l'utilise pour générer le certificat de signature, qui est l'identifiant utilisé pour signer chaque Carte. La clé APNs est distincte. C'est elle qui permet à The Wallet Crew de s'authentifier auprès du service Apple Push Notification afin de déclencher les mises à jour des Cartes déjà installées sur les appareils.
Pourquoi ai-je besoin d'un certificat (.cer) et d'une clé APNs (.p8) ?
Apple Wallet répartit la « confiance » en deux éléments. Le `.cer` certificat signe les Cartes, afin que les appareils puissent vérifier que la Carte est authentique et n'a pas été altérée. Le `.p8` La clé APNs authentifie le canal push, de sorte qu'Apple accepte les notifications de mise à jour pour ces Cartes et que les appareils savent qu'ils doivent se rafraîchir.
Combien de temps prend l'inscription au programme Apple Developer ?
Pour les organisations, Apple approuve généralement l'inscription en 2 à 5 jours ouvrables. Parfois, Apple demande une vérification supplémentaire concernant le numéro D‑U‑N‑S ou l'identité de l'entreprise. Le numéro D‑U‑N‑S est généralement envoyé par e-mail avec pour objet `Votre numéro D-U-N-S est inclus.` de `Apple Developer `. Une fois approuvé, la configuration du certificat Wallet prend généralement environ 1 à 2 heures.
Puis-je utiliser un compte Apple Developer individuel au lieu d'un compte d'organisation ?
C'est techniquement possible, mais rarement une bonne idée. Les comptes individuels affichent un nom personnel sur les Cartes et ne prennent pas en charge les mêmes workflows d'équipe. La plupart des entreprises devraient s'inscrire en tant qu'organisation (même prix 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, elles ne sont donc pas renouvelées. Seul le certificat de l'ID de type de Carte est normalement renouvelé chaque année. Si la clé APNs est révoquée dans le portail Apple, une nouvelle doit être créée et téléversée vers The Wallet Crew.
Puis-je révoquer l'accès délégué après la configuration initiale ?
Oui. Une fois tout configuré, l'utilisateur administrateur délégué peut être supprimé 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 facultative pour les renouvellements.
Et si je ne trouve pas mon identifiant de type de Carte dans la console The Wallet Crew ?
Il se trouve sur la page de configuration Apple sous **Identifiant de type de Carte**. S'il est vide ou affiche une erreur, contactez le point de contact chez The Wallet Crew. Le 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 sandbox est configuré 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 l'organisation, la signature fonctionne. Modifiez ensuite un champ simple (comme un solde ou du texte) et confirmez que la Carte installée se met à jour en quelques secondes.
Que dois-je faire du fichier de clé APNs .p8 après le téléversement ?
Conservez le `.p8` fichier comme un mot de passe, idéalement dans un gestionnaire de mots de passe ou un espace de stockage sécurisé de documents. Il pourra être nécessaire plus tard pour des audits, une reconfiguration, ou si Apple demande une vérification de la configuration APNs. Ne le validez pas dans un système de 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 ?
Oui, mais chaque marque doit utiliser son propre ID de type de Carte. Un compte Apple Developer peut héberger plusieurs IDs de type de Carte, chacun avec son propre certificat. Dans The Wallet Crew, chaque tenant correspond à sa propre configuration Apple.
Nous avons déjà des Cartes existantes. Comment migrer vers The Wallet Crew ?
Il s'agit d'une **migration** de Cartes en production, pas d'un « renouvellement » normal.
Pour Apple, la contrainte principale est l'identité de l'émetteur. En pratique, conservez le **même ID de type de Carte**, exportez les données techniques de la Carte existante (comme le numéro de série + le jeton d'authentification), puis redirigez les mises à jour vers The Wallet Crew.
Suivez le guide dédié : [Déplacer les Cartes vers The Wallet Crew](/configure/fr/advanced-configuration/wallet/import-and-export/pass-migration/move-passes-to-the-wallet-crew.md).
Lorsque vous quittez The Wallet Crew, utilisez : [Exporter les Cartes de The Wallet Crew vers un autre fournisseur](/configure/fr/advanced-configuration/wallet/import-and-export/pass-migration/export-passes-from-twc-to-another-provider.md).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/apple-and-google-wallet/apple-wallet-certificates.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
