Intégrer le Protocole de commerce agentiqueVersion bêta privée

L’Agentic Commerce Protocol ou protocole de commerce agentique (ACP) est une spécification open source qui permet le commerce entre des applications compatibles, telles que ChatGPT, et des marchands. Vous pouvez le mettre en œuvre sous forme d’interface RESTful ou de serveur MCP.

Vous pouvez utiliser le protocole de commerce agentique pour rendre votre paiement accessible aux applications afin de lancer et de finaliser les paiements. Les formulaires d’inscription peuvent partager en toute sécurité les informations d’identification de paiement, y compris le Stripe SharedPaymentToken (SPT), pour les traiter dans votre suite d’outils de paiement existante.

Par exemple, dans un tunnel de paiement typique, l’interface utilisateur, le modèle de données et le traitement des paiements sont entièrement à la charge du marchand. Le marchand présente une page de paiement, stocke les données relatives au panier et à la commande, collecte les informations de paiement et traite le paiement.

En revanche, lors d’un traitement de paiement agentique, l’agent IA est responsable de la présentation de l’interface paiement et de la collecte des informations d’identification paiement, tandis que le marchand est responsable de son modèle de données existant et de son traitement de paiement.

Pour en savoir plus, consultez la section le site ACP.

Cycle de vie

Cette section décrit les étapes du processus de paiement, depuis l’intention initiale du client de passer commande jusqu’à la confirmation du paiement par le marchand.

1. Le client exprime son intention de commander, et l’agent initie le paiement auprès du marchand à l’aide d’un CreateCheckoutRequest.
2. Le marchand traite la requête et génère un panier, puis répond en indiquant l’état actuel du paiement.
3. L’agent affiche une interface utilisateur (interface de paiement, texte, etc.) afin de communiquer au client l’état actuel (par exemple, le total) ainsi que les options disponibles (par exemple, la livraison).
4. Une fois que le client a effectué ses sélections, l’agent et le vendeur communiquent entre eux à l’aide de UpdateCheckoutRequest.
5. Une fois que le client exprime son intention de payer, l’agent provisionne un SharedPaymentToken, défini pour le montant et le marchand, puis partage un CompleteCheckoutRequest avec le marchand.
6. Le marchand crée un PaymentIntent et envoie une confirmation à l’agent.

Endpoints

Le marchand met son paiement à la disposition des agents en créant une interface HTTP RESTful conforme à cette spécification avec les quatre points de terminaison suivants.

Pour traiter le processus de paiement :

1. Créez un objet Checkout : fournissez une unité de gestion des stocks (SKU) unique pour générer les données du panier et du paiement dans votre back-end. Votre réponse comprend des informations sur les moyens de paiement pris en charge, les options de traitement, etc.
2. Mettre à jour un objet Checkout : Mettez à jour les modifications telles que les quantités des éléments, les méthodes de réalisation et les informations client à mesure que le client progresse dans le processus de paiement.
3. Compléter un objet Checkout : Transmettez le SharedPaymentToken dans une requête. Traitez votre paiement au cours de cette requête et répondez avec les détails de la commande.
4. Annuler un objet Checkout : Informez l’agent de l’annulation lorsque le client quitte ou ferme le paiement, afin de pouvoir libérer le stock et mettre à jour l’état du paiement sur « annulé ».

Chaque réponse d’un point de terminaison comprend l’état actuel du paiement et sert de point de référence à l’agent.

Événements

Une fois le paiement terminé, informez l’agent de la création de la commande et de ses mises à jour. Par exemple, mettez à jour l’agent lorsqu’une commande a été expédiée. Cela permet à l’agent de communiquer les changements d’état, de demander des actions ou de partager d’autres informations avec le client.

Sécurité

Pour maintenir l’intégrité des transactions et protéger les informations sensibles dans le cadre du commerce agentique, suivez ces directives :

• Toutes les requêtes nécessitent HTTPS et incluentAuthorization: Bearer {token}.
• Signer tous les événements webhook et incluez une signature HMAC qui doit être envoyée en tant qu’en-tête de requête.
• Le formulaire d’inscription argentique doit fournir les clés d’autorisation et de signature lors de l’inscription des utilisateurs.