> 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
Pour émettre des cartes Apple Wallet affichant l’image de marque de votre entreprise et recevoir des mises à jour en temps réel, vous devez établir des certificats et des identifiants de notification push via le programme Apple Developer.
Vous voulez comprendre le « pourquoi » avant le « comment » ? Commencez par [Wallet Apple et Google](/configure/fr/advanced-configuration/wallet/apple-and-google-wallet.md).
## Avant de commencer
### Ce que vous accomplirez
* Créer un ID de type de Carte qui identifie votre organisation comme l’émetteur des cartes
* Générer et configurer les certificats qui signent vos cartes Wallet
* Configurer Apple Push Notification service (APNs) pour les mises à jour de Carte en temps réel
* Connectez les identifiants de votre 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 à votre 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 votre 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 joint.` de `Apple Developer `
* **Adresse e-mail professionnelle** liée au domaine de votre entreprise (évitez les comptes Gmail/Yahoo personnels)
* **Site web accessible publiquement** reflétant l’identité juridique de votre entreprise
* **Autorité légale de signature** en tant que propriétaire, dirigeant ou employé autorisé à signer les accords d’Apple
Si vous ne vous êtes pas encore inscrit, 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 votre entreprise apparaît sur les cartes Wallet et permet la gestion de compte multi-utilisateur.
## Lancement
### Choisissez une méthode de configuration
* **Option 1 — délégation du compte :** Accordez à l’équipe 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 la configuration complète 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 d’implémentation. 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 pendant que vous conservez la propriété de votre compte Apple Developer. Vous accorderez un accès administrateur temporaire, et nous configurerons les certificats, les clés et les identifiants conformément aux bonnes pratiques d’Apple.
#### Accorder l’accès administrateur
Accédez à Utilisateurs d’App Store Connect et connectez-vous avec les identifiants de votre compte Apple Developer.
Cliquez sur le **bouton Ajouter (+)** pour inviter un nouvel utilisateur. Saisissez `contact@neostore.cloud` comme adresse e-mail et attribuez le rôle **Admin** Ce niveau d’autorisation permet à l’équipe The Wallet Crew de créer des ID de type de Carte, de générer des certificats, de configurer les clés de notification push et d’achever 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 de l’ID de type Carte, à la génération du certificat et à la configuration APNs. Nous vous informerons une fois la configuration terminée et vous fournirons la documentation de toutes les ressources créées. Vous pourrez révoquer cet accès administrateur après avoir confirmé que l’émission des cartes Wallet et les mises à jour fonctionnent correctement.
**Ce qui se passe ensuite :** Après avoir accordé l’accès, nous créons votre ID de type de Carte (formaté comme `carte.com.thewalletcrew.{tenantId}`), générez le certificat de signature, configurez les notifications push et téléversez tout dans votre locataire. Cela se termine généralement en 1 à 3 jours ouvrés. Nous vous le confirmerons par e-mail et partagerons un bref résumé de ce qui a été créé.
### Option 2 — configuration par vous-même
Vous gérez l'intégralité de la configuration dans votre compte Apple Developer et la console d'administration de l'équipe Wallet. 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 que vous créez :
Votre **ID de type Carte** est l'identifiant de l'émetteur (par exemple `carte.com.thewalletcrew.{tenantId}`). Le **CSR** est un fichier de demande généré dans l'équipe Wallet qu'Apple utilise pour créer votre 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 Carte déjà installées sur les appareils.
Suivez ces étapes pour configurer votre 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. Accédez à Certificates, IDs & Profiles > Identifiers
{% endstep %}
{% step %}
**Créer 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 du type de Carte`.
La valeur doit suivre le modèle `carte.com.thewalletcrew.{tenantId}` où `{tenantId}` est l'identifiant de votre marque.
{% hint style="danger" %}
Considérez l'identifiant du type de Carte comme permanent. Une fois que vous avez émis des Carte, le modifier casse généralement les mises à jour et peut imposer une réémission complète.
{% endhint %}
Copiez cette valeur exacte et collez-la dans le champ d'identifiant du Apple Developer Portal.
La console Wallet affichant la valeur de l'identifiant du type de Carte à copier dans Apple Developer Portal
{% hint style="warning" %}
Si vous devez modifier cet identifiant pour quelque raison que ce soit, cliquez sur l'icône de verrou à côté du champ dans la console Wallet et coordonnez la modification avec votre interlocuteur chez Wallet afin d'assurer une synchronisation correcte. Ne le faites jamais sans le consentement de votre interlocuteur chez Wallet.
{% endhint %}
Cliquer **Continuer** pour vérifier vos paramètres, puis cliquez **Enregistrer** pour créer l’ID de type de Carte.
{% endstep %}
{% step %}
**Accédez aux détails de l’ID de type de Carte**
Après l’enregistrement de votre ID de type de Carte, vous serez renvoyé à la liste des identifiants. Repérez et cliquez sur l’ID de type de Carte que vous venez de créer pour ouvrir sa page de détails.
Liste des identifiants du portail Apple Developer montrant l’ID de type de Carte créé
Sur la page de détails de l’ID de type de Carte, cliquez sur le **Créer un certificat** bouton. Cela ouvrira le flux de création de certificat d'Apple
Laissez cet onglet du navigateur ouvert et basculez vers 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 demande de signature de certificat (CSR)**
Dans la console The Wallet Crew, recherchez la **demande de signature de certificat (CSR)** section et cliquez sur **Générer le 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 sur votre ordinateur. Le nom de fichier sera similaire à `Carte.cloud.thewalletcrew.{yourbrand}.csr`.
Configuration Apple de The Wallet Crew montrant l'action Générer le CSR
Configuration Apple de The Wallet Crew montrant l'action Télécharger le CSR
{% endstep %}
{% step %}
**Téléverser le CSR vers Apple et télécharger le certificat**
Retournez à l'onglet du navigateur du portail Apple Developer où le formulaire de création de certificat vous attend. Laissez le **Nom du certificat** champ vide afin qu'Apple le génère automatiquement, puis importez le `.csr` fichier que vous avez téléchargé depuis The Wallet Crew.
Cliquer **Continuer** pour traiter le CSR. Apple générera votre certificat de signature à l'aide des informations cryptographiques provenant 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 de certificat (nommé `Carte.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 vers The Wallet Crew**
Revenez à la page de configuration Apple de The Wallet Crew. Repérez la **Téléversement du certificat** section.
Cliquer **Choisir un fichier** et sélectionnez le `Carte.cer` fichier de certificat que vous avez téléchargé depuis Apple. Le système The Wallet Crew validera que le certificat correspond à votre CSR et 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é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 l'action Appliquer le certificat
{% endstep %}
{% step %}
**Créer une clé d'authentification APNs dans Apple**
Apple Push Notification service (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 de carte, modifiez les détails d'un événement ou tout contenu de carte, APNs avertit l'appareil de l'utilisateur afin 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 **Apple Push Notifications service (APNs)**, puis cliquez sur **Configurer** à côté de APNs pour choisir l’environnement.
Dans la boîte de dialogue de configuration APNs, sélectionnez **Production** l’environnement (pas Sandbox). L’environnement de production est requis pour que les cartes Wallet reçoivent des mises à jour en utilisation réelle. Cliquez **Enregistrer** pour confirmer ce paramètre.
Formulaire d’enregistrement de clé du portail développeur Apple avec APNs activé
Cliquer **Continuer** pour vérifier la configuration de votre clé, puis cliquez **Enregistrer** pour créer la clé. Apple affichera votre Key ID ; c’est une information essentielle dont vous aurez besoin à l’étape suivante, alors copiez-la dans un endroit sûr.
Cliquer **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. Conservez le fichier téléchargé `.p8` en lieu sûr—traitez-le comme un mot de passe.
{% endstep %}
{% step %}
**Importer la clé APNs dans 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 `AuthKey_XXXXXXXXXX.p8` fichier que vous avez téléchargé.
Cliquer **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 le Key ID et le téléversement du fichier .p8
**Configuration terminée :** Votre intégration Apple Wallet est désormais entièrement configurée. Vous pouvez créer des cartes Wallet, et 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 chaque année 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.
{% 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 en staging ne met pas à jour la production. Téléversez le certificat renouvelé séparément dans le tenant de production.
{% endhint %}
{% stepper %}
{% step %}
**Lancer le renouvellement du certificat dans Apple**
Accédez au compte développeur Apple et connectez-vous. Sélectionnez **Certificats, IDs & profils** dans la navigation de gauche, puis cliquez **Certificats**.
Cliquez sur le **bouton +** pour créer un nouveau certificat. Sélectionnez **Certificat d’ID de type Carte** dans la liste des types de certificat, puis cliquez **Continuer**.
{% endstep %}
{% step %}
**Générez le CSR dans The Wallet Crew**
1. Ouvrez la console d’administration The Wallet Crew et cliquez **Générer le CSR**. Même si vous disposez d’un fichier CSR précédent, vous devez en générer un nouveau pour le renouvellement.
2. Cliquer **Générer le 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 de 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échargez le CSR sur Apple et téléchargez le certificat renouvelé**
Retournez au portail Apple Developer. Dans le flux de création du certificat, importez le nouveau fichier CSR que vous venez de télécharger depuis The Wallet Crew.
Cliquer **Continuer** pour générer le certificat renouvelé, puis cliquez sur **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 %}
**Importez le certificat renouvelé dans The Wallet Crew**
Accédez à la page de configuration Apple de The Wallet Crew. Importez le renouvelé `Carte.cer` fichier du certificat.
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 l’importation 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 identifiant de type de Carte sont attendus lors du 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.
Une fois l’ancien certificat expiré, il peut être supprimé dans Apple Developer. Sa suppression n’affecte pas la plateforme The Wallet Crew.
### L’importation du CSR affiche un ancien fichier
Pendant le renouvellement, l’écran d’importation du CSR dans la console d’administration peut afficher une liste déroulante des fichiers précédents. Cela se produit lorsque la session du navigateur met en cache les fichiers sélectionnés auparavant.
Sélectionner **Importer un nouveau fichier** ou **Parcourir** à côté de la liste déroulante. Le lien peut paraître visuellement atténué, mais il accepte tout de même un nouveau fichier CSR.
Si le lien n’est pas disponible, ouvrez la page dans une fenêtre privée ou de navigation privée. 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 importer directement le certificat renouvelé dans le tenant.
## FAQ
Qu’est-ce qu’un identifiant de type de Carte et pourquoi en ai-je besoin ?
Un identifiant de type de Carte est votre identifiant d’é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 identifiant de type de Carte pour tous leurs types de Cartes.
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 importez vers Apple. Apple l’utilise pour générer votre certificat de signature, qui est l’identifiant utilisé pour signer chaque Carte. La clé APNs est distincte. C’est ce qui 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 répartit 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 push, afin qu’Apple accepte les notifications de mise à jour pour vos Cartes et que les appareils sachent 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 du numéro D‑U‑N‑S ou de 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 joint.` de `Apple Developer `. Une fois approuvée, 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 ?
Techniquement, oui, mais c’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 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 de 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, donc vous ne les renouvelez pas. Vous renouvelez normalement uniquement le certificat d’identifiant de type de Carte chaque année. Si vous révoquez la clé APNs dans le portail Apple, vous devez en créer une nouvelle et l’importer 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 facultative pour les renouvellements.
Que faire si je ne trouve pas mon identifiant de type de Carte dans la console The Wallet Crew ?
Vous le trouverez sur la page de configuration Apple, sous **Identifiant de type de Carte**. S’il est vide ou renvoie une erreur, 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. Modifiez ensuite un champ simple (comme un solde ou du texte) et confirmez que la Carte installée se rafraîchit en quelques secondes.
Que dois-je faire du fichier de clé APNs .p8 après l’importation ?
Stockez le `.p8` fichier comme un mot de passe, idéalement dans un gestionnaire de mots de passe ou un espace de stockage de documents sécurisé. Vous pourrez en avoir besoin plus tard pour des audits, une reconfiguration ou si Apple vous demande de vérifier votre configuration APNs. Ne l’ajoutez pas au 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 devrait utiliser son propre identifiant de type de Carte. Un seul compte Apple Developer peut héberger plusieurs identifiants 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, et non d’un simple « renouvellement ».
Pour Apple, la contrainte principale est l’identité de l’émetteur. En pratique, vous conservez le **même identifiant 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).
Si 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.