Codes-barres des passes Wallet

Le code-barres relie le pass à vos systèmes : caisse, douchette, portique. Deux décisions à prendre :

Le format, fixé sur le template : champ barcodeFormat (coupon, transport) ou barcodeType (carte de fidélité, événement).
La valeur, propre à chaque pass : champ barcode.

Les formats disponibles

Format	Forme	Quand le choisir
`QR_CODE`	Carré 2D	Le choix par défaut. Lu par presque tous les scanners et les smartphones.
`AZTEC`	Carré 2D, compact	Billetterie transport et aérien. Se lit bien sur un écran, même petit.
`PDF_417`	Rectangle 2D empilé	Cartes d’embarquement, systèmes de contrôle qui l’exigent.
`CODE_128`	Code 1D linéaire	Caisses équipées de douchettes 1D, cartes de fidélité.
`NONE`	Pas de code-barres	Pass purement informatif (confirmation, carte d’adhérent sans contrôle).

Faites tester vos scanners

Avant de lancer, scannez un vrai pass sur un vrai téléphone avec vos équipements. Une vieille douchette 1D ne lit pas un QR.

Bon à savoir côté Apple

Apple Wallet n’affiche pas les codes 1D (CODE_128) sur Apple Watch. Préférez un format 2D si vos clients scannent depuis leur montre.

Par défaut, eldo wallet génère une valeur.
Vous pouvez imposer la vôtre (numéro client CRM, numéro de billet de votre billetterie) : champ barcode à la création du client ou du pass.
Le code-barres sert ensuite de clé : retrouver un client (GET/clients/barcode/{barcode}), créditer des points en caisse (PATCH/clients/barcode/{barcode}/gain), retrouver un billet (GET/transits/{transitId}/passes/barcode/{barcode}, GET/events/{id}/passes/barcode/{barcode}), valider un pass (POST/passes/template/{templateId}/redeem/{barcode}).

Unicité

Un même code-barres ne peut pas être attribué à deux clients du même wallet. L’API renvoie alors BARCODE_ALREADY_EXISTS (409).

Les templates exposent un bloc security :

Option	Effet
`enableOneTimeUse`	Le pass ne sert qu’une fois.
`disableIOSPassSharing`	Le porteur ne peut pas partager le pass depuis Apple Wallet.
`disablePassLinkSharing`	Désactive le partage du lien d’ajout du pass.
`disableMultipleHolders`	Un seul porteur pour ce pass.
`enableSecurityAnimation`	Animation visuelle sur le pass, plus difficile à copier en capture d’écran.
`enableRotatingBarcode`	Code-barres qui change régulièrement : une capture d’écran devient inutile.

En multipart/form-data, le bloc s’envoie en chaîne JSON : security={"disableIOSPassSharing":true}.

Testez chaque option sur Apple Wallet et sur Google Wallet avant un lancement.