Signaler les transactions de la plateforme

Importez des données de transaction à partir de sources de données tierces pour les intégrer à la procédure d'évaluation des risques de Stripe Capital.

Mise en garde

Les transactions de la plateforme de création de rapports pour Capital sont en version bêta privée et sont susceptibles d’évoluer. Si vous avez des questions ou des commentaires, contactez capital-review@stripe.com

Facilitez l’accès aux options de financement pour vos utilisateurs qui acceptent des paiements en dehors de Stripe. Cela inclut le volume des paiements traités via d’autres prestataires et les transactions hors ligne, effectuées notamment en espèces ou par chèque.

Stripe Capital intègre ces transactions externes à Stripe pour proposer à vos utilisateurs des offres basées sur l’ensemble de leur profil d’entreprise, et pas uniquement la partie gérée à l’aide de Stripe.

Collectez et préparez vos données

Collectez des données concernant vos revenus, p. ex. le volume de paiements traités via d’autres prestataires et les transactions en espèces, pour les importer dans Stripe sous forme de fichiers CSV. Incluez également les transactions Stripe, que nous utilisons pour valider votre intégration de données. Vous pouvez afficher les données que vous avez importées à partir du Dashboard des séries importées. Assurez-vous que vos données sont compatibles avec le format CSV ci-dessous. Tous les attributs sont obligatoires, sauf indication contraire.

Attribut	Type	Exemple	Description
`stripe_merchant_id`	ID du compte connecté Stripe	`acct_abcdef1234`	Identifiant de l’ID du compte connecté Stripe.
`transaction_id`	Chaîne	Toute valeur de type `my_internal_id` ou `Check Number 1234`	Identifiant de la transaction : Celui-ci doit être unique pour toutes les transactions et toutes les périodes. Identifiant arbitraire vous permettant de suivre une transaction donnée.
`capture_date`	Date au format `YYYY-MM-DD` dans le fuseau horaire UTC.	`2022-01-27`	Date à laquelle le paiement a bien été capturé : Il s’agit de la date de capture du paiement, et non de la date d’autorisation.
`payer_id`	Chaîne	Toute valeur de type `my_internal_payer_id` ou `Customer Number 1234`	Identifiant du payeur : Identifiant unique et arbitraire correspondant à un client du marchand en question.
`processor_id`	Chaîne	`stripe` ou toute autre valeur comme `checks` ou `App Store`	Identifiant du prestataire lié à cette transaction : `stripe` si Stripe a traité cette transaction Ou alors un identifiant anonymisé et arbitraire permettant de regrouper la source d’un ensemble de transactions.
`payment_method`	Chaîne	`check`, `cash`, `credit_card`, `paypal`, `Zelle` et autres	Moyen de paiement utilisé pour cette transaction.
`transaction_amount`	Nombre entier	`1234` lorsqu’un acheteur paie 12,34 USD au marchand ou lorsque le marchand rembourse 12,34 USD à l’acheteur.	Montant en chiffres de la transaction sans aucun symbole de devise : Exprimé en sous-unités (en cents pour le dollar USD). Jamais négatif. L’attribut `transaction_type` sert à indiquer la direction de la variation de solde.
`transaction_currency`	Trois lettres minuscules code de devise ISO	`usd`	Il s’agit du code ISO à trois lettres de la devise de la transaction : Devise dans laquelle la transaction a été capturée avant toute opération de change.
`transaction_type`	`credit` ou `debit`	`credit` lorsqu’un acheteur paie le marchand `debit` lorsque le marchand rembourse un acheteur	Le type de transaction : `credit` si la transaction augmente le solde du marchand (paiement) `debit` si la transaction diminue le solde du marchand (remboursement ou litige)
`fee_amount`	Nombre entier	`100` lorsque le prestataire ou la plateforme débite au marchand des frais de 1 USD ou lorsque le prestataire ou la plateforme rembourse des frais de 1 USD au marchand.	Le montant des frais associés à la transaction : Exprimé en sous-unités (en cents pour le dollar USD). Jamais négatif. Définissez `fee_amount` sur `0` si les frais sont inconnus ou nuls. L’attribut `fee_type` sert à indiquer la direction de la variation de solde.
`fee_type`	`credit` ou `debit`	`credit` lorsque le prestataire rembourse les frais au marchand `debit` lorsque le prestataire débite les frais au marchand	Le `fee_type` : `credit` si les frais augmentent le solde du marchand (le prestataire de services rembourse les frais au marchand) `debit` si les frais diminuent le solde du marchand (le prestataire de services débite des frais au marchand). Définissez `fee_type` sur `debit` si les frais sont inconnus ou nuls.
`version`	Nombre entier	`1742323922`	Horodatage Unix représentant le moment où le fichier a été généré : Cette valeur doit être la même pour toutes les lignes d’un fichier.
`additional_data` (facultatif)	Chaîne clé-valeur	`"{'key1':'value1','key2':'value2'}"` `""` Laisser vide	Chaîne facultative de paires clé-valeur, utile pour stocker des informations supplémentaires sur la transaction dans un format structuré : Définissez `additional_data` sur `""` ou laissez la valeur vide s’il n’y a pas d’informations supplémentaires.

Validez votre schéma

Dans le Dashboard des séries importées, sélectionnez le bouton bascule Mode test pour lancer en premier lieu une importation sur vos données de test.

Pendant les tests

Ne chargez pas de données de production dans l’environnement de test. Les utilisateurs disposant d’autorisations de niveau inférieur peuvent consulter ces données, ce qui peut constituer un risque de sécurité.

Cliquez sur Importer un fichier, en spécifiant que le schéma doit être CAPITAL Transaction Schema.
Cliquez sur Télécharger l’exemple de fichier pour voir un exemple du format requis avant de charger votre fichier CSV.
Choisissez le modèle complet que vous souhaitez charger.

Résoudre les erreurs de validation de schéma

Voici quelques erreurs courantes de validation de schéma :

Erreur	Résolution des problèmes
Dates non valides	Assurez-vous que toutes les dates sont au format d’horodatage epoch ou Unix.
Données manquantes	Assurez-vous que chaque enregistrement contient les champs requis.
Types d’attributs incompatibles	Assurez-vous que les attributs sont conformes à leurs types (p. ex. `transaction_type` doit être `credit` ou `debit`).
Données trop volumineuses	Divisez vos données en plusieurs fichiers CSV, d’une taille maximale par fichier de 50 Mo avec l’API Stripe ou de 1 Go si vous les chargez à l’aide du Dashboard et du connecteur de données S3.

Si le fichier que vous avez chargé comporte des erreurs, le fichier importé affiche un récapitulatif des échecs. Pour corriger les erreurs :

Cliquez sur Télécharger pour examiner les erreurs.
Examinez la colonne des messages d’erreur pour prendre connaissance des erreurs.
Corrigez toutes les erreurs.
Chargez à nouveau le fichier CSV corrigé.
Prenez le temps de consulter le dernier état de validation et de traitement.

Préparer une analyse préliminaire de Stripe Capital

Chargez des données ponctuelles de tiers pour analyser la manière dont elles contribuent à la génération d’offres destinées à vos utilisateurs. Nous vous recommandons de fournir les données historiques des 24 derniers mois afin d’évaluer vos données avec précision et d’améliorer notre évaluation des risques.

Remarque

Nous ne prenons en charge que les fichiers individuels d’une taille maximale de 10 Mo pour l’analyse initiale. Si vos données sont plus volumineuses, répartissez-les sur plusieurs fichiers.

Collectez et formatez vos données de production dans un fichier CSV en suivant le schéma de données.
En mode production, importez chaque fichier CSV dans Stripe à l’aide de l’API Stripe ou du connecteur de données Amazon S3, ou en chargeant manuellement les fichiers un par un dans le Dashboard des séries importées.
a. Si votre fichier est trop volumineux, divisez-le en plusieurs fichiers CSV. Si cela génère un grand nombre de fichiers, nous vous recommandons d’intégrer le connecteur de données S3.
b. Assurez-vous que version est défini sur l’horodatage Unix actuel pour toutes les lignes du fichier.

Stripe pourra vous contacter pour corriger tout problème de qualité des données détecté lors de vos importations en mode production.

Configurer des importations de données quotidiennes et automatisées

Une fois l’analyse préliminaire terminée, configurez votre intégration d’importation quotidienne de données à l’aide de l’API Stripe ou le connecteur de données Amazon S3 pour permettre des chargements quotidiens automatisés de données agrégées. Chargez des données quotidiennement pour disposer d’informations exactes et à jour. Le fait de garder une vue en temps réel de la santé financière de vos utilisateurs nous permet de prendre des décisions plus éclairées quand à l’évaluation des risques. Si vous avez d’autres questions sur la configuration de vos importations de données, contactez-nous.

Autres méthodes d’importation de données :

Vous pouvez utiliser le Dashboard des séries importées pour charger manuellement et ponctuellement des données externes sans rédiger de code. Après avoir validé vos données de transactions de test dans un environnement de test, deux options s’offrent à vous pour automatiser les importations quotidiennes avec des données de production :

Utilisez les API de Stripe pour automatiser entièrement vos importations.
Configurer des importations récurrentes no-code à l’aide d’un connecteur de données, p. ex. Amazon S3.

Quelle que soit la méthode utilisée, les fichiers que vous chargez apparaissent toujours dans le Dashboard.

Importation automatisée de fichiers récurrents à l’aide de connecteurs de données

Si vos fichiers de données transactionnelles sont stockés dans Amazon S3, vous pouvez utiliser le connecteur de données Amazon S3 pour les importer dans Stripe. Suivez les instructions du Stripe connector for Amazon S3 pour configurer votre connecteur. La taille maximale du fichier importé via le connecteur de données est de 1 Go.

Chargement automatisé des données à l’aide de l’API Stripe

Utilisez l’API File Upload pour envoyer des documents à Stripe en toute sécurité. Pour charger un fichier, envoyez une requête de type multipart ou form-data à https://files.stripe.com/v1/files. Veuillez noter que le sous-domaine files.stripe.com est différent de la plupart des endpoints d’API de Stripe. La requête doit préciser l’objectif data_management_manual_upload et contenir vos données tierces modélisées au format CSV. La taille maximale des fichiers que vous pouvez charger via l’API est de 50 Mo.
Dans l’exemple suivant, un objet File est renvoyé en cas de succès, puis un fichier ayant pour emplacement /path/to/a/file.jpg est chargé sur votre système de fichiers local :
Command Line
```
curl https://files.stripe.com/v1/files \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -F file="@/path/to/a/file.csv" \
  -F purpose=data_management_manual_upload
```
Utilisez l’API Data Management pour créer un objet ImportSet. Un ImportSet représente une demande d’importation d’un fichier de données tiers dans le Dashboard de gestion des données de Stripe. Étant donné que l’API Data Management est en version bêta, spécifiez l’en-tête bêta Stripe-Version: 2024-12-18.acacia;udap_beta=v1 dans votre requête.
Dans l’exemple suivant, un objet ImportSet est créé à partir de file_abcdef, que l’API File Upload a renvoyé à l’étape précédente :
Command Line
```
curl https://api.stripe.com/v1/data_management/import_sets \
  -H "Stripe-Version: 2024-12-18.acacia;udap_beta=v1" \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d file="file_abcdef" \
  --data-urlencode source_data_format="gsdf_61S7vBSIsrNXP3yYM5G6S"
```

Pour créer des téléchargements de fichiers et des objets ImportSet de test, utilisez votre clé API de test dans votre requête.