Activer les achats en contexte via les agents d’IAVersion bêta privée

Pour configurer votre plateforme et vos comptes connectés pour la vente agentique en contexte, fournissez les informations suivantes :

• ID du compte Stripe de la plateforme.
• ID des comptes connectés. Fournissez une liste d’ID de comptes connectés à activer pour la vente agentique en contexte. Vous pouvez envoyer une feuille de calcul ou un fichier texte, avec un ID de compte par ligne.

Préparer votre catalogue de produits

Créez un fichier CSV conforme à la spécification du catalogue de produits Stripe pour chaque compte connecté. Stripe fournit cette spécification séparément.

Charger les données du catalogue dans Stripe

Transmettez le flux via les API Stripe. Vous pouvez envoyer des mises à jour toutes les 15 minutes.

Utilisez l’environnement de test pour valider l’analyse, le mappage des champs et la qualité des données avant d’activer les mises à jour en production.

Commencez par charger le fichier CSV de votre catalogue de produits à l’aide de l’API Files. Une requête réussie renvoie un objet File, qui inclut l’id.

• Définissez data_management_manual_upload comme valeur du champ purpose.
• Assurez-vous que le type MIME correspond au format du fichier. Les formats acceptés incluent le CSV et le TSV, chaque ligne représentant un produit ou une variante.
• La taille maximale du fichier est de 200 Mo.

curl https://files.stripe.com/v1/files \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2: \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \
  -F purpose=data_management_manual_upload \
  -F file="@/path/to/your/file.csv;type=text/csv"

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

• L’ID id du fichier renvoyé
• L’en-tête de prévisualisation (par exemple Stripe-Version: 2025-09-30.clover;udap_beta=v1)

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

Surveiller l’état du flux

Stripe traite les données du catalogue, les valide, les nettoie, puis les indexe et les convertit dans un format compatible avec les agents d’IA. Suivez l’avancement de l’indexation à l’aide du champ status de l’ensemble d’importation. Le statut peut être pending, failed, succeeded, succeeded_with_errors, pending_archive ou archived.

curl https://api.stripe.com/v1/data_management/import_sets/{{IMPORT_SET_ID}} \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2: \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}"

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"
}

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

1. Recherchez le champ result.errors.file dans la réponse.
2. Utilisez l’API Files pour récupérer le fichier d’erreurs à partir de son ID.
3. Le fichier CSV téléchargé contient vos données d’origine, avec une colonne en tête nommée stripe_error_message expliquant la raison de l’échec de chaque ligne.

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

L’API renvoie un fichier CSV contenant uniquement les lignes en échec, avec une colonne stripe_error_message décrivant chaque erreur.

Écoutez les webhooks Stripe pour suivre les commandes passées via des agents de chat IA.

Lorsqu’une commande est confirmée, Stripe émet des événements webhook que votre serveur peut traiter pour exécuter la logique de traitement. Configurez un endpoint sur votre serveur pour accepter, traiter et accuser réception de ces événements. Consultez le Guide des webhooks pour obtenir des instructions détaillées sur l’intégration et le test des webhooks Stripe.

Stripe émet les événements checkout.session.completed et payment_intent.succeeded. Si votre logique de traitement des commandes gère déjà ces événements, aucune modification d’intégration supplémentaire n’est nécessaire. Vous pouvez personnaliser cette logique pour la vente agentique en contexte, par exemple en indiquant dans l’e-mail de confirmation de commande que le paiement a été effectué via un agent.

const stripe = require('stripe')(process.env.STRIPE_SECRET_KEY);

// Use the secret provided by Stripe CLI for local testing
// or your webhook endpoint's secret
const endpointSecret = 'whsec_...';

app.post('/webhook', (request, response) => {
  const sig = request.headers['stripe-signature'];
  let event;

  try {
    event = stripe.webhooks.constructEvent(request.body, sig, endpointSecret);
  } catch (err) {
    response.status(400).send(`Webhook Error: ${err.message}`);
    return;
  }

  if (event.type === 'checkout.session.completed') {
    const session = event.data.object;
    // Fulfill the order using the session data
    fulfillCheckout(session.id);
  }

  response.status(200).send();
});