Cet article décrit le flux de travail complet pour migrer les jetons de paiement existants d’un ancien processeur vers Adyen. Une migration réussie nécessite une coordination étroite entre le partenaire logiciel, le commerçant, l’ancien fournisseur et ValPay.
Aperçu
La migration des jetons permet aux commerçants de transférer en toute sécurité leurs enregistrements de paiements récurrents existants vers Adyen sans obliger les clients à saisir de nouveau leurs informations de carte.
Ce processus comprend :
L’initiation de la demande de migration
Le chiffrement et l’échange des fichiers de jetons
La coordination avec l’ancien fournisseur
Le téléversement des données vers Adyen
Les tests des jetons migrés
Suivez les étapes ci-dessous pour compléter la migration avec succès.
1. Étapes d’initiation du partenaire
Étape 1 — Aviser ValPay de la demande de migration
Le partenaire logiciel doit envoyer un courriel à :
Inclure les informations suivantes :
Nom du partenaire :
Nom commercial du commerçant (DBA – Doing Business As) :
Coordonnées du commerçant (s’il est impliqué) :
Processeur qui détient actuellement les jetons :
Date ou échéancier prévu pour la migration :
Toute note pertinente concernant les jetons ou la demande :
ValPay confirmera la réception de la demande et lancera le processus de migration.
Étape 2 — Réception de la clé PGP de ValPay
ValPay répondra au courriel du partenaire avec :
Une clé publique PGP (valide pour six mois)
Des instructions de chiffrement sécurisées
Une confirmation des prochaines étapes
Le partenaire doit transmettre cette clé PGP au commerçant, accompagnée des instructions de la section 2 ci-dessous.
2. Instructions pour le commerçant auprès de l’ancien fournisseur
Une fois la clé PGP reçue, le commerçant doit contacter son ancien processeur de paiement pour demander l’extraction des jetons.
Étape 3 — Le commerçant contacte l’ancien fournisseur
Le commerçant doit envoyer un courriel à son ancien fournisseur de paiement en incluant :
Sa demande de migration des jetons vers Adyen
La clé PGP fournie par ValPay
L’adresse courriel de migration ValPay : [email protected]
L’échéancier prévu pour la migration
L’ancien fournisseur utilisera ces informations pour préparer le fichier de migration chiffré.
3. Exigences relatives aux fichiers (responsabilités de l’ancien fournisseur)
L’ancien fournisseur doit extraire et préparer l’ensemble des données des contrats récurrents.
Étape 4 — Préparation du fichier de migration
L’ancien fournisseur doit effectuer les actions suivantes :
Compilation des données
Rassembler tous les enregistrements de paiements récurrents requis, incluant :
Identifiants clients
Identifiants de jetons de l’ancien processeur
PAN masqués
Dates d’expiration
BIN de carte et valeurs de résumé
Métadonnées associées
Exigences de format des données
Le fichier doit être formaté en CSV selon la norme RFC 4180 :
La première ligne contient les noms des champs
Les lignes suivantes contiennent les données des contrats récurrents
Champs CSV requis
Champ | Description |
recurringReference | Identifiant unique du contrat récurrent |
shopperReference | Identifiant unique du client |
shopperEmail | Courriel du client |
cardBin | 6 premiers chiffres de la carte |
cardSummary | 4 derniers chiffres de la carte |
expiryDate | MM/AAAA |
contractType | Ex. : RECURRING, ONECLICK |
currency | Code de devise ISO |
creationDate | Date de création du contrat récurrent |
name | Nom du titulaire de la carte |
variant | Type de carte (ex. : visa, mc) |
additionalData | Métadonnées facultatives |
4. Chiffrement sécurisé et transfert de fichiers
Étape 5 — Chiffrement du fichier CSV
L’ancien fournisseur doit chiffrer le fichier CSV à l’aide de la clé PGP fournie par ValPay.
Cela garantit :
La conformité PCI DSS
La transmission sécurisée des données liées aux cartes
La protection des identifiants de jetons
Étape 6 — Téléversement du fichier vers un FTP sécurisé
L’ancien fournisseur doit :
Téléverser le fichier CSV chiffré vers un emplacement FTP sécurisé
Fournir à ValPay :
L’URL ou l’hôte FTP
Le nom d’utilisateur et/ou le mot de passe
Toute instruction de connexion particulière
ValPay récupérera directement le fichier chiffré à partir de cet emplacement sécurisé.
5. Responsabilités de ValPay
Étape 7 — Récupération et téléversement du fichier vers Adyen
ValPay effectuera les actions suivantes :
Télécharger le fichier CSV chiffré
Soumettre le fichier à Adyen pour la migration
Attendre qu’Adyen traite et convertisse les jetons dans son format
Adyen retournera un fichier de résultats indiquant :
Les jetons migrés avec succès
Les enregistrements nécessitant des corrections
Les informations de correspondance pour les nouveaux jetons Adyen
ValPay transmettra ce fichier de résultats au partenaire logiciel.
6. Tests et validation par le partenaire
Étape 8 — Validation des jetons migrés par le partenaire
Une fois le fichier de sortie reçu de ValPay :
Importer ou mapper les nouveaux identifiants de jetons Adyen dans votre système
Effectuer des tests de validation (ex. : autorisations à 0 $ ou transactions de test, lorsque applicable)
Confirmer que les jetons fonctionnent correctement pour la facturation récurrente
Si des problèmes sont détectés, les partenaires doivent les signaler à :
ValPay examinera la situation et coordonnera les corrections nécessaires.
7. Finalisation de la migration
La migration est considérée comme complétée lorsque :
Tous les nouveaux jetons Adyen sont actifs dans le système du partenaire
Les transactions de test confirment le bon mappage
Le commerçant a confirmé le bon fonctionnement des flux de facturation récurrents
Résumé des responsabilités
Partenaire
Initier la migration auprès de ValPay
Transmettre la clé PGP au commerçant
Effectuer les tests d’intégration
Commerçant
Demander le fichier de jetons à l’ancien fournisseur
Fournir la clé PGP et les coordonnées ValPay
Ancien fournisseur
Extraire le fichier de jetons
Chiffrer le CSV à l’aide de PGP
Téléverser le fichier chiffré vers un FTP sécurisé
ValPay
Récupérer le fichier chiffré
Téléverser vers Adyen
Retourner le fichier de sortie traité par Adyen
Soutenir le dépannage