> 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-wallet-et-google-wallet/certificats-apple-wallet.md).
# Certificats Apple Wallet
Pour émettre des cartes Apple Wallet qui affichent l’image de marque de votre entreprise et reçoivent des mises à jour en temps réel, vous devez établir des certificats et des identifiants de notification push via le programme Apple Developer Program.
Vous voulez comprendre le « pourquoi » avant le « comment » ? Commencez par [Wallet Apple et Google](/configure/fr/advanced-configuration/wallet/apple-wallet-et-google-wallet.md).
#### **Ce que vous accomplirez :**
* Créez un ID de type de carte qui identifie votre organisation comme l’émetteur de la carte
* Générez et configurez les certificats qui signent vos cartes Wallet
* Configurez le service Apple Push Notification (APNs) pour les mises à jour en temps réel des cartes
* Connectez les identifiants de votre 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
* 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 Apple Developer Program :**
Avant de commencer cette configuration, assurez-vous que votre organisation est inscrite au Apple Developer Program en tant qu’ **Organisation** (et non en tant qu’individu). Cette inscription nécessite :
* **D-U-N-S Number** de Dun & Bradstreet pour la vérification de l’entreprise. Apple l’envoie généralement par e-mail avec pour objet `Votre numéro D-U-N-S est joint.` de `Apple Developer `
* **Adresse e-mail professionnelle** associée au domaine de votre entreprise (évitez les comptes Gmail/Yahoo personnels)
* **Site web accessible publiquement** reflétant l’identité juridique de votre entreprise
* **Pouvoir de signature juridique** en tant que propriétaire, dirigeant ou employé autorisé à 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 la procédure. Une 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 de compte multi-utilisateur.
#### **Choisir votre parcours de configuration :**
* **Option 1 - Délégation de compte :** Accordez à l’équipe The Wallet Crew un accès administrateur pour tout configurer en votre nom (la solution la plus rapide, nécessitant un minimum d’expertise technique)
* **Option 2 - Configuration autonome :** Gérez l’intégralité de la configuration au sein de votre organisation (conserve un contrôle d’accès strict, nécessite une connaissance technique du portail Apple Developer)
Les deux options offrent la même fonctionnalité. 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 maintient un contrôle interne complet, mais exige une familiarité avec les outils de développement 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 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 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 **Administrateur** rôle. Ce niveau d’autorisation permet à l’équipe The Wallet Crew de créer des IDs de type de 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 de l’ID de type Carte, à la génération du certificat 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 pouvez révoquer cet accès administrateur après avoir confirmé que l’émission des cartes Wallet et les mises à jour fonctionnent correctement.
**Que se passe-t-il 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 ouvrables. Nous 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’ensemble de la configuration dans votre compte Apple Developer et dans la console d’administration Wallet Crew. Cette option nécessite une bonne connaissance de l’infrastructure de certificats d’Apple, mais maintient un contrôle d’accès interne strict.
#### Comprendre les composants
Avant de poursuivre, il est utile de comprendre ce que vous créez :
Votre **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 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 Cartes 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 Identifiants**
1. Connectez-vous à la console du programme Apple Developer :
2. Accédez à Certificates, IDs & Profiles > Identifiants
{% 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 indiquée dans The Wallet Crew sous `l'identifiant du type 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 de type de Carte comme permanent. Une fois que vous avez émis des Cartes, 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 portail Apple Developer.
La console Wallet Crew affichant la valeur de l'identifiant de 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 cadenas à côté du champ dans la console Wallet Crew et coordonnez la modification avec votre point de contact chez Wallet Crew afin d'assurer une synchronisation correcte. Ne le faites jamais sans le consentement de votre point de contact chez Wallet Crew.
{% endhint %}
Cliquez **Continuer** pour examiner vos paramètres, puis cliquez sur **Enregistrer** pour créer l’ID de type Carte.
{% endstep %}
{% step %}
**Accédez aux détails de l’ID de type Carte**
Après avoir enregistré votre ID de type Carte, vous serez redirigé vers la liste des identifiants. Repérez et cliquez sur l’ID de type 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 Carte créé
Sur la page de détails de l’ID de type Carte, cliquez sur le **Créer un certificat** bouton. 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érez 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 la 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 la CSR** pour enregistrer le fichier sur votre ordinateur. Le nom du fichier sera similaire à `Carte.cloud.thewalletcrew.{yourbrand}.csr`.
La configuration Apple de The Wallet Crew affichant l'action Generate CSR
La configuration Apple de The Wallet Crew affichant l'action Download CSR
{% endstep %}
{% step %}
**Téléversez le CSR vers Apple et téléchargez le certificat**
Retournez à l'onglet du navigateur Apple Developer Portal où le formulaire de création du certificat est en attente. Laissez le **Nom du certificat** champ vide afin qu'Apple le génère automatiquement, puis téléversez le `.csr` fichier 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 l’équipe Wallet.
Formulaire de création de certificat du portail développeur Apple affichant le téléversement du CSR
Écran de téléchargement du certificat du portail développeur Apple pour le certificat Carte généré
Sur la page de confirmation, cliquez **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 tous les passes Wallet émis par votre organisation.
{% endstep %}
{% step %}
**Téléversez le certificat à l'équipe Wallet**
Revenez à la page de configuration Apple de Wallet Crew. Localisez le **Téléversement du certificat** section.
Cliquez **Choisir un fichier** et sélectionnez le `Carte.cer` fichier de certificat que vous avez téléchargé depuis Apple. Le système Wallet Crew vérifiera que le certificat correspond à votre 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éversement. Le certificat est maintenant actif et sera utilisé pour signer tous les pass Wallet que vous créez.
La configuration Apple de 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 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 le solde d’une Carte, modifiez les détails de l’événement ou modifiez tout contenu de Carte, APNs notifie 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 **service de notifications push 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** environnement (pas Sandbox). L'environnement de production est requis pour que les cartes Wallet reçoivent des mises à jour lors d'une utilisation réelle. 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 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.
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. Conservez le fichier téléchargé `.p8` de manière sécurisée — 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 **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é.
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 locataire.
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 maintenant 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 afin d'éviter toute interruption de service.
**Chronologie :** Le renouvellement du certificat prend environ 15 minutes. Les cartes existantes dans les Wallet des utilisateurs continuent de fonctionner pendant le renouvellement — il n'y a aucune interruption.
{% stepper %}
{% step %}
**Lancer le renouvellement du certificat dans 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 d’ID de type Carte** dans la liste des types de certificats, puis cliquez **Continuer**.
{% endstep %}
{% step %}
**Générer le CSR dans The Wallet Crew**
1. Ouvrez la console d'administration de The Wallet Crew et cliquez **Générer la 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. Cliquez **Générer la CSR** pour créer une nouvelle demande de signature de certificat. Une fois la génération terminée, cliquez **Télécharger la 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 développeur Apple. Dans le flux de création du 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 `Carte.cer` fichier.
Écran de téléchargement du portail développeur Apple pour le certificat de Carte renouvelé
{% endstep %}
{% step %}
**Téléverser 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’un an, 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 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 d’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 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 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 elle 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 de notifications 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 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 joint.` 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 ?
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 flux de travail 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 continuer à 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, donc vous ne les renouvelez pas. En général, vous ne renouvelez chaque année que le certificat d’identifiant de type de Carte. 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 tout 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 génère 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’applications 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 le téléversement ?
Stockez le `.p8` fichier comme un mot de passe, idéalement dans un gestionnaire de mots de passe ou un espace de stockage sécurisé des documents. Vous pourriez en avoir besoin plus tard pour des audits, une reconfiguration 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 ?
Oui, mais chaque marque doit 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 est associé à 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 « renouvellement » normal.
Pour Apple, la contrainte clé 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/importation-et-exportation/migration-des-cartes/migrer-les-cartes-vers-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/importation-et-exportation/migration-des-cartes/exporter-les-cartes-de-twc-vers-un-autre-fournisseur.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-wallet-et-google-wallet/certificats-apple-wallet.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.