For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/fr/guides/public-cloud/data-platform/connectors-sources-stripe.md.

Extrayez vos données de paiement Stripe avec le connecteur Data Platform

Voir en Markdown

Le connecteur Stripe extrait les données de votre compte Stripe : clients, charges, intentions de paiement, abonnements, factures, produits, transactions de solde

Objectif

Le connecteur Stripe extrait les données de votre compte Stripe : clients, charges, intentions de paiement, abonnements, factures, produits, transactions de solde, événements, et plus encore.

76 ressources d'endpoint regroupées en 12 groupes de domaine + 4 endpoints filtrés + 3 endpoints autonomes + un endpoint custom pour tout chemin de ressource Stripe.

Le connecteur renvoie le JSON brut de l'API Stripe. La platform aplatit automatiquement les objets imbriqués en colonnes et stocke le résultat dans le lakehouse. Aucune définition manuelle de schéma n'est nécessaire.

1. Obtenir une clé API Stripe

Créer un compte

  1. Inscrivez-vous sur dashboard.stripe.com/register, gratuit, sans carte bancaire requise
  2. Chaque compte démarre avec un sandbox (mode Test), accès API complet, sans frais réels

Obtenir la clé secrète

  1. Connectez-vous à votre Stripe Dashboard
  2. Assurez-vous que le bouton Test mode est activé (en haut à droite du dashboard)
  3. Allez dans Developers > API Keys
  4. Copiez la Secret key : elle commence par sk_test_ en mode test, sk_live_ en mode live
Info

Important : utilisez la Secret key (sk_test_... / sk_live_...), pas la Publishable key (pk_*). La Publishable key est côté client uniquement et ne peut pas appeler la plupart des endpoints de l'API.

2. Configurer les identifiants

Collez votre clé secrète dans le champ Clé API Stripe :

sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Le connecteur utilise l'authentification par Bearer token. Aucune configuration de scope n'est nécessaire. La clé secrète dispose d'un accès API complet.

3. Endpoints disponibles

Le connecteur est organisé en 20 endpoints. La plupart regroupent des ressources liées avec un menu déroulant « Resource Type ».

Groupes de domaine (12)

EndpointRessources inclusesRemarques
corecustomers, charges, payment_intents, balance_transactions, payouts, refunds, disputes, setup_intents, events, files, file_links, webhook_endpoints, payment_method_configurations, payment_method_domainsRessources de paiement principales
productsproducts, prices, coupons, promotion_codes, tax_codes, tax_rates, shipping_ratesCatalogue et tarification
billingsubscriptions, subscription_schedules, invoices, invoice_items, invoice_rendering_templates, credit_notes, plans, quotes, billing_meters, billing_alerts, billing_credit_grantsFacturation récurrente
checkoutcheckout_sessions, payment_linksParcours de paiement hébergés
connectaccounts, application_fees, transfers, top_ups, country_specsMarketplace / platform
radarearly_fraud_warnings, reviews, value_listsDétection de fraude (Stripe Radar)
issuingauthorizations, cardholders, cards, transactions, disputes, personalization_designs, physical_bundlesNécessite Stripe Issuing
treasurytransactions, transaction_entries, outbound/inbound transfers, outbound/received payments, credits/debits, reversalsNécessite Stripe Treasury + un Financial Account ID
terminallocations, readers, configurationsNécessite Stripe Terminal
identityverification_sessions, verification_reportsNécessite Stripe Identity
climateorders, suppliers, productsNécessite Stripe Climate
reportingreport_runs, report_types, sigma_scheduled_query_runsRapports et Sigma

Endpoints filtrés (nécessitent un ID parent)

EndpointParamètre requisObjectif
payment_methodsCustomer ID (cus_xxx)Moyens de paiement rattachés à un client
setup_attemptsSetup Intent ID (seti_xxx)Tentatives de configuration pour un setup intent
subscription_itemsSubscription ID (sub_xxx)Lignes au sein d'un abonnement
financial_connections_transactionsAccount ID (fca_xxx)Transactions sur un compte lié

Endpoints autonomes

EndpointObjectif
financial_connections_accountsComptes bancaires liés (Financial Connections)
tax_registrationsEnregistrements fiscaux par juridiction
treasury_financial_accountsComptes financiers Treasury (aucun filtre nécessaire)

Endpoint personnalisé

EndpointParamètre requisObjectif
customResource PathTout endpoint de liste Stripe non couvert ci-dessus

Exemples de valeurs de Resource Path : issuing/settlements, treasury/statements, capital/financing_offers. Le préfixe /v1/ est optionnel. Le connecteur l'ajoute s'il est absent.

4. Ajouter une source Stripe sur Data Platform

  1. Dans les Connectors de la Data Platform, trouvez Stripe dans le source store et cliquez sur Select.
  2. Collez la clé secrète de l'étape 1 dans le champ Clé API Stripe.
  3. Cliquez sur Connect pour vérifier les identifiants. Le connecteur appelle GET /v1/balance comme contrôle de santé.
  4. Cliquez sur Add an Endpoint, choisissez un endpoint dans le menu déroulant (par ex. core, billing, custom), et le cas échéant sélectionnez un Resource Type (par ex. customers) et les éventuels paramètres requis (par ex. Customer ID pour payment_methods, Resource Path pour custom).
  5. Répétez l'étape 4 pour chaque endpoint supplémentaire que vous souhaitez ingérer dans cette source. Chacun devient une table distincte dans le lakehouse.
  6. Nommez la source et cliquez sur Create.
Warning

Le nom technique ne peut pas être modifié après la création de la source. Il est utilisé lors de l'ouverture de la source via le SDK Python de la Data Platform.

5. Exemple rapide : extraire les clients

  1. Endpoint : core
  2. Resource Type : customers
  3. Max Items : 100 (ou vide pour tout extraire)

Le connecteur renvoie le JSON brut de Stripe. La platform aplatit automatiquement les objets imbriqués (par ex. address.country devient une colonne address_country) et stocke le résultat dans le lakehouse.

6. Bonnes pratiques

Utiliser max_items lors des tests

Lors de la mise en place d'une nouvelle table, définissez max_items à 10 ou 100 pour vérifier rapidement le résultat. Stripe a une pagination généreuse (100 par page, total illimité), donc une extraction volumineuse peut prendre du temps sur les comptes avec beaucoup de données.

Extraire events pour un audit trail complet

L'endpoint events du groupe core contient chaque changement d'état de votre compte : client créé, abonnement mis à jour, charge remboursée, etc. C'est la meilleure source pour un journal d'audit incrémental.

Extraire les pipelines comme tables de référence

Les endpoints products, prices, plans et coupons fournissent des données de référence statiques. Extrayez-les séparément et joignez-les avec charges, subscriptions ou invoices pour vos analyses.

Utiliser balance_transactions pour le reporting financier

balance_transactions contient chaque mouvement sur votre solde Stripe, charges, remboursements, frais, virements, ajustements, le tout dans un seul flux unifié. C'est généralement le meilleur point de départ pour la réconciliation.

Secret key vs Restricted key

Pour de l'analyse en lecture seule, vous pouvez créer une Restricted API key (préfixe rk_test_ / rk_live_) avec uniquement les permissions Read sur les ressources dont vous avez besoin. C'est plus sûr qu'une Secret key complète. Allez dans Developers > API Keys > Restricted keys > Create restricted key.

7. Limitations

  • Préfixes de type statiques : chaque objet Stripe a un préfixe d'ID typé (cus_, ch_, sub_, pi_, in_, etc.), conservez-les pour effectuer des jointures entre les tables.
  • Les timestamps sont en secondes Unix, pas au format ISO 8601. Convertissez-les dans votre traitement en aval.
  • Certains endpoints nécessitent un produit Stripe spécifique (Issuing, Treasury, Terminal, Identity, Climate). Si le produit n'est pas activé sur votre compte, Stripe renvoie une erreur 400 et l'extraction échoue. Le connecteur n'ignore ni ne relance cette erreur.
  • L'activation des produits Stripe est gérée depuis votre Stripe Dashboard, en dehors de ce connecteur.
  • Mode Test vs mode Live : la Secret key détermine quelles données sont extraites. Une clé sk_test_ ne voit que les données du sandbox ; une clé sk_live_ ne voit que les données de production. Elles sont totalement isolées.
  • Particularité de la Reports API : /v1/reporting/report_types rejette le paramètre limit. Le connecteur relance automatiquement la requête sans ce paramètre. Aucune action nécessaire de votre part.
Info

Pour des informations techniques détaillées (internes de l'authentification, référence complète des endpoints, pagination, limites de débit, format de sortie, limitations), consultez la référence technique Stripe.

Aller plus loin

Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur ce lien pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services.

Posez vos questions, faites-nous part de vos commentaires et interagissez directement avec l’équipe qui développe la Data Platform sur le canal Discord dédié.

Si vous avez besoin d'une assistance concernant vos services OVHcloud, créez une demande depuis notre centre d'aide.

Rejoignez notre communauté d'utilisateurs.

Cette page vous a-t-elle aidé ?