Connecteur Stripe pour Amazon S3Bêta
Automatisez les importations récurrentes de fichiers depuis votre compartiment Amazon S3 vers Stripe.
Ce guide explique comment importer des fichiers depuis Amazon S3 vers la plateforme de gestion des données Stripe. En suivant ces instructions, vous configurez une tâche automatisée qui importe des données pour actualiser vos produits Stripe.
Prérequis![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Avant de démarrer l’intégration, assurez-vous d’être en possession des éléments suivants :
- Un compte AWS actif et un compartiment S3 ayant accès aux fichiers concernés.
- Un accès d’administrateur de compte au Dashboard Stripe.
Se connecter à votre compte AWS![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Vous devrez accéder à votre AWS Access Console au cours du processus de configuration.
- Connectez-vous à l’AWS Management Console
Préparer vos fichiers dans Amazon S3![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Pour valider la configuration de votre connexion, utilisez des données correctement formatées dans votre compartiment S3. Le processus de configuration affiche les fichiers disponibles et procède à une synchronisation initiale au moment de configurer la connexion.
- Accédez à votre console Amazon S3.
- Assurez-vous que vos fichiers sont stockés dans un compartiment S3 dédié et qu’ils sont organisés selon vos préférences d’importation.
- Si vous n’avez pas encore de compartiment S3, vous pouvez suivre les instructions AWS pour la création de votre premier compartiment.
- Stripe impose les exigences suivantes en matière de fichiers pour que la récupération aboutisse :
- Les noms de fichiers doivent respecter les conventions S3 de dénomination des objets.
- La taille du fichier ne doit pas dépasser 1 Go.
- Notez bien le nom et la région du compartiment, car vous en aurez besoin lors des étapes suivantes.
- Gardez votre console AWS ouverte pour configurer un rôle IAM dans les étapes suivantes.
Formats de fichier pris en charge![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
- CSV
- TSV
- JSON
- JSONLINE
- Pour les autres formats, veuillez contacter le service d’assistance
Configurer le connecteur Stripe pour Amazon S3 afin d'importer des fichiers depuis votre compartiment S3![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
- Connectez-vous au Dashboard du connecteur de gestion des données Stripe.
- Cliquez sur + Set up connector > Amazon S3.
- Saisissez un nom de connecteur unique pour cette connexion. Pensez à utiliser des détails relatifs à la source des données, aux objets contenus dans le fichier et à la destination du produit pour créer un nom unique significatif.
- Dans votre console Amazon, accédez à la console IAM.
- La prochaine étape de la configuration du connecteur Stripe pour Amazon S3 consiste à créer un rôle IAM grâce à une politique d’approbation personnalisée.
- Dans le volet de navigation de la console, cliquez sur Policies > Create policy.
- Pour créer votre politique d’autorisation, sélectionnez JSON et remplacez le texte de la politique existante en copiant et collant le bloc de code fourni. Dans la section Resource du bloc de code Policy editor, remplacez
USER_
par le nom du compartiment souhaité. Cliquez sur Next. Sous Policy details, spécifiez un nom de politique, ainsi que toute étiquette souhaitée (facultatif), puis cliquez sur Create policy.TARGET_ BUCKET - Revenez dans le volet de navigation de la console, puis cliquez sur Roles > Create role.
- Choisissez le type de rôle Custom trust policy, copiez et collez le bloc de code fourni, puis cliquez sur Next.
- Pour sélectionner votre politique d’autorisation, recherchez la nouvelle politique d’autorisation dans la liste. Cochez la case pour sélectionner la politique, faites défiler l’écran vers le bas, puis cliquez sur Next.
- Pour créer un nom de rôle, copiez-collez le nom de rôle fourni, puis cliquez sur Create role.
- La prochaine étape de la configuration du connecteur Stripe pour Amazon S3 consiste à établir la connexion entre votre compartiment Amazon S3 et Stripe.
- Depuis la console AWS, recherchez et saisissez l’ID de votre compte AWS.
- Renseignez le nom et la région du compartiment de votre console AWS que vous aviez notés lors de l’étape 2.3.
- Si vous organisez vos fichiers dans des dossiers au sein de votre compartiment Amazon S3, spécifiez un dossier dans le compartiment ci-dessus.
- Si vous spécifiez un dossier dans le compartiment ci-dessus, nous ne récupérerons les données que dans ce compartiment, et non dans le compartiment entier.
- Quand la configuration d’un nouveau connecteur est terminée, Stripe récupère toutes les données du compartiment Amazon S3 modifiées au cours des 90 derniers jours.
- Nous récupérons les données toutes les cinq minutes.
- Seuls les objets dont la date LastModified est ultérieure à la dernière synchronisation sont importés via les importations récurrentes.
- Lors de l’étape 4, les fichiers disponibles sont prévisualisés dans le compartiment Amazon S3 connecté et vous pouvez les associer à un modèle de données.
- L’aperçu du fichier permet de confirmer que vos identifiants connectent Stripe au compartiment et au dossier Amazon S3 attendus.
- Le modèle de données associe cette connexion à un format de fichier attendu pour les importations initiales et récurrentes.
- Cliquez sur Done pour créer une connexion de données active et lancer l’importation initiale des données.
- Stripe récupère toutes les données du compartiment Amazon S3 modifiées au cours des 90 derniers jours.
- Nous récupérons les données une fois par jour.
Conserver votre connexion Amazon S3![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Quand votre connexion est établie, nous récupérons vos données toutes les cinq minutes. Pour surveiller la stabilité de votre connexion, vous pouvez :
- Consultez le Dashboard du connecteur de gestion des données Stripe pour accéder à l’état et aux détails de la dernière synchronisation de vos connexions établies.
- Gérer une connexion unique en cliquant sur un connecteur.
- Vous pouvez modifier le nom du connecteur ou le modèle des données, réauthentifier une connexion interrompue et supprimer une connexion.
- Nous recommandons de configurer une tâche automatisée pour livrer régulièrement de nouveaux fichiers dans votre compartiment S3.
- L’API Amazon List Object ne permet pas de filtrer les objets en fonction de LastModified. Par conséquent, vous devez lister tout le contenu de votre compartiment pour chaque importation. Assurez-vous de n’autoriser que le rôle IAM associé à accéder aux données que vous avez l’intention d’importer vers Stripe. Nous recommandons de limiter le nombre de fichiers dans votre compartiment à 50 000 maximum. Pour ce faire, veillez à définir le délai d’expiration de vos objets en conséquence.