Importer les données de carte bancaire
Migrez vos données de carte bancaire, y compris les cartes par défaut, les limitations et les validations d'adresse.
Lorsque vous migrez des données de carte bancaire de votre prestataire de services de paiement précédent, vous pouvez importer les données dans Stripe en tant qu’objet carte de moyen de paiement par défaut (pm_
) ou en tant qu’objet ancienne carte bancaire (card_
). L’API Payment Intents prend en charge tous les produits Stripe pour les deux types de payment par carte, mais votre intégration peut en privilégier un en fonction des considérations suivantes.
Si vous utilisez une plateforme d’abonnement tierce avec Stripe, vérifiez auprès de la plateforme ou de votre développeur s’ils préfèrent l’un ou l’autre.
Si vous disposez déjà de données de paiement dans votre compte Stripe, essayez d’associer le type de données que vous utilisez déjà :
pm_
: utilisez l’API Payment Methods avec l’API Payment Intents.card_
: utiliser l’API Card avec l’API Payment Intents.src_
: vous pouvez toujours utiliser l’API Sources, qui est obsolète, mais nous vous recommandons de migrer vers l’API Payment Intents pour accéder à davantage de fonctionnalités.
Cartes par défaut
Une carte par défaut est la carte principale qu’un client définit ou choisit pour les paiements récurrents, les abonnements ou comme moyen de paiement par défaut pour les transactions futures. Lorsque vous désignez une carte comme carte default
, elle devient automatiquement le moyen de paiement pour la prochaine transaction, sauf indication contraire de votre part. Utilisez cette fonction pour les services basés sur des abonnements qui nécessitent des paiements récurrents automatiques. Vous pouvez définir une nouvelle carte comme nouveau moyen de paiement par défaut ou l’ajouter comme moyen de paiement supplémentaire sans modifier le moyen par défaut actuel.
Type | Préfixe de l’objet | Comportement de la migration |
---|---|---|
Carte | card_ | Définit une carte par défaut lors de l’importation. Si elle n’est pas précisée dans le fichier de données, la première carte importée devient la carte par défaut. |
Moyen de paiement | pm_ | Ne nécessite pas une carte par défaut. Si le fichier de données ne le précise pas, aucune carte n’est désignée par défaut. |
Source | src_ | Ne nécessite pas une carte par défaut. Si le fichier de données ne le précise pas, aucune carte n’est désignée par défaut. |
Fournir les données de la carte bancaire par défaut
- Incluez les informations relatives aux cartes par défaut dans une colonne distincte de votre fichier de données, en utilisant dans l’idéal les valeurs
TRUE
etFALSE
pour identifier les cartes par défaut ou non. - Marquer une carte par défaut lors de l’importation remplace le moyen de paiement par défaut d’un client existant, s’il a été défini.
Limites actuelles
Stripe ne peut pas migrer les cartes stockées dans les portefeuilles numériques tels que Google et Apple, car ces services (et non le prestataire précédent) utilisent des jetons pour sécuriser les valeurs stockées. Vous devez ajouter toutes les cartes associées aux portefeuilles numériques en tant que nouveaux moyens de paiement dans Stripe.
Validation de l’adresse pour Stripe Tax
Lorsque vous migrez les données des clients vers un compte utilisant Stripe Tax, incluez les champs d’adresse des clients pour les raisons suivantes :
- Précision du calcul des taxes : les adresses permettent de calculer correctement les taxes dans différentes juridictions.
- Conformité aux lois fiscales : les lois fiscales locales exigent des adresses pour l’exactitude des factures fiscales.
- Audits et rapports : des données d’adresse précises facilitent la conformité lors des contrôles fiscaux et améliorent l’analyse interne en enregistrant les lieux de transaction.
- Amélioration du paiement des clients : disposer dès le début d’adresses précises améliore le processus de paiement pour les clients réguliers en permettant un calcul précis et automatique des taxes.
- Adaptabilité aux modifications de la législation fiscale : un ensemble complet de données sur les adresses des clients permet à une entreprise de s’adapter aux modifications de la réglementation fiscale, évitant ainsi les problèmes de conformité.
Outil de mise à jour de carte (CAU)
Les fichiers des prestataires de services de paiement contiennent souvent des cartes expirées. L’outil de mise à jour de carte (CAU) de Stripe met automatiquement à jour les informations de carte stockées en récupérant et en appliquant les nouvelles données de la banque émettrice.
La fonctionnalité CAU optimise la continuité du service et améliore les taux d’autorisation, mais peut entraîner des frais pour chaque carte mise à jour dans votre compte. Vous pouvez préciser le traitement des cartes expirées lors de l’importation.
- Ignorer les cartes expirées : ne pas importer les données des cartes expirées.
Note
Il est encore possible que la fonctionnalité CAU mette à jour des cartes non expirées (telles que des cartes volées ou des cartes de remplacement), ce qui entraîne des frais post-migration.
- Importer des cartes expirées : permettre à la fonctionnalité CAU de mettre à jour autant de cartes que possible et d’imputer les frais CAU à votre compte.
Fonctionnement
Migrer la preuve de l’authentification forte du client (SCA)
Pour les utilisateurs européens, la DSP2 (deuxième directive sur les services de paiement) impose une authentification forte du client (SCA) afin de renforcer la sécurité des paiements électroniques. La SCA exige deux facteurs d’authentification indépendants sur trois pour les transactions :
- un élément que le client connaît (comme un mot de passe)
- un élément que le client possède (comme un appareil mobile)
- un élément propre au client (par exemple, des données biométriques)
Les ID de transaction du réseau de votre prestataire précédent montrent qu’un client a authentifié une transaction en utilisant la SCA avec le prestataire précédent, ce qui permet à Stripe de demander des exemptions SCA pour les transactions futures. Cela rend votre migration vers Stripe transparente pour vos clients, en éliminant leur besoin de s’authentifier à nouveau.
Si votre prestataire précédent ne peut pas fournir d’identifiants de transaction, faites-le nous savoir dans votre formulaire de demande d’importation afin que nous puissions vous proposer d’autres options.
Mandat 3DS pour les comptes Stripe japonais
Les nouvelles directives japonaises sur la sécurité des cartes bancaires obligent les entreprises japonaises à activer le protocole 3D Secure 2 (3DS) d’ici à la fin mars 2025.
Si vous êtes une entreprise japonaise n’utilisant pas 3DS, signalez-le dans la section Informations supplémentaires du formulaire de demande de migration. Stripe adapte son assistance et ses services pour vous aider à vous conformer aux normes du secteur sans perturber vos opérations ni affecter votre sécurité.
En savoir plus sur le mandat 3DS au Japon.
Conseils en matière de fichier de cartes bancaires
- Un prestataire de services de paiement peut fournir un certain nombre de champs différents.
- Nous conseillons à votre prestataire de fournir une exportation complète de toutes les données relatives aux clients et aux moyens de paiement vers Stripe.
- Stripe peut filtrer les champs inutiles des données du prestataire précédent si nécessaire.
- Stripe peut fusionner plusieurs fichiers reçus si l’ancien ID du client ou l’ancien ID de la source est présent dans les deux fichiers.
Exigences en matière de formatage des fichiers
Les fichiers de données d’exportation doivent répondre aux normes de données suivantes pour que nous puissions procéder à une importation :
- Le fichier doit être au format CSV.
- Le fichier doit être codé en UTF-8.
- Délimiter les lignes par un seul caractère de retour à la ligne
\n
(et non\r\n
). - Délimiter les colonnes par
,
- Tous les champs contenant des virgules doivent être placés entre des guillemets doubles (
"
). Nous recommandons de mettre tous les champs entre des guillemets doubles. - Laissez les champs vides entièrement vides (aucun caractère entre les délimiteurs). Vous ne devez pas indiquer un champ manquant par
NULL
,N/A
ou toute autre valeur. - Échappez aux guillemets doubles faisant partie du contenu par un autre guillemet double conformément au RFC CSV. Par exemple :
"``William
""``Barde d'Avon``""
Shakespeare``"
- Les champs ne peuvent pas contenir de caractères de retour à la ligne (
\r
ou\n
) à l’intérieur d’un champ. Voici un exemple de ce qu’il faut éviter :101 1st Ave\nApt 1
. - Toutes les lignes doivent avoir le même nombre de colonnes.
- Les colonnes peuvent être placées dans n’importe quel ordre.
- Vous devez chiffrer les fichiers de données sensibles avec notre clé PGP avant de les envoyer par SFTP.
Champs de données de la carte
Champ | Obligatoire | Informations supplémentaires |
---|---|---|
Ancien ID du client | Obligatoire | Nous créons un ID de client pour chaque ancien ID de client unique fourni. |
Numéro de carte | Obligatoire | Chaque client importé doit avoir au moins une carte. |
Date d’expiration de la carte | Obligatoire | Vous pouvez fournir cette option sous la forme d’une ou de deux colonnes (valeurs distinctes pour le mois et l’année). |
Identifiants de transaction du réseau | Obligatoire* | *Obligatoire pour les marchands concernés par les exigences de la SCA. |
Ligne d’adresse 1 | Obligatoire* | *Recommandé pour la validation de l’adresse. Obligatoire pour Stripe Tax. |
Ville | Obligatoire* | *Recommandé pour la validation de l’adresse. Obligatoire pour Stripe Tax. |
État | Obligatoire* | *Recommandé pour la validation de l’adresse. Obligatoire pour Stripe Tax. |
Code postal | Obligatoire* | *Recommandé pour la validation de l’adresse. Obligatoire pour Stripe Tax. |
Pays | Obligatoire* | *Recommandé pour la validation de l’adresse. Obligatoire pour Stripe Tax. Format du code de pays ISO à 2 lettres. |
ID du client Stripe | Facultatif | Fournir dans le fichier du prestataire ou dans un fichier supplémentaire pour l’associer aux clients Stripe existants. |
ID de l’ancienne carte | Facultatif | Recommandé si vous avez un client disposant de plusieurs cartes chez le prestataire précédent. |
Description | Facultatif | Métadonnées supplémentaires |
Facultatif | Métadonnées supplémentaires | |
Téléphone | Facultatif | Métadonnées supplémentaires |
Par défaut | Facultatif | Indiquez TRUE ou FALSE pour préciser s’il s’agit de la carte par défaut. |
Nom | Facultatif | Métadonnées supplémentaires |
Ligne d’adresse 2 | Facultatif | Métadonnées supplémentaires |
Métadonnées du client/de la carte | Facultatif | Toute métadonnée supplémentaire |