# Construire les endpoints de paiement du Protocole de commerce agentique Découvrez la spécification du Protocole de commerce agentique. Vous pouvez utiliser le protocole ACP (Agentic Commerce Protocol) pour permettre aux agents d’IA de gérer les transactions commerce entre les clients et les marchands. Cette spécification définit les méthodes et les structures de données pour la création, la mise à jour et l’exécution des tunnels de paiement. Vous trouverez ci-dessous des exemples d’intégrations REST. > #### Terminologie du protocole de commerce agentique > > Certaines conditions utilisées pour définir le ACP sont similaires aux conditions utilisées dans les API Stripe. Veillez donc à les distinguer. Par exemple, dans ce contexte, une « session de paiement agentique » est une communication entre un marchand et un agent IA. Elle n’est pas liée à l’API Stripe Checkout Sessions. ## Créer une session de paiement agentique Vous pouvez créer une nouvelle session de paiement agentique avec les détails du client, les postes et les informations d’expédition. ### Requête Spécifiez les paramètres requis pour votre requête. | Paramètres | Type | Description | | ------------------------ | ------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | | **items** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#item) | Gamme d’articles que vous pouvez acheter. (Required) | | **buyer** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#buyer) | Informations sur le client. | | **fulfillment\_address** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#address) | Adresse où la commande sera expédiée. | **Exemple de requête :** ```json POST /checkouts { "items": [ { "id": "item_123", "quantity": 2 } ], "buyer": { "first_name": "John", "last_name": "Doe", "email": "john.doe@example.com", "phone_number": "+1234567890" }, "fulfillment_address": { "name": "John Doe", "line_one": "123 Main St", "line_two": "Apt 4B", "city": "San Francisco", "state": "CA", "country": "US", "postal_code": "94105" } } ``` ### Réponse La réponse renvoie l’état actuel du paiement par le marchand. | Paramètres | Type | Description | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **id** | `string` | Identifiant unique pour la session de paiement agentique. (Required) | | **buyer** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#buyer) | Informations sur le client. | | **payment\_provider** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#payment-provider) | Configuration du prestataire de services de paiement et moyens de paiement pris en charge. | | **status** | `string` | État actuel du traitement du paiement. (Required) Valeurs possibles : `not_ready_for_payment` |`ready_for_payment` |`completed` |`canceled` |`in_progress` | | **currency** | `string` | Code de devise ISO à trois lettres, en minuscules. (Required) | | **line\_items** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#line-item) | Tableau des postes dans le traitement du paiement. (Required) | | **fulfillment\_address** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#address) | Adresse où la commande sera expédiée. | | **fulfillment\_options** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#fulfillment-option) | Options d’expédition et de réalisation disponibles. (Required) | | **fulfillment\_option\_id** | `string` (optional) | ID de l’option de réalisation actuellement sélectionnée. | | **totaux** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#total) | Aperçu des paiements et des remises. (Required) | | **messages** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#message) | Tableau de messages ou de notifications liés au traitement du paiement. (Required) | | **liens** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#link) | Tableau de liens liés au traitement du paiement. (Required) | **Exemple de réponse :** ```json { "id": "checkout_abc123", "buyer": { "first_name": "John", "last_name": "Doe", "email": "john.doe@example.com", "phone_number": "+1234567890" }, "payment_provider": { "provider": "stripe", "supported_payment_methods": ["card"] }, "status": "ready_for_payment", "currency": "usd", "line_items": [ { "id": "item_123", "item": { "id": "item_123", "quantity": 2 }, "base_amount": 2000, "discount": 0, "total": 2000, "subtotal": 2000, "tax": 0 } ], "fulfillment_address": { "name": "John Doe", "line_one": "123 Main St", "line_two": "Apt 4B", "city": "San Francisco", "state": "CA", "country": "US", "postal_code": "94105" }, "fulfillment_options": [ { "type": "shipping", "id": "shipping_fast", "title": "Express Shipping", "subtitle": "2-3 business days", "carrier": "Shipping Co", "subtotal": 150, "tax": 0, "total": 150 } ], "fulfillment_option_id": "shipping_fast", "totals": [ { "type": "subtotal", "display_text": "Subtotal", "amount": 2000 }, { "type": "fulfillment", "display_text": "Shipping", "amount": 150 }, { "type": "tax", "display_text": "Tax", "amount": 100 }, { "type": "total", "display_text": "Total", "amount": 2250 } ], "messages": [], "links": [] } ``` ## Récupérer un objet Checkout Pour récupérer une session de paiement agentique existante à l’aide de son ID, effectuez une requête à l’endpoint API approprié avec l’ID inclus dans la requête. ### Requête Spécifiez les paramètres requis pour votre requête. | Paramètres | Type | Description | | ---------- | -------- | -------------------------------------------------------- | | **id** | `string` | Identifiant unique du traitement du paiement. (Required) | **Exemple de requête :** ```json GET /checkouts/:id ``` ### Réponse La réponse renvoie l’état actuel du paiement par le marchand. | Paramètres | Type | Description | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **id** | `string` | Identifiant unique pour la session de paiement agentique. (Required) | | **buyer** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#buyer) | Informations sur le client. | | **payment\_provider** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#payment-provider) | Configuration du prestataire de services de paiement et moyens de paiement pris en charge. | | **status** | `string` | État actuel du traitement du paiement. (Required) Valeurs possibles : `not_ready_for_payment` |`ready_for_payment` |`completed` |`canceled` |`in_progress` | | **currency** | `string` | Code de devise ISO à trois lettres, en minuscules. (Required) | | **line\_items** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#line-item) | Tableau des postes dans le traitement du paiement. (Required) | | **fulfillment\_address** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#address) | Adresse où la commande sera expédiée. | | **fulfillment\_options** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#fulfillment-option) | Options d’expédition et de réalisation disponibles. (Required) | | **fulfillment\_option\_id** | `string` (optional) | ID de l’option de réalisation actuellement sélectionnée. | | **totaux** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#total) | Aperçu des paiements et des remises. (Required) | | **messages** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#message) | Tableau de messages ou de notifications liés au traitement du paiement. (Required) | | **liens** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#link) | Tableau de liens liés au traitement du paiement. (Required) | **Exemple de réponse :** ```json { "id": "checkout_abc123", "buyer": { "first_name": "John", "last_name": "Doe", "email": "john.doe@example.com", "phone_number": "+1234567890" }, "payment_provider": { "provider": "stripe", "supported_payment_methods": ["card"] }, "status": "ready_for_payment", "currency": "usd", "line_items": [ { "id": "item_123", "item": { "id": "item_123", "quantity": 2 }, "base_amount": 2000, "discount": 0, "total": 2000, "subtotal": 2000, "tax": 0 } ], "fulfillment_address": { "name": "John Doe", "line_one": "123 Main St", "line_two": "Apt 4B", "city": "San Francisco", "state": "CA", "country": "US", "postal_code": "94105" }, "fulfillment_options": [ { "type": "shipping", "id": "shipping_fast", "title": "Express Shipping", "subtitle": "2-3 business days", "carrier": "Shipping Co", "subtotal": 150, "tax": 0, "total": 150 } ], "fulfillment_option_id": "shipping_fast", "totals": [ { "type": "subtotal", "display_text": "Subtotal", "amount": 2000 }, { "type": "fulfillment", "display_text": "Shipping", "amount": 150 }, { "type": "tax", "display_text": "Tax", "amount": 100 }, { "type": "total", "display_text": "Total", "amount": 2250 } ], "messages": [], "links": [] } ``` ## Mettre à jour une session de paiement agentique Vous pouvez mettre à jour une session de paiement agentique existante en modifiant les postes, l’adresse de livraison ou les options de réalisation. ### Requête Spécifiez les paramètres requis pour votre requête. | Paramètres | Type | Description | | --------------------------- | ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | | **id** | `string` | Identifiant unique du traitement du paiement. (Required) | | **buyer** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#buyer) | Informations sur le client. | | **items** | `array` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#item) | Mise à jour de l’éventail des éléments à acheter. | | **fulfillment\_address** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#address) | Mise à jour de l’adresse de réalisation. | | **fulfillment\_option\_id** | `string` (optional) | Identifiant de l’option de réalisation sélectionnée. | **Exemple de requête :** ```json PUT /checkouts/:id { "items": [ { "id": "item_123", "quantity": 3 }, { "id": "item_456", "quantity": 1 } ], "fulfillment_address": { "name": "John Doe", "line_one": "456 Oak Ave", "city": "Los Angeles", "state": "CA", "country": "US", "postal_code": "90210" }, "fulfillment_option_id": "shipping_fast" } ``` ### Réponse La réponse renvoie l’état actuel du paiement par le marchand. | Paramètres | Type | Description | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **id** | `string` | Identifiant unique pour la session de paiement agentique. (Required) | | **buyer** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#buyer) | Informations sur le client. | | **payment\_provider** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#payment-provider) | Configuration du prestataire de services de paiement et moyens de paiement pris en charge. | | **status** | `string` | État actuel du traitement du paiement. (Required) Valeurs possibles : `not_ready_for_payment` |`ready_for_payment` |`completed` |`canceled` |`in_progress` | | **currency** | `string` | Code de devise ISO à trois lettres, en minuscules. (Required) | | **line\_items** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#line-item) | Tableau des postes dans le traitement du paiement. (Required) | | **fulfillment\_address** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#address) | Adresse où la commande sera expédiée. | | **fulfillment\_options** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#fulfillment-option) | Options d’expédition et de réalisation disponibles. (Required) | | **fulfillment\_option\_id** | `string` (optional) | ID de l’option de réalisation actuellement sélectionnée. | | **totaux** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#total) | Aperçu des paiements et des remises. (Required) | | **messages** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#message) | Tableau de messages ou de notifications liés au traitement du paiement. (Required) | | **liens** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#link) | Tableau de liens liés au traitement du paiement. (Required) | **Exemple de réponse :** ```json { "id": "checkout_abc123", "buyer": { "first_name": "John", "last_name": "Doe", "email": "john.doe@example.com", "phone_number": "+1234567890" }, "payment_provider": { "provider": "stripe", "supported_payment_methods": ["card"] }, "status": "ready_for_payment", "currency": "usd", "line_items": [ { "id": "item_123", "item": { "id": "item_123", "quantity": 3 }, "base_amount": 3000, "discount": 0, "total": 3000, "subtotal": 3000, "tax": 0 }, { "id": "item_456", "item": { "id": "item_456", "quantity": 1 }, "base_amount": 500, "discount": 0, "total": 500, "subtotal": 500, "tax": 0 } ], "fulfillment_address": { "name": "John Doe", "line_one": "456 Oak Ave", "city": "Los Angeles", "state": "CA", "country": "US", "postal_code": "90210" }, "fulfillment_options": [ { "type": "shipping", "id": "shipping_fast", "title": "Express Shipping", "subtitle": "2-3 business days", "carrier": "Shipping Co", "subtotal": 150, "tax": 0, "total": 150 } ], "fulfillment_option_id": "shipping_fast", "totals": [ { "type": "subtotal", "display_text": "Subtotal", "amount": 3500 }, { "type": "fulfillment", "display_text": "Shipping", "amount": 150 }, { "type": "tax", "display_text": "Tax", "amount": 100 }, { "type": "total", "display_text": "Total", "amount": 3750 } ], "messages": [], "links": [] } ``` ## Finaliser un Checkout Vous pouvez terminer le traitement du paiement en traitant le paiement et en créant une commande. ### Requête Spécifiez les paramètres requis pour votre requête. | Paramètres | Type | Description | | ----------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | | **id** | `string` | Identifiant unique du traitement du paiement. (Required) | | **buyer** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#buyer) | Informations sur le client. | | **payment\_data** | `hash` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#payment-data) | Détails du moyen de paiement pour le traitement de la transaction. (Required) | **Exemple de requête :** ```json POST /checkouts/:id/complete { "payment_data": { "token": "spt_123", "provider": "stripe", "billing_address": { "name": "John Doe", "line_one": "123 Main St", "line_two": "Apt 4B", "city": "San Francisco", "state": "CA", "country": "US", "postal_code": "94105" } } } ``` ### Réponse La réponse renvoie l’état actuel du paiement par le marchand. | Paramètres | Type | Description | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **id** | `string` | Identifiant unique pour la session de paiement agentique. (Required) | | **buyer** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#buyer) | Informations sur le client. | | **payment\_provider** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#payment-provider) | Configuration du prestataire de services de paiement et moyens de paiement pris en charge. | | **status** | `string` | État actuel du traitement du paiement. (Required) Valeurs possibles : `not_ready_for_payment` |`ready_for_payment` |`completed` |`canceled` |`in_progress` | | **currency** | `string` | Code de devise ISO à trois lettres, en minuscules. (Required) | | **line\_items** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#line-item) | Tableau des postes dans le traitement du paiement. (Required) | | **fulfillment\_address** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#address) | Adresse où la commande sera expédiée. | | **fulfillment\_options** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#fulfillment-option) | Options d’expédition et de réalisation disponibles. (Required) | | **fulfillment\_option\_id** | `string` (optional) | ID de l’option de réalisation actuellement sélectionnée. | | **totaux** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#total) | Aperçu des paiements et des remises. (Required) | | **messages** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#message) | Tableau de messages ou de notifications liés au traitement du paiement. (Required) | | **liens** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#link) | Tableau de liens liés au traitement du paiement. (Required) | **Exemple de réponse :** ```json { "id": "checkout_abc123", "buyer": { "first_name": "John", "last_name": "Doe", "email": "john.doe@example.com", "phone_number": "+1234567890" }, "status": "completed", "currency": "usd", "line_items": [ { "id": "item_123", "item": { "id": "item_123", "quantity": 3 }, "base_amount": 3000, "discount": 0, "total": 3000, "subtotal": 3000, "tax": 0 }, { "id": "item_456", "item": { "id": "item_456", "quantity": 1 }, "base_amount": 500, "discount": 0, "total": 500, "subtotal": 500, "tax": 0 } ], "fulfillment_address": { "name": "John Doe", "line_one": "456 Oak Ave", "city": "Los Angeles", "state": "CA", "country": "US", "postal_code": "90210" }, "fulfillment_options": [ { "type": "shipping", "id": "shipping_fast", "title": "Express Shipping", "subtitle": "2-3 business days", "carrier": "Shipping Co", "subtotal": 150, "tax": 0, "total": 150 } ], "fulfillment_option_id": "shipping_fast", "totals": [ { "type": "subtotal", "display_text": "Subtotal", "amount": 3500 }, { "type": "fulfillment", "display_text": "Shipping", "amount": 150 }, { "type": "tax", "display_text": "Tax", "amount": 100 }, { "type": "total", "display_text": "Total", "amount": 3750 } ], "messages": [], "links": [] } ``` ## Annuler un Checkout Vous pouvez annuler une session de paiement agentique existante si nécessaire. ### Requête Spécifiez les paramètres requis pour votre requête. | Paramètres | Type | Description | | ---------- | -------- | -------------------------------------------------------- | | **id** | `string` | Identifiant unique du traitement du paiement. (Required) | **Exemple de requête :** ```json POST /checkouts/:id/cancel {} ``` ### Réponse La réponse renvoie l’état actuel du paiement par le marchand. | Paramètres | Type | Description | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **id** | `string` | Identifiant unique pour la session de paiement agentique. (Required) | | **buyer** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#buyer) | Informations sur le client. | | **payment\_provider** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#payment-provider) | Configuration du prestataire de services de paiement et moyens de paiement pris en charge. | | **status** | `string` | État actuel du traitement du paiement. (Required) Valeurs possibles : `not_ready_for_payment` |`ready_for_payment` |`completed` |`canceled` |`in_progress` | | **currency** | `string` | Code de devise ISO à trois lettres, en minuscules. (Required) | | **line\_items** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#line-item) | Tableau des postes dans le traitement du paiement. (Required) | | **fulfillment\_address** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#address) | Adresse où la commande sera expédiée. | | **fulfillment\_options** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#fulfillment-option) | Options d’expédition et de réalisation disponibles. (Required) | | **fulfillment\_option\_id** | `string` (optional) | ID de l’option de réalisation actuellement sélectionnée. | | **totaux** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#total) | Aperçu des paiements et des remises. (Required) | | **messages** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#message) | Tableau de messages ou de notifications liés au traitement du paiement. (Required) | | **liens** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#link) | Tableau de liens liés au traitement du paiement. (Required) | **Exemple de réponse :** ```json { "id": "checkout_abc123", "buyer": { "first_name": "John", "last_name": "Doe", "email": "john.doe@example.com", "phone_number": "+1234567890" }, "status": "canceled", "currency": "usd", "line_items": [ { "id": "item_123", "item": { "id": "item_123", "quantity": 3 }, "base_amount": 3000, "discount": 0, "total": 3000, "subtotal": 3000, "tax": 0 }, { "id": "item_456", "item": { "id": "item_456", "quantity": 1 }, "base_amount": 500, "discount": 0, "total": 500, "subtotal": 500, "tax": 0 } ], "fulfillment_address": { "name": "John Doe", "line_one": "456 Oak Ave", "city": "Los Angeles", "state": "CA", "country": "US", "postal_code": "90210" }, "fulfillment_options": [ { "type": "shipping", "id": "shipping_fast", "title": "Express Shipping", "subtitle": "2-3 business days", "carrier": "Shipping Co", "subtotal": 150, "tax": 0, "total": 150 } ], "fulfillment_option_id": "shipping_fast", "totals": [ { "type": "subtotal", "display_text": "Subtotal", "amount": 3500 }, { "type": "fulfillment", "display_text": "Shipping", "amount": 150 }, { "type": "tax", "display_text": "Tax", "amount": 100 }, { "type": "total", "display_text": "Total", "amount": 3750 } ], "messages": [ { "type": "info", "content_type": "plain", "content": "Checkout cancelled: Customer changed their mind" } ], "links": [] } ``` ## Structures de données Cette section décrit les structures données impliquées dans le traitement du paiement. ### Client Le client est un entrepreneur individuel qui est à l’origine de l’achat. | Paramètres | Type | Description | | ----------------- | ------------------- | --------------------------------------- | | **first\_name** | `string` | Le prénom du client. (Required) | | **last\_name** | `string` | Le nom de famille du client. (Required) | | **e-mail** | `string` | L’e-mail du client. **Obligatoire** | | **phone\_number** | `string` (optional) | Le numéro de téléphone du client. | ### Poste L’Article est un produit ou un service que le client demande à acheter, ainsi que sa quantité. | Paramètres | Type | Description | | ------------ | --------- | -------------------------------------------------------------- | | **id** | `string` | Identifiant unique de l’élément. (Required) | | **quantity** | `integer` | La quantité demandée de l’élément pour ce paiement. (Required) | ### LineItem Le LineItem inclut fournit des informations sur l’élément ajouté au paiement, y compris le montant. | Paramètres | Type | Description | | ---------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------ | | **id** | `string` | Identifiant unique du poste. (Required) | | **item** | `hash` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#item) | Détails de l’élément. (Required) | | **base\_amount** | `integer` | Montant de base du poste. (Required) | | **discount** | `integer` | Montant de la remise du poste. (Required) | | **total** | `integer` | Montant total du poste. (Required) | | **subtotal** | `integer` | Sous-montant total du poste. (Required) | | **tax** | `integer` | Le montant de la taxe du poste. (Required) | ### Adresse L’adresse fournit l’adresse de livraison ou de facturation du client. | Paramètres | Type | Description | | ---------------- | ------------------- | --------------------------------------------------------------------------- | | **name** | `string` | Nom de la personne à qui les éléments sont expédiés. (Required) | | **line\_one** | `string` (optional) | Ligne d’adresse 1 (par exemple, rue, boîte postale ou nom de l’entreprise). | | **line\_two** | `string` (optional) | Ligne d’adresse 2 (par exemple, appartement, suite, unité ou immeuble). | | **city** | `string` | Ville, district, banlieue, commune ou village. (Required) | | **state** | `string` | État, département, province ou région. (Required) | | **country** | `string` | Code de pays à deux lettres (ISO 3166-1 alpha-2). (Required) | | **postal\_code** | `string` | Code postal ou ZIP. (Required) | ### PaymentData Les données de paiement fournissent les détails de paiement du client, y compris la valeur tokenisée et le prestataire de services de paiement. | Paramètres | Type | Description | | -------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | **token** | `string` | Référence sécurisée à un justificatif d’identification de paiement. (Required) | | **provider** | `string` | Le prestataire de services de paiement auquel les données de paiement sont destinées. (Required) | | **billing\_address** | `hash` (optional) [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#address) | Adresse de facturation pour le moyen de paiement. | ### Total Le total fournit un résumé du total global. | Paramètres | Type | Description | | ----------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **type** | `enum` | Le type de total. (Required) Valeurs possibles : `items_base_amount` | `items_discount` | `subtotal` | `discount` | `fulfillment` | `tax` | `fee` | `total` | | **display\_text** | `string` | Texte d’affichage du total. (Required) | | **amount** | `integer` | Le montant du total. (Required) | ### FulfillmentOption Les options de traitement des commandes sont soit l’expédition, soit le format numérique. Pour des implémentations spécifiques,consulter [ShippingFulfillmentOption](https://docs.stripe.com/agentic-commerce/protocol/specification.md#shipping-fulfillment-option) et[DigitalFulfillmentOption](https://docs.stripe.com/agentic-commerce/protocol/specification.md#digital-fulfillment-option). ### ShippingFulfillmentOption La ShippingFulfillmentOption définit les paramètres des options de réalisation des expéditions, y compris les informations sur le transporteur et les délais de livraison. | Paramètres | Type | Description | | ----------------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------- | | **type** | `enum` | Le type d’option de réalisation. (Required) Valeurs possibles : `shipping` | | **id** | `string` | Identifiant unique de l’option de réalisation des frais d’expédition. { % badge label=“Required” / %} | | **title** | `string` | Le titre de l’option de réalisation des frais d’expédition. (Required) | | **subtitle** | `string` (optional) | Le sous-titre de l’option de réalisation de la livraison. | | **courrier d’accompagnement** | `string` (optional) | Le courrier d’accompagnement de l’option de réalisation des expéditions. | | **earliest\_delivery\_time** | `string` (optional) | Le délai de livraison le plus proche de l’option de réalisation des expéditions (format ISO 8601). | | **latest\_delivery\_time** | `string` (optional) | Le dernier délai de livraison de l’option de réalisation des expéditions (format ISO 8601). | | **subtotal** | `integer` | Le sous-total de l’option de réalisation des frais d’expédition. (Required) | | **tax** | `integer` | La taxe de l’option de réalisation des frais d’expédition. (Required) | | **total** | `integer` | Le total de l’option de réalisation des frais d’expédition. (Required) | ### DigitalFulfillmentOption DigitalFulfillmentOption définit les paramètres des options de réalisation numérique, y compris le titre et les informations de prix. | Paramètres | Type | Description | | ------------ | ------------------- | --------------------------------------------------------------------------------- | | **type** | `enum` | Le type d’option de réalisation. (Required) Valeurs possibles : `digital` | | **id** | `string` | Identifiant unique pour l’option de réalisation numérique. (Required) | | **title** | `string` | Le titre de l’option de réalisation numérique. (Required) | | **subtitle** | `string` (optional) | Le sous-titre de l’option de réalisation numérique. | | **subtotal** | `integer` | Le sous-total de l’option de réalisation numérique. (Required) | | **tax** | `integer` | La taxe de l’option de réalisation numérique. (Required) | | **total** | `integer` | Le total de l’option de réalisation numérique. (Required) | ### PaymentProvider Le PaymentProvider définit le prestataire de services de paiement pris en charge par le marchand et les moyens disponibles. | Paramètres | Type | Description | | ------------------------------- | -------- | ------------------------------------------------------------------------------------------------ | | **provider** | `string` | Le marchand prestataire de services de paiement. (Required) Valeurs possibles : `stripe` | | **supported\_payment\_methods** | `array` | Les moyens de paiement autorisés par le marchand. (Required) Valeurs possibles : `card` | ### Message Les messages sont soit des messages d’information, soit des messages d’erreur. #### InfoMessage L’InfoMessage représente des messages d’information, détaillant le type et le contenu. | Paramètres | Type | Description | | ----------------- | ------------------- | ---------------------------------------------------------------------------------------------------- | | **type** | `enum` | Chaîne représentant le type de message. Valeurs possibles : `info` | | **param** | `string` (optional) | RFC 9535 JSONPath au composant de la session de paiement agentique auquel le message fait référence. | | **content\_type** | `enum` (optional) | Le type de contenu du message. Valeurs possibles : `plain` |`markdown` | | **content** | `string` | Le contenu du message. | #### ErrorMessage L’ErrorMessage représente les messages d’erreur, détaillant le type et le code. | Paramètres | Type | Description | | ----------------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | **type** | `enum` | Chaîne représentant le type de message. Valeurs possibles : `error` | | **code** | `enum` | Le code de l’erreur. Valeurs possibles : `missing` | `invalid` | `out_of_stock` | `payment_declined` | `requires_sign_in` | `requires_3ds` | | **param** | `string` (optional) | RFC 9535 JSONPath au composant de la session de paiement agentique auquel le message fait référence. | | **content\_type** | `enum` (optional) | Le type de contenu du message. Valeurs possibles : `plain` |`markdown` | | **content** | `string` | Le contenu du message. | ### Erreur L’erreur définit les paramètres liés aux erreurs survenues pendant le traitement du paiement. | Paramètres | Type | Description | | ----------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | **type** | `enum` | Le type d’erreur. (Required) Valeurs possibles : `invalid_request` |`request_not_idempotent` |`processing_error` |`service_unavailable` | | **code** | `string` | Code d’erreur défini par l’implémentation. (Required) | | **message** | `string` | Le message de l’erreur. (Required) | | **param** | `string` (optional) | RFC 9535 JSONPath au composant de la session de paiement agentique auquel le message fait référence. | ### Link Link définit les paramètres des liens relatifs aux politiques et aux accords. | Paramètres | Type | Description | | ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | **type** | `enum` | Valeur de chaîne représentant le type de lien. (Required) Valeurs possibles : `terms_of_use` | `privacy_policy` | `seller_shop_policies` | | **url** | `string` | L’URL du lien. {% badge label="Required » /%} | ### Commande La commande fournit le résultat de traitement du paiement et fournit des détails au client pour la recherche de commande. | Paramètres | Type | Description | | ------------------------- | -------- | ----------------------------------------------------------------------------------- | | **id** | `string` | Identifiant unique de la commande. (Required) | | **checkout\_session\_id** | `string` | Référence à la session de paiement agentique à l’origine de la commande. (Required) | | **permalink\_url** | `string` | L’URL du permalien pour la commande. (Required) | ### Événements L’événement définit les paramètres des événements liés à la création et aux mises à jour des commandes. | Paramètres | Type | Description | | ----------- | ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | | **type** | `enum` | Le type d’événement. (Required) Valeurs possibles : `order_created` |`order_updated` | | **données** | `hash` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#order-event-data) | Données d’événement contenant des informations sur la commande. (Required) | ### OrderEventData Les OrderEventData comprennent des données relatives aux événements de commande. | Paramètres | Type | Description | | ------------------------- | -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **type** | `string` | La valeur de chaîne représente le type de données d’événement. Pour les données de commande, utilisez la valeur`order`. (Required) | | **checkout\_session\_id** | `string` | ID qui identifie la session de paiement agentique qui a créé cette commande. (Required) | | **permalink\_url** | `string` | L’URL pointe vers la commande. Les clients peuvent visiter cette URL et fournir leur adresse e-mail pour afficher les détails de la commande. (Required) | | **status** | `enum` | Chaîne représentant le dernier état de la commande. (Required) Valeurs possibles : `created` | `manual_review` | `confirmed` | `canceled` | `shipped` | `fulfilled` | | **Remboursements** | `array` [:paymentLink:](https://docs.stripe.com/agentic-commerce/protocol/specification.md#refund) | Liste des remboursements qui ont été émis pour la commande. (Required) | ### Remboursement Le Remboursement définit les paramètres de gestion des remboursements associés aux commandes terminées. | Paramètres | Type | Description | | ---------- | --------- | --------------------------------------------------------------------------------------------------- | | **type** | `enum` | Le type de remboursement. (Required) Valeurs possibles : `store_credit` |`original_payment` | | **amount** | `integer` | Le montant du remboursement. (Required) |