# Migration de cartes

Utilisez la migration de Carte lorsque vous souhaitez changer le système qui **gère** vos cartes, tout en gardant les cartes déjà installées fonctionnelles pour les clients.

Une migration est un changement « en coulisses ». Les clients conservent la même carte dans Apple Wallet ou Google Wallet. Votre objectif est la continuité : la carte reste valide et les mises à jour continuent de fonctionner.

{% hint style="success" %}
Dans la plupart des cas, vous pouvez migrer sans impacter les clients.

Si vous planifiez la bascule et testez d’abord, les clients gardent la même carte et elle continue de se mettre à jour.
{% endhint %}

<details>

<summary><strong>Exemples concrets</strong></summary>

* Une marque de vente au détail migre des cartes de fidélité en pleine saison sans demander aux clients de réinstaller.
* Un organisateur de spectacle change de fournisseur de billetterie après un pilote.
* Une marque regroupe plusieurs fournisseurs de cartes sur une plateforme unique.

</details>

### Ce que les clients doivent ressentir

Lorsque la migration est correctement effectuée, les clients ne réinstallent rien. Ils conservent la même carte sur leur appareil et peuvent continuer à l’utiliser comme d’habitude.

Concrètement, cela signifie que le code-barres ou le code QR utilisé en magasin ou à la porte reste le même. La carte continue également de recevoir des mises à jour (par exemple : points, niveau, solde, siège, porte ou validité).

La plupart des migrations incluent un court pilote. Vous validez le flux avec un petit lot, puis vous basculez le reste des cartes.

### Plan de migration typique

Les étapes exactes dépendent de la direction (vers ou depuis The Wallet Crew) et des contraintes de la plateforme. Le flux ci-dessous reste globalement valable dans la plupart des projets.

{% stepper %}
{% step %}

### 1) Confirmez ce que « en place » signifie pour votre configuration

Confirmez quelle identité d’émetteur Apple signe vos cartes, et quel compte d’émetteur Google Wallet les possède. C’est cela qui décide si les clients peuvent conserver la même carte ou s’il faut un flux de réémission.
{% endstep %}

{% step %}

### 2) Exportez les identifiants techniques des cartes

Vous avez besoin des identifiants qui permettent au nouveau système de se rattacher aux cartes existantes (par exemple numéros de série Apple + jetons d’authentification, ou IDs de ressource/IDs d’objet Google).
{% endstep %}

{% step %}

### 3) Faites correspondre les champs et exécutez un lot pilote

Exécutez d’abord un petit lot. Mettez à jour un champ visible et validez-le sur de vrais appareils. Gardez le pilote simple pour pouvoir itérer rapidement.
{% endstep %}

{% step %}

### 4) Basculez, puis surveillez

Exécutez le plan de bascule, puis surveillez les mises à jour et les utilisations pendant quelques jours. Gardez une option de retour en arrière si votre fournisseur précédent la prend en charge.
{% endstep %}
{% endstepper %}

### Coordination et calendrier

Une migration nécessite une coordination entre les parties. Il s’agit généralement de votre fournisseur actuel et de The Wallet Crew, avec votre propre équipe impliquée lorsque vous contrôlez les comptes d’émetteur et les certificats.

Le travail est rarement techniquement « difficile ». La plupart du temps est consacré à l’alignement sur le format d’export, la correspondance des champs, les approbations de sécurité et le plan de bascule. Prévoyez quelques semaines pour un projet typique. Les délais varient selon les fournisseurs et les cycles d’approbation.

### Choisissez votre voie

* Déplacement **vers** The Wallet Crew : [Déplacer les cartes vers The Wallet Crew](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/configure/wallet/import-and-export/move-pass-from-and-to-the-wallet-crew/move-passes-to-the-wallet-crew)
* Déplacement **loin** de The Wallet Crew : [Exporter des cartes de The Wallet Crew vers un autre fournisseur](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/configure/wallet/import-and-export/move-pass-from-and-to-the-wallet-crew/export-passes-from-the-wallet-crew-to-another-provider)

### Contraintes clés (Apple vs Google)

Apple Wallet et Google Wallet ont des règles différentes. Ces règles expliquent pourquoi les migrations nécessitent une coordination et pourquoi un lot de test est important.

#### Apple Wallet

Les migrations Apple Wallet dépendent de l’identité de l’émetteur utilisée pour signer les cartes. Elles dépendent aussi de « l’adresse » de mise à jour intégrée dans la carte (`webServiceURL`), car les appareils appellent cette URL pour récupérer les mises à jour.

Si vous pouvez conserver la même identité d’émetteur et repointer correctement `webServiceURL`, les clients peuvent généralement garder la même carte installée.

#### Google Wallet

Les migrations Google Wallet dépendent du compte d’émetteur qui possède les cartes. Si le compte d’émetteur change, vous devez généralement réémettre les cartes (ce qui implique un nouveau flux d’enregistrement pour les clients).

Si vous conservez le même compte d’émetteur et les mêmes IDs d’objet, les clients peuvent généralement garder la même carte.

### FAQ

<details>

<summary><strong>Les clients doivent-ils réinstaller leur carte pendant une migration ?</strong></summary>

Généralement non. Si vous migrez « en place » (même identité d’émetteur Apple et Google sous le même compte d’émetteur), les clients conservent la même carte et elle continue de se mettre à jour.

</details>

<details>

<summary><strong>Quelles données avons-nous généralement besoin de récupérer auprès du fournisseur précédent ?</strong></summary>

Vous avez généralement besoin d’identifiants techniques qui permettent à un nouveau système de se rattacher à la carte existante.

* Pour Apple, il s’agit typiquement du numéro de série et du jeton d’authentification.
* Pour Google, il s’agit typiquement de l’ID de ressource (ID d’objet).

</details>

<details>

<summary><strong>Combien de temps une migration prend-elle généralement ?</strong></summary>

Prévoyez quelques semaines. La plupart du temps est consacré à la coordination, pas à l’implémentation. Vous avez besoin de temps pour l’export, la correspondance et un petit lot de test.

</details>

<details>

<summary><strong>Qui doit être impliqué ?</strong></summary>

Vous avez besoin de votre fournisseur actuel et de The Wallet Crew. Si vous contrôlez les comptes d’émetteur et les certificats, votre équipe est également impliquée.

</details>