> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Migration d'abonnement vers Dodo Payments

> Découvrez comment migrer vos abonnés et méthodes de paiement existants de votre processeur de paiement actuel vers Dodo Payments.

## Qu'est-ce qu'une migration d'abonnement ?

Une migration d'abonnement transfère vos abonnés existants de votre processeur de paiement hérité vers Dodo Payments, vous offrant une source unique de vérité pour toutes vos données clients. Sans migration, les clients que vous avez acquis jusqu'à présent restent dans votre système hérité, et seuls les nouveaux clients seraient visibles dans Dodo Payments.

Le processus de migration garantit une expérience de facturation fluide pour vos clients : ils n'auront pas besoin de ressaisir leurs informations de paiement ni de subir d'interruption de leurs abonnements.

<Warning>
  Actuellement, nous ne prenons en charge la migration que des **jetons de carte**. Apple Pay, Google Pay et autres méthodes de paiement wallet ne peuvent pas être transférés entre processeurs de paiement en raison des restrictions de tokenisation imposées par ces fournisseurs.
</Warning>

## Aperçu du processus de migration

Le processus de migration d'abonnement se compose de trois parties clés :

1. **Transfert de méthode de paiement** — Transfert sécurisé des données sensibles de carte de votre processeur actuel
2. **Transfert de données d'abonné** — Exportation des détails des clients, des plans d'abonnement et des calendriers de facturation
3. **Importation et validation** — Unification des méthodes de paiement et des données d'abonné dans Dodo Payments

<Note>
  Pour lancer une migration d’abonnement, contactez notre [équipe d’assistance](mailto:support@dodopayments.com). Elle vous mettra en relation avec un ingénieur Solutions dédié qui vous guidera tout au long du processus.
</Note>

## Exigences

Avant de commencer une migration, assurez-vous de répondre aux exigences suivantes :

<AccordionGroup>
  <Accordion title="PCI DSS compliance verification">
    Dodo Payments est conforme à la norme PCI DSS Niveau 1. Pour satisfaire aux obligations de conformité, nous ne pouvons recevoir les données de carte que d’un autre processeur de paiement conforme à la norme PCI DSS Niveau 1.

    Votre processeur actuel doit fournir :

    * Leur attestation de conformité PCI actuelle (AOC), ou leur inscription dans le registre mondial des fournisseurs de services de Visa
    * Confirmation qu'ils supportent les exportations sécurisées de données de carte

    Consultez notre [Attestation de conformité (AOC)](https://pub-2a89184e4c954b599464449d23f506bb.r2.dev/dodo-payments-pci-dss-aoc.pdf) à partager avec votre processeur actuel.
  </Accordion>

  <Accordion title="Dodo Payments integration">
    Terminez votre intégration Dodo Payments et assurez-vous que tous les nouveaux clients sont dirigés vers le processus de paiement Dodo Payments avant de commencer la migration. Cela évite les incohérences de données pendant la période de transition.
  </Accordion>

  <Accordion title="Data access authorization">
    Assurez-vous de disposer de l’autorisation nécessaire pour demander une exportation de données auprès de votre processeur actuel. Cela nécessite généralement :

    * Une vérification du propriétaire du compte
    * Une autorisation écrite pour l’accès aux données sensibles
    * L’accomplissement des étapes de vérification de sécurité de votre processeur
  </Accordion>
</AccordionGroup>

## Guide de migration étape par étape

<Steps>
  <Step title="Request payment method export from your current processor">
    Contactez l’équipe d’assistance de votre processeur de paiement actuel et soumettez une demande formelle d’exportation complète de vos jetons de carte client.

    Vous devrez :

    * Fournir une vérification de votre identité et de votre autorisation
    * Demander qu'ils encryptent l'exportation en utilisant la clé publique PGP de Dodo Payments (fournie ci-dessous)
    * Leur demander de transférer le fichier encrypté directement à notre serveur SFTP sécurisé

    <Info>
      Les transferts sécurisés s’effectuent directement serveur à serveur via SFTP. Votre ingénieur Solutions vous fournira les identifiants SFTP à transmettre à votre processeur actuel.
    </Info>

    En moyenne, ce processus prend environ **2 semaines**, bien que les délais varient selon les politiques et les temps de réponse de votre processeur actuel.
  </Step>

  <Step title="Prepare subscriber data export">
    Pendant le transfert de la méthode de paiement, exportez les données de vos abonnés depuis votre système historique. Votre ingénieur Solutions fournira un modèle CSV et vous guidera sur les champs requis.

    ### Données d'abonné requises

    | Field               | Description                                                   |
    | ------------------- | ------------------------------------------------------------- |
    | `customer_id`       | Votre identifiant client interne                              |
    | `email`             | Adresse e-mail du client                                      |
    | `name`              | Nom complet du client                                         |
    | `country`           | Code pays à deux lettres (ISO 3166-1 alpha-2)                 |
    | `currency`          | Code devise à trois lettres (ISO 4217)                        |
    | `payment_amount`    | Montant de l’abonnement dans l’unité monétaire la plus petite |
    | `payment_interval`  | Fréquence de facturation (mensuelle, annuelle, etc.)          |
    | `next_billing_date` | Date de facturation suivante prévue (ISO 8601)                |
    | `card_token`        | Jeton unique provenant de votre processeur actuel             |

    <Warning>
      Le champ `card_token` est essentiel : il sert à faire correspondre les enregistrements d’abonnés avec leurs méthodes de paiement pendant l’importation. Assurez-vous qu’il correspond exactement au jeton présent dans l’export des méthodes de paiement.
    </Warning>

    ### Format de données d'exemple

    ```json theme={null}
    {
      "customers": [
        {
          "customer_id": "cus_abc123",
          "email": "jane.doe@example.com",
          "name": "Jane Doe",
          "country": "US",
          "currency": "USD",
          "payment_amount": 2999,
          "payment_interval": "monthly",
          "next_billing_date": "2025-01-15T00:00:00Z",
          "card_token": "tok_xyz789",
          "metadata": {
            "plan": "pro",
            "signup_source": "website"
          }
        }
      ]
    }
    ```
  </Step>

  <Step title="Validation and testing">
    Avant la date d’importation, notre équipe :

    * Vérifier l'intégrité du fichier et l'encryption des données de méthode de paiement
    * Valider votre CSV d'abonné pour un format correct
    * Effectuer un test d'importation dans notre environnement sandbox
    * Identifier et résoudre tout problème de mappage de données

    <Check>
      Vous recevrez un rapport de validation confirmant que tout est prêt pour l’importation en production.
    </Check>
  </Step>

  <Step title="Production import">
    À la date d’importation convenue, notre équipe d’ingénierie :

    1. Importer les données de méthode de paiement dans notre coffre-fort de cartes conforme PCI
    2. Importer vos données d'abonné
    3. Faire correspondre les abonnés à leurs méthodes de paiement en utilisant les tokens de carte
    4. Activer tous les abonnements migrés

    <Info>
      Le délai de traitement habituel est de **2 à 3 jours ouvrés** pour les migrations standard, selon le volume d’abonnés.
    </Info>
  </Step>

  <Step title="Post-migration verification">
    Une fois l’importation terminée, vous recevrez :

    * Un rapport de migration complet
    * Un CSV mappant vos anciens IDs d'abonnement aux nouveaux IDs de Dodo Payments
    * Accès à tous les clients migrés dans votre tableau de bord Dodo Payments

    Nous vous recommandons :

    * De vérifier un échantillon d’abonnements migrés dans votre tableau de bord
    * De tester quelques renouvellements d’abonnement en mode bac à sable
    * De mettre à jour vos références internes en base de données avec les nouveaux identifiants
    * De mettre en place une surveillance parallèle pour le premier cycle de facturation
  </Step>
</Steps>

## Données migrables

Les données suivantes peuvent être transférées lors d'une migration d'abonnement :

| Type de données                  | Supporté | Remarques                           |
| -------------------------------- | -------- | ----------------------------------- |
| Numéros de carte de crédit/débit | ✅        | Encrypté via PGP                    |
| Dates d'expiration de carte      | ✅        |                                     |
| Noms des titulaires de carte     | ✅        |                                     |
| Adresses de facturation          | ✅        |                                     |
| Adresses e-mail des clients      | ✅        |                                     |
| Métadonnées des clients          | ✅        | Paires clé-valeur personnalisées    |
| Détails d'abonnement             | ✅        | Plan, montant, intervalle           |
| Tokens Apple Pay                 | ❌        | Ne peuvent pas être transférés      |
| Tokens Google Pay                | ❌        | Ne peuvent pas être transférés      |
| Autres tokens de portefeuille    | ❌        | Ne peuvent pas être transférés      |
| Historique des paiements         | ❌        | Exporter de votre processeur actuel |

<Note>
  L’historique des paiements et les enregistrements de transactions ne peuvent pas être migrés. Nous vous recommandons d’exporter ces données auprès de votre processeur actuel pour vos archives avant de finaliser la transition.
</Note>

## Encryption PGP

Pour une sécurité maximale lors du transfert de données sensibles de carte, tous les fichiers **doivent** être encryptés en utilisant notre clé publique PGP. Cela fournit une couche de protection supplémentaire au-delà de l'encryption au niveau du transport.

Partagez cette clé avec votre processeur de paiement actuel pour encryptage de l'exportation des données de carte :

<Accordion title="Dodo Payments PGP Public Key">
  ```
  -----BEGIN PGP PUBLIC KEY BLOCK-----

  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
  1OSDhXaPYtJnVApUzaCrC5PJCXU=
  =nHcw
  -----END PGP PUBLIC KEY BLOCK-----

  ```
</Accordion>

## Attentes de calendrier

| Phase                                   | Durée                    |
| --------------------------------------- | ------------------------ |
| Configuration initiale et planification | 1-2 jours                |
| Transfert de méthode de paiement        | \~2 semaines             |
| Préparation des données d'abonné        | 3-5 jours (en parallèle) |
| Validation et test                      | 2-3 jours                |
| Importation en production               | 2-3 jours ouvrables      |
| Vérification post-migration             | 1-2 jours                |

<Tip>
  La migration complète prend généralement **3 à 4 semaines** du début à la fin. Commencer la préparation des données d’abonnés pendant que le transfert des méthodes de paiement est en cours contribue à réduire la durée totale.
</Tip>

## Commencer

Prêt à migrer vos abonnements vers Dodo Payments ? Contactez notre équipe pour commencer le processus :

<CardGroup cols={2}>
  <Card title="Contact Support" icon="envelope" href="mailto:support@dodopayments.com">
    Contactez-nous pour lancer votre migration et être mis en relation avec un ingénieur Solutions.
  </Card>

  <Card title="API Documentation" icon="code" href="/api-reference/introduction">
    Explorez notre API pour comprendre comment fonctionnent les abonnements dans Dodo Payments.
  </Card>
</CardGroup>
