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

Découvrez comment commencer à vendre vos produits directement via des agents IA en utilisant une solution low-code.

Version bêta privée

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

Remarque

This guide is for e-commerce businesses. If you’re a marketplace and want to offer in-context agentic selling on your platform, see our guide for platforms and 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.

Then, create your business’s public identity by setting up a Stripe profile in the Dashboard.

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

Envoyez le flux depuis le Dashboard Stripe ou via l’API Stripe. Les mises à jour peuvent être effectuées toutes les 15 minutes.

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 et nettoie les données de votre catalogue avant de les indexer dans un format adapté à l’envoi vers des agents IA. Vous pouvez suivre la progression de l’indexation grâce au champ status de l’ImportSet : les statuts possibles sont pending, failed, succeeded, succeeded_with_errors, pending_archive et archived.

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 mettre en pause ou cesser la vente via un agent de chat IA, désactivez l’agent dans le Dashboard ou transmettez une demande de résiliation par l’API Stripe :

Command Line
curl -X POST https://api.stripe.com/v2/agentic_commerce/agreements/{{AGREEMENT_ID}}/terminate \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

Nous envoyons des webhooks dès que votre contrat avec un agent IA est confirmé ou résilié :

agentic_commerce_agreement.confirmed
agentic_commerce_agreement.terminated

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.

Pour configurer un hook d’approbation manuelle :

Spécifiez l’endpoint dans le 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: String,
  id: String,
  livemode: Boolean,
  // account ID
  context?: String,
  // request specific data
  data: {
    amount_total: Integer,
    amount_subtotal: Integer,
    total_details?: {
      amount_discount?: Number,
      amount_fulfillment?: Number,
      amount_tax?: Number
    },
    currency: String,
    line_items_details: Array<{
      sku_id: String,
      unit_amount: Number,
      quantity: Number,
      amount_subtotal: Integer,
      amount_total: Integer,
      amount_tax: Integer,
      amount_discount: Integer
    }>,
    payment_method_details?: {
      type: "card" | ...,
      card?: {
        brand: "amex" | "visa" | "master_card" | ...,
        country?: String,
        exp_month: Number,
        exp_year: Number,
        funding: "credit" | "debit" | "prepaid" | "unknown",
        last4: String,
        wallet?: {
          type: "apple_pay" | "google_pay" | ...
        }
      },
      billing_details?: {
        name?: String,
        address?: {
          line1?: String,
          line2?: String,
          city?: String,
          state?: String,
          postal_code?: String,
          country?: String
        }
      },
    },
    fulfillment_details?: {
      name?: String,
      address?: {
        line1?: String,
        line2?: String,
        city?: String,
        state?: String,
        postal_code?: String,
        country?: String
      },
      email?: String,
      phone?: String,
    }
  }
}

Format de réponse

{
  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

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"

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