> 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 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.
Vous voulez le « pourquoi » avant le « comment » ? Commencez par [Wallet Apple et Google](/configure/fr/advanced-configuration/wallet/apple-and-google-wallet.md).
#### **Ce que vous accomplirez :**
* Créer un ID de type de Carte qui identifie votre organisation comme l’émetteur de la carte
* Générer et configurer des certificats qui signent vos cartes Wallet
* Configurer le service de notifications push Apple (APNs) pour les mises à jour de carte en temps réel
* Connecter 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
#### **Exigences 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 inclus.` de `Apple Developer `
* **Adresse e-mail professionnelle** liée au domaine de votre entreprise (évitez les comptes Gmail/Yahoo personnels)
* **Site web accessible au public** reflétant l’identité légale de votre entreprise
* **Pouvoir de représentation légal** en tant que propriétaire, dirigeant ou employé autorisé à signer les accords d’Apple
Si ce n’est pas encore fait, rendez-vous sur la page d’inscription au programme Apple Developer pour commencer la procédure. Une 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 comptes multi-utilisateurs.
#### **Choix de votre méthode de configuration :**
* **Option 1 - Délégation de compte :** Accordez à l’équipe The Wallet Crew un accès administrateur pour tout configurer à votre place (la solution la plus rapide, avec un minimum d’expertise technique requis)
* **Option 2 - Auto-configuration :** Gérez l’intégralité de la configuration au sein de votre organisation (maintient un contrôle d’accès strict, nécessite une connaissance technique du portail Apple Developer)
Les deux options offrent exactement les mêmes fonctionnalités. 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 tandis 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 meilleures 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 **Ajouter (+)** bouton 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 ID de type de Carte, de générer des certificats, de configurer les clés de notifications 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 de The Wallet Crew recevra une notification d'invitation et procédera à la création de l'ID de type de 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 de Carte 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érons le certificat de signature, configurons les notifications push et téléversons tout vers votre tenant. 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
Vous gérez l'ensemble de la configuration dans votre compte Apple Developer et dans la console d'administration The Wallet Crew. Cette option nécessite une bonne connaissance de l'infrastructure de certificats d'Apple tout en conservant 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 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 %}
**Connexion et ouverture des Identifiants**
1. Connectez-vous à la console du programme Apple Developer :
2. Accédez à Certificats, IDs et profils > Identifiants
{% endstep %}
{% step %}
**Créer un ID de type de Carte**
1. Cliquez sur le bouton + et sélectionnez les ID de type de 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 `l'identifiant de 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 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.
Console The Wallet Crew montrant la valeur de l'identifiant de type de Carte à copier dans le portail Apple Developer
{% hint style="warning" %}
Si vous devez modifier cet identifiant pour quelque raison que ce soit, cliquez sur l'icône de verrouillage à côté du champ dans la console The Wallet Crew et coordonnez le changement avec votre contact chez The Wallet Crew afin d'assurer une synchronisation correcte. Ne le faites jamais sans le consentement de votre contact chez The Wallet Crew.
{% endhint %}
Cliquez sur **Continuer** pour vérifier vos paramètres, puis cliquez sur **Enregistrer** pour créer l'ID de type de Carte.
{% endstep %}
{% step %}
**Accéder aux détails de l'ID de type de Carte**
Après avoir enregistré votre ID de type de Carte, vous serez renvoyé à la liste des identifiants. Localisez l'ID de type de Carte que vous venez de créer et cliquez dessus 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 bouton **Créer le certificat** Cela ouvrira le flux de création de certificat d'Apple
Laissez cet onglet du 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 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 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 du fichier sera similaire à `Carte.cloud.thewalletcrew.{yourbrand}.csr`.
La configuration Apple Wallet Crew montrant l’action Generate CSR
La configuration Apple de Wallet Crew montrant l'action Télécharger le CSR
{% endstep %}
{% step %}
**Téléversez le CSR sur Apple et téléchargez le certificat**
Retournez à l’onglet du navigateur du portail Apple Developer où se trouve le formulaire de création du certificat. 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 sur **Continuer** pour traiter la CSR. Apple générera votre certificat de signature en utilisant les informations cryptographiques provenant de la CSR de The Wallet Crew.
Formulaire de création de certificat du portail Apple Developer montrant l’envoi du CSR
Écran de téléchargement du certificat sur l’Apple Developer Portal pour le certificat de 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 Wallet passes émis par votre organisation.
{% endstep %}
{% step %}
**Téléverser le certificat à l'équipe Wallet**
Revenez à la page de configuration Apple de The Wallet Crew. Localisez le **Téléversement du certificat** section.
Cliquez sur **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 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 tous les pass Wallet que vous créez.
La configuration Apple de Wallet Crew affichant le téléversement du certificat et le bouton Appliquer le certificat
{% endstep %}
{% step %}
**Créer la clé d’authentification APNs dans Apple**
Le service Apple Push Notification (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 d’un événement ou changez tout contenu d’une 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 carte (par exemple « Notifications push Wallet »), activez **le service Apple Push Notifications (APNs)**, puis cliquez sur **Configurez** à côté d’APNs pour choisir l’environnement.
Dans la boîte de dialogue de configuration d’APNs, sélectionnez **Production** 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 Apple Developer avec APNs activé
Cliquez sur **Continuer** pour vérifier la configuration de votre clé, puis cliquez **Enregistrer** pour créer la clé. Apple affichera votre ID de clé ; c’est une information cruciale dont vous aurez besoin à l’étape suivante, alors copiez-la dans un endroit sûr.
Cliquez sur **Télécharger** pour enregistrer votre fichier de clé d’authentification (nommé `AuthKey_XXXXXXXXXX.p8`).
**Important :** Apple vous permet de télécharger ce fichier une seule fois. Si vous le perdez, vous devrez révoquer cette clé et en créer une nouvelle. Conservez le `.p8` fichier téléchargé 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é** 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 sur **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 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, et elles seront signées avec votre certificat et pourront 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.
**Calendrier :** 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, IDs 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 de Carte** dans la liste des types de certificats, 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 ancien fichier CSR, vous devez en générer un nouveau pour le renouvellement.
2. Cliquez sur **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 la génération du CSR pour le renouvellement
Configuration Apple de The Wallet Crew montrant le téléchargement du 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 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 sur **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é dans The Wallet Crew**
Accédez à la page de configuration Apple de The Wallet Crew. Téléversez le renouvelé `carte.cer` fichier du certificat.
Vérifiez la nouvelle date d’expiration pour confirmer qu’elle a été prolongée d’un an supplémentaire, puis cliquez **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 l’application du certificat
{% endstep %}
{% endstepper %}
## 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 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 téléversez à 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 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 vos 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 de push, afin qu’Apple accepte les notifications de mise à jour pour vos cartes et que les appareils sachent qu’ils doivent se mettre à jour.
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 l’objet `Votre numéro D-U-N-S est inclus.` 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 plutôt qu’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 (au 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-le 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 ne renouvelez normalement chaque année que le certificat d’ID de type de Carte. Si vous révoquez la clé APNs dans le portail Apple, vous devez en créer une nouvelle et la téléverser vers 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 locataire 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 vérifiez 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 stockage sécurisé de 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 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 ID de type de Carte. Un compte Apple Developer peut héberger plusieurs ID de type de Carte, chacun avec son propre certificat. Dans The Wallet Crew, chaque locataire est associé à sa propre configuration Apple.
Nous avons déjà des cartes existantes. Comment migrons-nous vers The Wallet Crew ?
Il s’agit d’une **migration** de cartes en production, et non d’un simple « renouvellement ».
Pour Apple, la contrainte clé est l’identité de l’émetteur. En pratique, vous 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é : [Migrer 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 depuis 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.