Activez la vente contextuelle sur les agents IAVersion bêta privée

Découvrez comment commencer à vendre vos produits en contexte à l’aide d’agents IA.

Version bêta privée

Si votre entreprise souhaite vendre des produits via le commerce agentique, inscrivez-vous sur la liste d’attente.

Remarque

Ce guide s’adresse aux entreprises d’e-commerce. Pour les marketplaces souhaitant proposer la vente via un agent intégré sur leur plateforme, consultez notre guide pour plateformes et marketplaces.

Configurer votre compte Stripe

Si vous n’avez pas encore de compte Stripe, créez-en un. Une fois votre e-mail vérifié, vous pouvez activer les paiements en indiquant vos informations professionnelles et personnelles, en ajoutant un compte bancaire pour les virements et en configurant les mesures de sécurité, notamment l’authentification à deux facteurs.

Ensuite, accédez à Agentic Commerce Onboarding dans le Dashboard Stripe. Cela vous guide dans la création d’un profil Stripe et la configuration de divers paramètres pour Agentic Commerce.

Configurer les taxes

Utilisez Stripe Tax pour gérer les taxes et appliquer des configurations à chaque produit. Référez-vous au guide de configuration des taxes pour configurer Stripe Tax.

Lors du chargement de votre fichier CSV de catalogue de produits, utilisez la colonne stripe_product_tax_code pour relier un produit à un traitement fiscal.

Stripe prend également en charge le calcul des taxes par des prestataires tiers, comme Anrok, Avalara et Sphere.

Chargez les données de votre catalogue de produits sur Stripe

Créer un fichier CSV conforme aux spécifications du catalogue de produits Stripe.

Charger les données du catalogue dans Stripe

Transmettez le flux dans le Dashboard Stripe ou via l’API Stripe. Vous pouvez télécharger des flux à n’importe quelle fréquence. Pour que les données restent à jour, téléchargez les données sur les produits une fois par jour et envoyez des mises à jour incrémentielles plus fréquentes pour les stocks et les prix.

Remarque

Les téléchargements de flux sont traités comme des tâches indépendantes et asynchrones. Nous ne garantissons pas que les téléchargements soient traités ou terminés dans l’ordre dans lequel vous les soumettez. Si vous téléchargez plusieurs fichiers rapidement à la suite, un téléchargement ultérieur peut se terminer avant un téléchargement antérieur.

Utilisez les API Stripe pour téléverser votre CSV de catalogue de produits. Il est conseillé de passer par l’environnement de test pour valider l’analyse, le mappage des champs et la qualité des données avant de lancer les mises à jour en production.

Commencez par charger votre fichier CSV de catalogue de produits via l’API Fichiers. Une requête réussie retourne un objet Fichier contenant l’id.

Précisez l’objectif de data_management_manual_upload.
Le type MIME du fichier chargé doit correspondre à son format. Les formats pris en charge sont CSV et TSV, chaque ligne correspondant à un produit ou une variante.
La taille maximale du fichier est de 200 Mo.

Command Line
curl https://files.stripe.com/v1/files \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -F purpose=data_management_manual_upload \
  -F file="@/path/to/your/file.csv;type=text/csv"

Ensuite, utilisez l’API Gestion des données pour créer un ImportSet. Cet appel lance le traitement du catalogue et rend les données accessibles dans le Dashboard. Incluez les éléments suivants :

L’ID id du fichier renvoyé
En-tête de l’aperçu (par exemple : Stripe-Version: 2025-09-30.clover;udap_beta=v1)

Command Line
curl https://api.stripe.com/v1/data_management/import_sets \
  -H "Stripe-Version: 2025-09-30.clover;udap_beta=v1" \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d file={{FILE_ID}} \
  --data-urlencode standard_data_format="product_catalog_feed"

Surveillez l’état du flux et corrigez les erreurs

Stripe traite, valide et nettoie les données de votre catalogue, puis les organise dans un format prêt à être utilisé par des agents IA. Vous pouvez suivre l’avancement de l’indexation par Stripe de deux façons :

Effectuez une requête GET et vérifiez le champ status de l’objet ImportSet.Le champ status peut avoir l’une des valeurs suivantes : pending, failed, succeeded, succeeded_with_errors, pending_archive, ou archives.

Command Line
curl https://api.stripe.com/v1/data_management/import_sets/{{IMPORT_SET_ID}} \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

La réponse inclut le statut et les éventuelles erreurs :

{
  "id": "impset_7MabcdZ8b617780e5145413",
  "object": "data_management.import_set",
  "created": 1643992696,
  "livemode": true,
  "result": {
    "errors": {
      "file": "file_234923sIENc",
      "row_count": 30
    },
    "rows_processed": 120,
    "successes": {
      "row_count": 90
    }
  },
  "status": "succeeded_with_errors"
}

Lorsque le statut de l’importation est succeeded_with_errors, vous pouvez télécharger le rapport d’erreurs :

Vérifiez la présence du champ result.errors.file dans la réponse.
Utilisez l’API Fichiers pour récupérer le contenu du fichier d’erreurs à l’aide de l’ID du fichier.
Le fichier CSV téléchargé inclut vos données originales et une colonne stripe_error_message en tête, précisant pourquoi chaque ligne a échoué.

Command Line
curl https://files.stripe.com/v1/files/{{ERROR_FILE_ID}}/contents \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

L’API renvoie un fichier CSV incluant seulement les lignes en échec, avec une colonne stripe_error_message précisant chaque erreur.

Gérez les achats et assurez l’exécution des commandes

Vous pouvez suivre les commandes passées via des agents IA de trois manières :

Affichez les commandes sur la page Transactions du Dashboard, elles sont identifiées en fonction de l’agent qui les a initiées.

Activez la vente sur les agents de chat IA

Lorsque vous êtes prêt à vendre via un agent de chat IA, consultez les conditions d’utilisation de l’agent et activez-le dans le Dashboard Stripe. Stripe transmet à l’agent une demande d’approbation que l’agent doit accepter.

Pour suspendre ou arrêter les ventes par le biais d’un agent conversationnel IA, désactivez cet agent dans le Dashboard.

FacultatifConfigurez la capture manuelle

Par défaut, Stripe capture les paiements immédiatement après l’achat. Pour activer la capture manuelle, ouvrez la page des paramètres agentiques dans le Dashboard et définissez le mode de capture sur manuel. Une fois la capture manuelle activée, appelez la méthode capture sur le PaymentIntent.

Command Line
curl -X POST https://api.stripe.com/v1/payment_intents/pi_3MrPBM2eZvKYlo2C1TEMacFD/capture \
  -u "<secret_key>:" \
  -H "Stripe-Version: 2025-09-30.preview"

FacultatifConfigurez un hook d’approbation avant confirmation

Par défaut, nous vérifions les stocks selon les données de votre catalogue de produits et appliquons les contrôles de fraude de Radar avant de confirmer un paiement. Si vous souhaitez décider vous-même de la finalisation d’un achat, activez un hook d’approbation manuelle. Avant de finaliser le paiement, nous envoyons une demande d’approbation à votre service : vous pouvez alors accepter ou refuser la commande. Stripe impose un seuil d’expiration de 2 secondes à votre hook. Si ce dernier ne répond pas avant ce seuil, Stripe refuse le paiement.

Pour configurer un hook d’approbation manuelle :

Indiquez l’endpoint sur la page Paramètres du commerce agentique du Dashboard.
Déployez votre logique sur l’endpoint en respectant les formats de requête et de réponse présentés ci-dessous.

Format de requête d’approbation

Stripe envoie la requête suivante à votre endpoint :

{
  type: "v1.delegated_checkout.finalize_checkout",
  id: String,
  livemode: Boolean,
  // account ID
  context?: String,
  // request specific data
  data: {
    amount_subtotal?: Number,
    amount_total?: Number,
    billing_details?: {
      name?: String,
      address?: {
        line1?: String,
        line2?: String,
        city?: String,
        state?: String,
        postal_code?: String,
        country?: String
      }
    },
    currency: String,
    email?: String,
    line_items_details: Array<{
      id: String,
      unit_amount: Number,
      quantity: Number,
      name: String
    }>,
    payment_method_details?: {
      type: "card" | ...,
      card?: {
        brand: "amex" | "visa" | "master_card" | ...,
        country?: String,
        exp_month: Number,
        exp_year: Number,
        fingerprint?: String,
        funding: "credit" | "debit" | "prepaid" | "unknown",
        iin?: String,
        last4: String,
        wallet?: {
          type: "apple_pay" | "google_pay" | ...
        }
      }
    },
    phone?: String,
    shipping_details?: {
      name?: String,
      address?: {
        line1?: String,
        line2?: String,
        city?: String,
        state?: String,
        postal_code?: String,
        country?: String
      },
    },
    total_details?: {
      amount_discount?: Number,
      amount_shipping?: Number,
      amount_tax?: Number
    }
  }
}

Format de réponse à l’approbation avant confirmation

HTTP/1.1 200 OK
{
  manual_approval_details: {
    type: "approved" | "declined",
    declined?: {
      reason: String
    }
  }
}

FacultatifConfigurez un hook pour les options de livraison

Par défaut, Stripe calcule les options de livraison pour vos produits en fonction des options définies dans votre catalogue de produits. Chaque option comprend un nom, une description, un délai de livraison estimé et un coût. Vous pouvez activer la livraison gratuite par produit dans le catalogue de produits.

Pour calculer dynamiquement les options et coûts de livraison selon votre propre logique, implémentez le hook des options de livraison. Avant de renvoyer le paiement à l’agent, nous appelons votre hook avec les articles du panier. L’interface de l’agent présente ensuite les options et prix que vous avez déterminés.

Format de la requête

L’exemple ci-dessous illustre les données incluses dans la requête compute_shipping_options que Stripe envoie à l’endpoint de l’API annuler que vous configurez pour calculer les options de livraison :

{
  livemode: Boolean,
  currency: String,
  amount_total: Integer,
  amount_subtotal: Integer,
  total_details?: {
      amount_discount?: Number,
      amount_tax?: Number
  },
  line_items_details: [
      {
        sku_id: String,
        unit_amount: Integer,
        quantity: Integer,
        amount_subtotal: Integer,
        amount_total: Integer,
        amount_tax: Integer,
        amount_discount: Integer
      }
    ],
  fulfillment_details?: {
      address?: {
        line1?: String,
        line2?: String,
        city?: String,
        state?: String,
        postal_code?: String,
        country?: String
      }
    }
  }

Format de réponse des options de livraison

HTTP/1.1 200 OK
{
  fulfillment_options: [
    {
        display_name: String,
        description: String,
        earliest_delivery_time: Integer,
        latest_delivery_time: Integer,
        shipping_amount: Integer
     }
  ]
}

FacultatifEnvoyer des mises à jour d’inventaire incrémentielles

En plus de charger votre catalogue de produits, envoyez des mises à jour individuelles des stocks via l’API Inventory Feed. Utilisez le même processus que pour les catalogues, en définissant standard_data_format sur inventory_feed.

Command Line
# Step 1: Upload your CSV using the Files API
curl https://files.stripe.com/v1/files \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -F purpose=data_management_manual_upload \
  -F file="@/path/to/your/file.csv;type=text/csv"

# Step 2: Create an ImportSet object
curl https://api.stripe.com/v1/data_management/import_sets \
  -H "Stripe-Version: 2025-09-30.clover;udap_beta=v1" \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d file={{FILE_ID}} \
  --data-urlencode standard_data_format="inventory_feed"

FacultatifEnvoyer des mises à jour tarifaires complémentaires

Chargez votre catalogue de produits, puis envoyez des mises à jour tarifaires individuelles via l’API Price Feed. Utilisez le même processus que pour les catalogues, et définissez standard_data_format sur price_feed.

Command Line
# Step 1: Upload your CSV using the Files API
curl https://files.stripe.com/v1/files \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -F purpose=data_management_manual_upload \
  -F file="@/path/to/your/file.csv;type=text/csv"

# Step 2: Create an ImportSet object
curl https://api.stripe.com/v1/data_management/import_sets \
  -H "Stripe-Version: 2025-09-30.clover;udap_beta=v1" \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d file={{FILE_ID}} \
  --data-urlencode standard_data_format="price_feed"

FacultatifGérez les litiges et les remboursements

Une fois le paiement confirmé, si un client annule sa commande sur votre site Web ou par l’intermédiaire du service client, déclenchez un remboursement. Votre flux de remboursement actuel, basé sur les API Checkout Sessions ou PaymentIntents, reste entièrement opérationnel pour les paiements effectués par un agent.

Vous pouvez gérer les remboursements et les litiges directement dans le Dashboard, à la page Transactions, ou recourir à l’API Remboursement pour traiter les annulations et les remboursements par voie programmatique.

Voir aussi

Tokens de paiement partagés