# Ajouter une carte de fidélité au portefeuille du téléphone

> Peu de commerces ont créé une carte de portefeuille, d'où l'absence de bouton. Ce qui marche sur iPhone et Android, et ce qu'exigent les scanners.

Source: https://apps.swtlm.com/fr/blog/add-a-loyalty-card-to-your-phone-wallet · TLM Apps — focused mobile apps from a team of engineers.
Published: 2026-08-06 · Updated: 2026-08-06 · TLM Software Design

Il n'y a généralement pas de bouton « Ajouter au portefeuille », parce qu'une
carte de portefeuille doit être créée et signée par celui qui a émis la carte —
et la plupart des cafés, salles de sport et supermarchés ne l'ont jamais fait. Ce
qui marche à la place, c'est de transformer la carte en carte de portefeuille
vous-même : sur iPhone, un fichier signé qui atterrit dans Apple Wallet ; sur
Android, une application qui stocke le code-barres et l'affiche en plein écran.
Et le détail qui décide si la caisse le lit, c'est le *format* du code, pas le
numéro.

## Pourquoi le bouton manque

Apple Wallet ne stocke pas des photos de cartes. Il stocke des fichiers
`.pkpass` : de petits paquets signés contenant le contenu du code-barres, son
format, les champs affichés et un certificat prouvant qui les a créés. La
signature est tout l'intérêt. C'est elle qui empêche n'importe qui de s'établir
une carte d'embarquement.

La conséquence est directe. Si votre enseigne locale ne s'est jamais enregistrée
comme émetteur de cartes, il n'y a aucune carte à ajouter, et aucun réglage
d'Apple Wallet n'y changera rien. Google Wallet fonctionne pareil pour les
programmes de fidélité partenaires.

La question pratique n'est donc pas « comment ajouter cette carte » mais « qui va
en faire une carte de portefeuille ».

## Ce dont un scanner a réellement besoin

C'est la partie absente de la plupart des guides, et c'est elle qui décide si
vous allez rester en caisse à rouvrir une application.

**Le bon format.** Un code-barres n'est pas un numéro ; c'est un numéro encodé
dans une symbologie précise. Les codes à barres longs des cartes de fidélité sont
en général du Code 128 ou du Code 39, les codes produits du EAN-13, et les codes
carrés du QR ou de l'Aztec. Les mêmes chiffres dans la mauvaise symbologie
produisent un code qui a l'air plausible et ne se scanne comme rien.

**Assez de taille et de contraste.** Une carte de portefeuille affiche le code
seul, en grand, en noir sur blanc. Une photo de la carte entière affiche un
code-barres de deux centimètres avec un logo à côté, à la luminosité qu'avait le
téléphone.

**Un écran que le scanner sait lire.** Les scanners à caméra — la vitre plate de
la plupart des caisses — lisent très bien un écran. Les scanners laser à main ne
lisent pas un écran, à aucune luminosité, parce qu'ils travaillent sur de la
lumière laser réfléchie. Quand un employé dit « ça ne marche pas avec les
téléphones », c'est généralement cela, et aucune application ne peut le corriger.

Les deux portefeuilles augmentent automatiquement la luminosité de l'écran
lorsqu'une carte est ouverte. Une application qui se contente d'afficher une
image ne le fait peut-être pas. Si un code ne passe pas, la pleine luminosité est
la première chose à essayer, et elle marche plus souvent qu'elle ne le devrait.

## Sur iPhone

1. **Vérifiez si le commerce publie déjà une carte.** Le bouton « Ajouter à Apple
   Wallet », s'il existe, se trouve dans leur propre application ou en bas d'un
   courriel de reçu. C'est toujours la meilleure option : une vraie carte met à
   jour son solde.
2. **Sinon, générez-en une.** Une application qui lit la carte et produit un
   `.pkpass` signé met la carte dans Wallet correctement : sur l'écran
   verrouillé, dans la liste du double-clic, rangée avec tout le reste.
3. **Comparez le code-barres à la carte la première fois**, avant de vous y fier.
   Confrontez les chiffres imprimés sous le code à ceux du code généré.

## Sur Android

Google Wallet accepte les cartes de fidélité des programmes partenaires, et il y
en a bien moins que de cartes de fidélité. Pour tout le reste, ce qui marche en
caisse est une application qui stocke le code et l'affiche en plein écran avec la
luminosité montée.

C'est moins élégant qu'un portefeuille système et fonctionnellement identique au
moment du scan. Ce que vous perdez, c'est l'accès depuis l'écran verrouillé et
l'apparition automatique ; ce que vous gardez, c'est un code qui se lit.

## Ce qu'une carte générée ne fera pas

Bon à savoir avant d'échanger une pile de plastique contre un écran.

**Elle ne mettra pas à jour son propre solde.** À une vraie carte émise par le
commerce, on peut pousser un nouveau total de points, une nouvelle date
d'expiration, une nouvelle offre. Une carte générée à partir d'une photo est un
instantané du code-barres : le code continue de marcher, car le code n'est que
votre numéro de compte, mais le nombre de points imprimé dessus est figé au
moment où vous l'avez créée. Pour une carte de fidélité, c'est en général sans
importance — la caisse consulte le solde à partir du numéro. Pour tout ce dont la
valeur change, non.

**Elle ne survivra pas à une réémission de la carte.** Nouvelle carte, nouveau
numéro, nouvelle carte de portefeuille.

**Ce n'est pas une carte de paiement.** Aucun des deux portefeuilles ne vous
laissera en générer une, et rien qui exige la puce ou la piste magnétique ne se
reproduit à partir d'une photographie du recto. Cette limite est délibérée sur
les deux plateformes, et c'est le même instinct que derrière tout ce qui figure
sur la [page Outils](https://apps.swtlm.com/fr/tools) : faire une chose correctement plutôt que celle
d'à côté mal.

**Elle ne sera pas partout la bienvenue.** Certains programmes de fidélité
stipulent dans leurs conditions que la carte leur appartient et ne peut être
copiée. En pratique, personne ne s'offusque d'un code-barres sur un écran, mais
un pass de musée ou un titre de transport nominatif est une autre affaire qu'une
carte à tampons de café.

## Comment saisir le numéro sans le taper

Taper seize chiffres depuis une carte usée est l'endroit où cela tourne mal. Le
chemin rapide est une photo : pointez l'appareil vers la carte et laissez
l'application lire à la fois les chiffres et la symbologie sur le code-barres
imprimé.

[AI Wallet Pass](https://apps.swtlm.com/ai-wallet-pass) est ce que nous avons construit pour cette
étape. Vous photographiez la carte, l'application en extrait le numéro et le
format du code-barres, et produit une carte signée pour Apple Wallet sur iOS ou
la range dans son propre portefeuille sur Android.

Un détail mérite d'être énoncé clairement, car c'est précisément ce qu'il faut
vérifier dans toute application de ce genre : lire la carte exige un serveur,
puisque le modèle d'extraction ne tourne pas sur le téléphone. **Le contenu du
code-barres, lui, reste sur l'appareil** — le service d'extraction ne reçoit
qu'une photo dont le code est masqué, et le numéro ne lui parvient jamais.
L'exception étroite est l'appel de signature, qui a besoin du numéro le temps
d'assembler la carte signée et ne l'écrit nulle part. C'est une contrainte
imposée par la forme de l'interface, pas une promesse dans une politique de
confidentialité — et c'est de cette différence qu'il faut s'enquérir.

Trois cartes par mois sont gratuites, il n'y a pas d'abonnement, et la fiche de
la [page Outils](https://apps.swtlm.com/fr/tools) le dit avant toute installation.

Le scan est la seule chose que l'application ne sait pas faire hors ligne, et sa
fiche le dit : l'extraction sémantique est un appel serveur. La lecture du
code-barres elle-même se fait sur l'appareil, raison pour laquelle le numéro n'a
pas besoin de voyager ; sur la façon très souple dont le mot « hors ligne » est
employé sur les fiches en général, voir
[jeux hors ligne pour enfants](https://apps.swtlm.com/fr/blog/offline-games-for-kids). Et si vous pesez la
façon dont une application se paie,
[ce que coûte vraiment un abonnement à un casse-tête](https://apps.swtlm.com/fr/blog/what-a-puzzle-game-subscription-costs)
détaille les trois modèles et comment les distinguer sur une fiche.

## Frequently asked questions

**Pourquoi ne puis-je pas ajouter ma carte de fidélité directement à Apple Wallet ?**

Parce qu'une carte de portefeuille doit être créée et signée cryptographiquement par celui qui l'émet, et la plupart des commerces n'en ont jamais créé. Apple Wallet n'a aucun moyen d'accepter une carte qu'aucun émetteur n'a publiée.

**Une photo de la carte fonctionne-t-elle en caisse ?**

Parfois, et de façon peu fiable. Les scanners laser à main ne lisent pas du tout un écran ; les scanners à caméra y arrivent en général si le code est grand, net et à pleine luminosité. Une photo de la carte entière est rarement l'un de ces trois.

**Android a-t-il un équivalent d'Apple Wallet ?**

Google Wallet accepte les cartes de fidélité, mais seulement des programmes partenaires qui les publient. Pour tout le reste, ce qui marche en caisse est une application qui stocke le code-barres et l'affiche en plein écran.

**De quel format de code-barres ai-je besoin ?**

Celui qui est imprimé sur la carte. Les plus courants sont Code 128 et Code 39 pour les codes à barres longs, EAN-13 pour le style produit, et QR ou Aztec pour les codes carrés. Un numéro saisi dans le mauvais format ne se scannera pas.

**Le numéro de la carte est-il envoyé quelque part ?**

Cela dépend de l'application, et c'est la seule chose qui mérite vérification. Lire la carte peut exiger un serveur ; la stocker et l'afficher, non. Le contenu du code-barres ne devrait jamais avoir besoin de quitter l'appareil une fois qu'il existe.