Catalogue de produitsVersion bêta privée

Découvrez comment transmettre des données structurées sur les produits et les stocks à Stripe afin de faciliter leur découverte par les agents IA.

Appuyez-vous sur les spécifications du flux produits et stocks pour partager avec Stripe des données structurées sur vos articles et vos niveaux de stock, et distribuer votre catalogue auprès des agents IA dédiés à la recherche et aux achats. Commencez par envoyer un flux complet de produits, puis mettez vos stocks à jour grâce à des flux incrémentaux afin de garantir des niveaux et une disponibilité à jour.

Spécification du flux produit

Servez-vous du flux produit pour transmettre votre catalogue structuré complet (titres, descriptions, identifiants, prix, exécution des commandes et médias). Chaque ligne correspond à un produit ou à une variante.

Préparer votre flux : structurez votre catalogue selon la référence des champs fournie dans ce document. Chaque champ inclut des exemples de valeurs, des règles de validation et précise s’il est obligatoire, recommandé ou facultatif.
Transmettre le flux : envoyez votre flux en toute sécurité grâce à l’API Stripe au format CSV (détails d’intégration à venir). Chaque ligne correspond à un produit ou à une variante. Envoyez d’abord un flux complet dans l’endpoint de l’environnement de test pour confirmer que vos données sont correctement interprétées et respectent toutes les exigences, puis déployez en production.
Indexer et nettoyer vos données : nous validons et nettoyons vos données, les indexons dans le catalogue Stripe et les convertissons au format requis par chaque agent.
Keep your data current: Refresh your feed frequently. Any changes to product attributes, pricing, or fulfillment details should be updated as soon as they occur to maintain customer trust and prevent stale listings.

Mode de traitement des flux

Les chargements de flux produit se font en mode upsert, chaque ligne représentant l’insertion ou la mise à jour d’un produit identifié par son id.

Si l’id n’existe pas, nous créons le produit.
Si l’id existe déjà, le produit est mis à jour avec les valeurs indiquées dans la ligne correspondante.
Les produits absents du fichier conservent leur état actuel.

Comportement en cas de suppression

Pour supprimer un produit ou une variante via le flux, ajoutez la colonne facultative delete dans votre CSV. Mettez true pour les produits à supprimer et false ou laissez le champ vide pour ceux que vous souhaitez conserver.

Référence des champs du catalogue de produits

Vérifiez le schéma complet employé par le catalogue Stripe dans les sections ci-dessous. Chaque tableau présente les types de données, des exemples et les exigences.

Données produit de base

Fournissez les identifiants essentiels et la description permettant d’identifier chaque produit de façon unique.

Champ	Type de données	Exemple	Exigence	Remarques
id	Chaîne (alphanumérique)	`SKU12AB3456`	Obligatoire	Identifiant unique de votre produit Utilisez l’unité de gestion des stocks du produit lorsque c’est possible 100 caractères max. Conservez le même ID lors de la mise à jour de vos données
titre	Chaîne (texte UTF-8)	`Mens Floral Polo Shirt`	Obligatoire	Titre de votre produit Présentez votre produit avec précision et faites correspondre le titre à celui de votre page d’accueil. 150 caractères max. Évitez de tout mettre en majuscules
description	Chaîne (texte UTF-8)	`Bring a burst of fun to your golf game with this Men's Floral Polo`	Obligatoire	Description de votre produit Fournissez uniquement des informations relatives au produit. Ne mentionnez pas de liens vers votre boutique, de données de vente, de détails sur les concurrents, d’autres produits ou d’accessoires. 5 000 caractères max. Texte brut uniquement
lien	URL (RFC 1738)	`https://example.com/product/SKU12AB3456`	Obligatoire	Page de destination de votre produit Utilisez votre nom de domaine vérifié Commencez par `http` ou `https` (`https` recommandé) Doit renvoyer un code `http` 200 (aucun lien brisé)

Identifiants du produit

Utilisez ces identifiants universels pour faciliter la distinction de vos produits dans les recherches et les correspondances.

Champ Type de données Exemple Exigence Remarques

Champ	Type de données	Exemple	Exigence	Remarques
marque	Chaîne	`Stripe`	Obligatoire pour tous, sauf pour les marques de films, de livres et d’enregistrements musicaux	Nom de la marque de votre produit Indiquez le nom de la marque du produit, tel qu’il est généralement reconnu par les consommateurs. 70 caractères max.
gtin	Chaîne (GTIN numérique, UPC, ISBN)	`3234567890126`	Recommandé	Numéro d’article commercial mondial (GTIN) de votre produit 50 caractères max. Exclure les tirets et les espaces
mpn	Chaîne (alphanumérique)	`STR12345`	Obligatoire si le GTIN n’est pas disponible	Numéro de pièce fabricant (MPN) de votre produit Soumettez uniquement les MPN attribués par un fabricant 70 caractères max.

marque

Chaîne

Stripe

Obligatoire pour tous, sauf pour les marques de films, de livres et d’enregistrements musicaux

Nom de la marque de votre produit

Indiquez le nom de la marque du produit, tel qu’il est généralement reconnu par les consommateurs.
70 caractères max.

gtin

Chaîne

(GTIN numérique, UPC, ISBN)

3234567890126

Recommandé

Numéro d’article commercial mondial (GTIN) de votre produit

50 caractères max.
Exclure les tirets et les espaces

mpn

Chaîne

(alphanumérique)

STR12345

Obligatoire si le GTIN n’est pas disponible

Numéro de pièce fabricant (MPN) de votre produit

Soumettez uniquement les MPN attribués par un fabricant
70 caractères max.

Médias

Proposez des visuels et, si nécessaire, des médias enrichis afin de représenter le produit fidèlement.

Champ	Type de données	Exemple	Exigence	Remarques
image_link	URL (RFC 1738)	`https://example.com/image1.jpg`	Obligatoire	L’URL de l’image principale de votre produit Utiliser le format JPEG ou PNG Doit commencer par `http` ou `https` (de préférence `https`) Doit être accessible publiquement Taille minimale recommandée : 800 × 800 px Évitez les filigranes, les textes superposés ou les éléments graphiques promotionnels
additional_image_link	Tableau d’URL (RFC 1738)	`https://example.com/image2.jpg,…`	Facultatif	Les URL des images supplémentaires pour votre produit Respectez les mêmes exigences que pour `image_link` Maximum de 10 images prises en charge Proposez des images sous plusieurs angles, incluant l’emballage ou des mises en situation Pour ajouter une image, soumettez l’URL encodée : `https://www.example.com/image2.jpg` Pour soumettre plusieurs images (jusqu’à 10), utilisez une virgule pour séparer chaque URL (par exemple : `https://www.example.com/image2.jpg,https://www.example.com/image3.jpg`). Assurez-vous d’encoder les virgules présentes dans l’URL (en %2C), sans encoder celles servant à séparer chaque URL d’image : `https://www.example.com/image2%2C3.jpg,https://www.example.com/image2%2C4.jpg`
video_link	URL (RFC 1738)	`https://youtu.be/12345`	Facultatif	Une vidéo du produit montrant son utilisation ou le déballage. Le contenu doit être accessible publiquement (par exemple : YouTube, Vimeo ou un lien MP4 direct) Formats recommandés : MP4, MOV ou WebM Durée recommandée : 15 à 60 secondes Ajoutez un fichier audio seulement si cela est pertinent pour le produit (par exemple : démo sonore) Veillez à présenter le même produit que celui de l’image principale de manière claire
model_3d_link	URL (RFC 1738)	`https://www.example.com/products/xyz.glb`	Facultatif	Lien supplémentaire permettant d’afficher un modèle 3D de votre produit Formats préférés : GLB ou GLTF Doit être accessible publiquement Pour un chargement optimal, le fichier doit rester en dessous de 20 Mo Veillez à ce que le modèle représente avec précision la forme et la couleur du produit

Informations sur l’article

Décrivez les caractéristiques physiques et la classification pour garantir un filtrage précis et un positionnement correct dans la taxonomie.

Champ	Type de données	Exemple	Exigence	Remarques
condition	Énumération (`new`, `refurbished`, `used`)	`new`	Obligatoire si le produit n’est pas neuf	L’état de votre produit au moment de la vente `new` : article neuf, dans son emballage d’origine non ouvert `refurbished`: restauré professionnellement et pleinement fonctionnel, livré avec garantie, l’emballage d’origine peut être manquant. `used`: produit d’occasion, emballage d’origine ouvert ou absent.
google_product_category	Chaîne (Valeur provenant de la taxonomie produit Google. Utilisez l’ID numérique de la catégorie ou le chemin complet de la catégorie.)	`2271` ou `Apparel & Accessories > Clothing > Dresses`	Recommandé	Catégorie de produit Google prédéfinie Incluez uniquement la catégorie la plus pertinente Indiquez soit le chemin complet de la catégorie, soit l’ID numérique de la catégorie, mais pas les deux. Privilégiez l’ID de catégorie quand cela est possible.
product_category	Chaîne (Taxonomie des catégories)	`Apparel & Accessories > Clothing > Outerwear`	Obligatoire si `google_product_category` n’est pas renseigné.	Catégorie de produit que vous attribuez à votre produit Utiliser `>` comme séparateur Inclure la catégorie complète Exclure les tirets et les espaces
age_group	Énumération (`newborn`, `infant`, `toddler`, `kids`, `adult`)	`infant`	Facultatif	Le public cible de votre produit `newborn` : 0 à 3 mois `infant` : 3 à 12 mois `toddler` : 1 à 5 ans `kids` : 5 à 13 ans `adult` : adolescents ou plus âgés
matériau	Chaîne	`leather`	Obligatoire si cela est pertinent pour distinguer différents produits dans un ensemble de variantes	Tissu ou matériau principal de votre produit 100 caractères max.
longueur	Quantité et unité (`cm` et `in`)	`20 in`	Facultatif	Longueur de votre produit Utilisez la même unité de mesure pour tous les attributs de dimension du produit, incluant la longueur, la largeur et la hauteur. Les valeurs décimales sont prises en charge
largeur	Quantité et unité (`cm` et `in`)	`20 in`	Facultatif	Largeur de votre produit Utilisez la même unité de mesure pour tous les attributs de dimension du produit, incluant la longueur, la largeur et la hauteur. Les valeurs décimales sont prises en charge
hauteur	Quantité et unité (`cm` et `in`)	`20 in`	Facultatif	Taille de votre produit Utilisez la même unité de mesure pour tous les attributs de dimension du produit, incluant la longueur, la largeur et la hauteur. Les valeurs décimales sont prises en charge
poids	Quantité et unité (`lb`, `oz`, `g`, `kg`)	`2,5 lb`	Facultatif	Poids de votre produit Indiquez le poids réel du produit une fois assemblé pour cet attribut Les valeurs décimales sont prises en charge

Variantes

Définissez les relations entre variantes, telles que la couleur et la taille, pour que les unités de gestion des stocks liées se regroupent sous un parent unique. Lors de la soumission de variantes, chaque variante doit comporter le même item_group_id.

Champ	Type de données	Exemple	Exigence	Remarques
item_group_id	Chaîne	`Shoe1234`	Obligatoire si des variantes existent	ID d’un groupe de produits disponibles en différentes variantes Attribuez une valeur unique à chaque groupe de variantes. Privilégiez l’unité de gestion des stocks parent quand c’est possible. Conservez la même valeur lors de la mise à jour des données de votre produit 70 caractères max. Utilisez le même ensemble d’attributs de variante pour tous les produits ayant le même `item_group_id`. Par exemple, si une robe est disponible en deux couleurs et deux tailles, chaque variante doit comporter des valeurs pour la couleur et la taille.
item_group_title	Chaîne (texte UTF-8)	`Shoes`	Facultatif	Titre du groupe de votre produit Choisissez un nom clair et compréhensible par l’utilisateur pour désigner le groupe de variantes associées (par exemple : « Men’s Running Shoes »). 150 caractères max. Évitez d’utiliser uniquement des lettres majuscules
couleur	Chaîne	`Black`	Recommandé (vêtements)	Couleur de votre produit Lorsque votre produit est disponible en plusieurs couleurs, précisez la couleur principale. Recommended length: ≤ 40 characters Maximum length: 100 characters
taille	Chaîne	`10`	Recommandé (vêtements)	Taille de votre produit 20 caractères max.
size_system	Code pays (ISO 3166)	`US`	Recommandé (vêtements)	Système de tailles Code pays à deux lettres
genre	Énumération (`male`, `female`, `unisex`)	`male`	Recommandé (vêtements)	Le genre auquel votre produit est destiné

Disponibilité et inventaire

Fournissez le statut des stocks en direct ainsi que les quantités afin d’assurer la précision des achats.

Champ	Type de données	Exemple	Exigence	Remarques
disponibilité	Énumération (`in_stock`, `out_of_stock`, `preorder`, `backorder`)	`in_stock`	Obligatoire pour tous les produits	Disponibilité de votre produit
availability_date	Date (ISO 8601)	`2026-02-24`	Obligatoire si la disponibilité du produit est définie sur `preorder`	Date de disponibilité à la livraison pour un produit en précommande
expiration_date	Date (ISO 8601)	`2026-12-31`	Facultatif	La date à laquelle votre produit cesse d’apparaître
inventory_not_tracked	Booléen (`true` ou `false`)	`false`	Facultatif	Indique si l’inventaire de votre produit est suivi. `true` : lorsque les stocks ne sont pas suivis (produits numériques ou fabriqués à la demande), le champ `inventory_quantity` doit être laissé vide. `false` : le suivi des stocks est activé et `inventory_quantity` doit être renseigné
inventory_quantity	Nombre entier (Entier non négatif)	`100`	Ce champ est obligatoire lorsque `inventory_not_tracked` est `false`. Laissez-le vide si `true`.	Nombre d’unités vendables pour cet article. Laissez le champ vide si `inventory_not_tracked` est `true`.

Prix et promotions

Indiquez les informations tarifaires pour l’affichage et la logique promotionnelle.

Champ	Type de données	Exemple	Exigence	Remarques
prix	Quantité et devise (ISO 4217)	`15.00 USD`	Obligatoire pour tous les produits	Prix de votre produit
sale_price	Quantité et devise (ISO 4217)	`12.99 USD`	Facultatif	Prix après réduction
sale_price_effective_date	Date (ISO 8601)	`2025-12-01/2025-12-15`	Obligatoire si vous avez fourni `sale_price`	Fenêtre de vente Séparez la date de début et la date de fin par un `/`
stripe_product_tax_code	Chaîne (Code fiscal produit Stripe (PTC))	`txcd_99999999`	Obligatoire si vous utilisez Stripe Tax pour le calcul des taxes	Utilisez des codes de taxe produit de Stripe pour classer vos produits et assurer un calcul précis des taxes. Ces codes permettent à Stripe de déterminer le taux de taxe correct en fonction du type de produit et de la juridiction.
tax_behavior	Énumération (`inclusive` ou `exclusive`)	`exclusive`	Facultatif	Précise si le prix de votre produit comprend les taxes applicables (TTC) ou non (hors taxes). Si ce champ n’est pas renseigné, la valeur par défaut est hors taxes.
applicable_fees	Chaîne (`country:region:fee_label:fee_amount` : saisissez chaque option comme une valeur délimitée par des deux-points, et utilisez des virgules pour séparer plusieurs entrées.)	`US:CA:Recycling Fee:0.25 USD,DE:ALL:Bottle Deposit:0.10 EUR`	Facultatif (obligatoire lorsque des frais réglementaires ou régionaux s’appliquent)	Utilisez ce champ pour indiquer les frais par unité et les majorations selon le type de produit et la région. Ces frais ne doivent pas être inclus dans le prix de base du produit, ils sont conçus pour s’afficher comme des sous-postes séparés lors du paiement et dans les rapports. Formatez chaque frais sous forme de valeur séparée par des deux-points : `country` (obligatoire) : code pays ISO 3166-1 alpha-2 (par exemple : US ou DE) `region` (Obligatoire) : indiquez une région, un État, un territoire ou une préfecture (par exemple : CA). Utilisez `ALL` pour que la règle s’applique à toutes les régions ou provinces du pays indiqué. `fee_label` (Obligatoire) : nom compréhensible par l’utilisateur pour la taxe ou le frais (par exemple : frais de recyclage, consigne sur bouteille ou éco-contribution). Évitez d’utiliser des deux-points dans le nom. `fee_amount` (Obligatoire) : frais fixe par unité, avec un point comme séparateur décimal et le code devise ISO 4217 (par exemple : 5.00 USD).

Réalisation

Indiquez les options de livraison, les coûts et les délais de livraison prévus.

Champ Type de données Exemple Exigence Remarques

Champ	Type de données	Exemple	Exigence	Remarques
shipping	Chaîne (`country:region:service:speed_range:price` : saisissez chaque option comme une valeur délimitée par des deux-points, et utilisez des virgules pour séparer plusieurs entrées.)	`US:ALL:Standard Shipping:3-5:0.00 USD,US:ALL:Expedited Shipping:1-2:12.99 USD`	Obligatoire si le produit peut être expédié (par exemple : un bien physique)	Les frais de livraison de votre produit, les délais de livraison et les destinations vers lesquelles votre produit peut être expédié. Formatez chaque option de livraison comme une valeur délimitée par des deux-points : `country` (Obligatoire) : fournissez un code pays ISO 3166-1 alpha-2 indiquant le pays où le produit peut être livré (par exemple : US, DE). `region` (Obligatoire) : indiquez une région, un État, un territoire ou une préfecture en utilisant le code de subdivision ISO 3166-2 (code de subdivision US), sans le préfixe du pays (par exemple : VA ou NY). Utilisez ALL comme caractère générique pour indiquer que la règle d’expédition s’applique à toutes les régions ou provinces du pays spécifié. `service` (Obligatoire) : nom compréhensible par l’utilisateur pour le service (par exemple : livraison standard ou express). `speed_range` (facultatif) : nombre minimum et maximum de jours nécessaires pour la livraison (par exemple : 3-5). `price` (Obligatoire) : indiquez des frais de livraison fixes en utilisant un point comme séparateur décimal et le code devise ISO 4217 (par exemple : 3.00 USD).
free_shipping_threshold	Chaîne (`country:price`)	`US:16.00 USD`	Facultatif	Montant minimum de commande pour bénéficier de la livraison gratuite `country` (obligatoire) : code pays ISO 3166-1 alpha-2 `price_threshold` (obligatoire) : montant total de la commande à partir duquel la livraison est gratuite

shipping

Chaîne

(country:region:service:speed_range:price : saisissez chaque option comme une valeur délimitée par des deux-points, et utilisez des virgules pour séparer plusieurs entrées.)

US:ALL:Standard Shipping:3-5:0.00 USD,US:ALL:Expedited Shipping:1-2:12.99 USD

Obligatoire si le produit peut être expédié (par exemple : un bien physique)

Les frais de livraison de votre produit, les délais de livraison et les destinations vers lesquelles votre produit peut être expédié.

Formatez chaque option de livraison comme une valeur délimitée par des deux-points :
- country (Obligatoire) : fournissez un code pays ISO 3166-1 alpha-2 indiquant le pays où le produit peut être livré (par exemple : US, DE).
- region (Obligatoire) : indiquez une région, un État, un territoire ou une préfecture en utilisant le code de subdivision ISO 3166-2 (code de subdivision US), sans le préfixe du pays (par exemple : VA ou NY). Utilisez ALL comme caractère générique pour indiquer que la règle d’expédition s’applique à toutes les régions ou provinces du pays spécifié.
- service (Obligatoire) : nom compréhensible par l’utilisateur pour le service (par exemple : livraison standard ou express).
- speed_range (facultatif) : nombre minimum et maximum de jours nécessaires pour la livraison (par exemple : 3-5).
- price (Obligatoire) : indiquez des frais de livraison fixes en utilisant un point comme séparateur décimal et le code devise ISO 4217 (par exemple : 3.00 USD).

free_shipping_threshold

Chaîne

(country:price)

US:16.00 USD

Facultatif

Montant minimum de commande pour bénéficier de la livraison gratuite

country (obligatoire) : code pays ISO 3166-1 alpha-2
price_threshold (obligatoire) : montant total de la commande à partir duquel la livraison est gratuite

Indicateurs de performance et de vérification

Partagez les indicateurs de performance et de vérification pour permettre aux agents IA et aux systèmes de classement de repérer les produits fiables et de grande qualité.

Ces champs sont facultatifs mais conseillés. Ils optimisent la découverte, le classement et la personnalisation sur l’ensemble des interfaces agentiques.
Transmettez uniquement des indicateurs agrégés, en excluant toute donnée utilisateur ou informations d’identification personnelles.
Mettez à jour ces indicateurs périodiquement (par exemple, chaque semaine) afin de garantir leur précision.

Champ	Type de données	Exemple	Exigence	Remarques
popularity_score	Numéro (Échelle de 0 à 5)	`4.7`	Recommandé	Indicateur de popularité global pour ce produit ou cette variante Utilisez une échelle uniforme de 0 à 5 sur tout le catalogue (0 = le plus bas, 5 = le plus élevé) Calculez ces informations en vous basant sur des indicateurs comme les vues, les ajouts au panier, les conversions ou le classement des ventes. Appliquez une fenêtre d’agrégation uniforme (par exemple, les 90 derniers jours) afin de maintenir des données à jour
return_rate	Numéro (0 à 100 (ne pas inclure le symbole `%`))	`2.0`	Recommandé	Pourcentage d’unités retournées pour ce produit ou cette variante Exprimez sous forme de pourcentage numérique compris entre 0 et 100 (par exemple : 2,0 pour 2 %). Appliquez une fenêtre d’agrégation uniforme (par exemple, les 90 derniers jours)
product_review_count	Nombre entier (Entier non négatif)	`124`	Recommandé	Nombre total d’avis associés à ce produit ou à cette variante Correspond à la population utilisée pour calculer `product_review_rating` Utiliser 0 si aucun avis n’existe Afficher, autant que possible, les avis provenant d’achats vérifiés
product_review_rating	Numéro (Échelle de 1 à 5)	`4.3`	Obligatoire si `product_review_count` est supérieur à 0	Note moyenne des avis pour ce produit ou cette variante Utilisez une échelle uniforme de 1 à 5 sur tout le catalogue (1 = le plus bas, 5 = le plus élevé) Doit correspondre au même jeu de données que `product_review_count` Laissez ce champ vide si `product_review_count` est égal à 0

Instructions de traitement des flux

Définit les champs opérationnels permettant de gérer le traitement de chaque ligne du flux par le système.

Champ Type de données Exemple Exigence Remarques

Champ	Type de données	Exemple	Exigence	Remarques
supprimer	Booléen (`true` ou `false`)	`true`	Facultatif	Signale que le produit ou la variante doit être retiré de manière permanente Si la valeur est `true`, le produit identifié par `id` est supprimé et toutes les autres colonnes de la ligne sont ignorées Si le champ est absent ou défini sur `false`, la ligne est traitée comme un upsert classique.

supprimer

Booléen

(true ou false)

true

Facultatif

Signale que le produit ou la variante doit être retiré de manière permanente

Si la valeur est true, le produit identifié par id est supprimé et toutes les autres colonnes de la ligne sont ignorées
Si le champ est absent ou défini sur false, la ligne est traitée comme un upsert classique.

Utilisez la spécification du flux d’inventaire

Utilisez le flux de stocks pour actualiser la disponibilité des produits et les quantités en stock sans avoir à renvoyer l’intégralité de votre catalogue. Envoyez des mises à jour régulières depuis votre entrepôt, votre système de point de vente ou vos systèmes d’exécution des commandes afin que vos produits reflètent un statut en stock précis dans les interfaces agentiques.

Maintenir votre flux produit synchronisé : les valeurs id présentes dans votre fichier de stocks doivent correspondre à celles du flux principal du catalogue.
Transmettre régulièrement vos fichiers de stock : transmettez les mises à jour via l’API Stripe au format CSV.
Envoyer des mises à jour partielles : ne fournissez que les unités de gestion des stocks ayant changé, les autres conservent leur état de stock précédent.

Référence des champs du flux d’inventaire

Champs du flux d’inventaire

Fournissez le statut des stocks en direct ainsi que les quantités afin d’assurer la précision des achats.

Champ	Type de données	Exemple	Exigence	Remarques
id	Chaîne (alphanumérique)	`SKU12AB3456`	Obligatoire	Doit correspondre à l’`id` de votre flux principal de produits. Cette valeur est l’identifiant principal.
disponibilité	Énumération (`in_stock`, `out_of_stock`, `preorder`, `backorder`)	`in_stock`	Obligatoire pour tous les produits	Disponibilité de votre produit
availability_date	Date (ISO 8601)	`2026-02-24`	Obligatoire si la disponibilité du produit est définie sur `preorder`	Date de disponibilité à la livraison pour un produit en précommande
inventory_quantity	Nombre entier (Entier non négatif)	`100`	Obligatoire pour tous les produits	Unités vendables