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 manifeste son intention de passer commande et l’agent lance le processus de paiement auprès du marchand à l’aide d’une requête 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.) pour transmettre au client l’état actuel (par exemple, le total) ainsi que les options (par exemple, la livraison).
4. Une fois que le client a fait ses choix, l’agent et le marchand communiquent entre eux à l’aide d’une UpdateCheckoutRequest.
5. Une fois que le client a manifesté son intention de payer, l’agent fournit un SharedPaymentToken, paramétré pour le montant et le marchand, et 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 postes de facture, les méthodes de traitement et les informations sur le client au fur et à mesure que celui-ci 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 : notifiez l’agent de l’annulation lorsque le client quitte ou abandonne le paiement afin que vous puissiez libérer l’inventaire et mettre à jour l’état du paiement en le faisant passer à « 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 et des mises à jour de la commande. Par exemple, avertissez l’agent lorsque la 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.