# Passer des commandes de matériel Comment passer des commandes de lecteurs et d'accessoires. Envie d’acheter ? Parcourez [les lecteurs et les accessoires disponibles](https://dashboard.stripe.com/terminal/shop). Commandez des lecteurs précertifiés compatibles avec Stripe Terminal depuis votre Dashboard ou à l’aide de l’[API Stripe](https://docs.stripe.com/terminal/fleet/order-and-return-readers.md#use-the-hardware-orders-api). Achetez des lecteurs directement auprès de Stripe afin qu’ils soient dotés des applications de paiement et des clés de chiffrement sécurisé de Stripe. Pour démarrer, accédez à la section [Lecteurs](https://dashboard.stripe.com/terminal) de votre Dashboard. Cliquez sur **Acheter** pour afficher les produits disponibles. ## Produits proposés Premièrement, commandez un [lecteur](https://dashboard.stripe.com/terminal/shop) et une [carte bancaire de test](https://dashboard.stripe.com/terminal/shop) afin de tester l’ensemble de votre intégration avec du matériel physique. Une fois votre intégration prête à l’emploi, commandez autant de lecteurs que vous souhaitez. Vous ne savez pas quel lecteur choisir ? Consultez l’article [Concevoir une intégration](https://docs.stripe.com/terminal/designing-integration.md) pour sélectionner le lecteur adapté à votre intégration. Vous pouvez commander une quantité maximale de 10000 par article dans une seule et même commande. Si vous souhaitez bénéficier de ristournes sur volume, [prenez contact avec nos équipes](https://stripe.com/contact/sales). ### Tarifs Le tarif de chaque lecteur varie selon les pays. Vous pouvez consulter les tarifs actuels dans le [Dashboard](https://dashboard.stripe.com/terminal/shop) ou sur la [page tarifaire](https://stripe.com/terminal/devices). ## Suivre et annuler des commandes Après avoir passé votre commande, consultez son état dans le Dashboard : | État | Définition | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **En attente** | Nous avons bien reçu votre commande et la traiterons sous peu. Si nécessaire, vous pouvez annuler cette commande dans le Dashboard. Les commandes restent en attente pendant au moins 30 minutes. | | **Prête à être expédiée** | Votre commande est en cours de préparation pour l’expédition et ne peut plus être annulée. Une fois la commande expédiée, vous devez lancer une procédure de retour pour l’annuler. La commande passe à l’état **Envoyé** dès qu’un numéro de suivi est disponible. | | **Expédiée** | Commande passée auprès de notre distributeur. Les informations de suivi sont disponibles sur la page des détails de la commande. | | **Livrée** | Les articles ont été livrés. | | **Annulée** | La commande est annulée. | | **Non livrable** | Un ou plusieurs articles de la commande n’ont pas pu être livrés. | Diagramme de l'état des commandes de la version v4 (See full diagram at https://docs.stripe.com/terminal/fleet/order-and-return-readers) ## Retours en libre-service Les retours en libre-service concernent les commandes passées et expédiées dans des pays spécifiques (voir la liste ci-dessous). Pour toutes les autres commandes, consultez les informations sur les [retours dans les pays où le libre-service n’est pas pris en charge](https://docs.stripe.com/terminal/fleet/order-and-return-readers.md#returns-outside-of-supported-self-service-countries). Si vous avez passé commande depuis le Dashboard Stripe à partir d’un pays où le libre-service est pris en charge et souhaitez retourner tout ou partie des articles de votre commande, [les utilisateurs avec les permissions nécessaires](https://docs.stripe.com/terminal/fleet/order-and-return-readers.md#self-service-return-permissions) peuvent effectuer le processus de retour dans le Dashboard Stripe. Nous remboursons les articles qui nous sont retournés dans leur emballage d’origine (avec tous les accessoires) dans un délai de 30 jours suivant la date d’achat. Pour les retours au-delà de ce délai, contactez [le service de support de Stripe](https://support.stripe.com/contact/login). Une fois le processus de retour effectué dans le Dashboard, une étiquette de retour est générée. Après avoir créé l’étiquette de retour, vous pouvez déposer votre colis chez un transporteur local. Nous procédons au remboursement à la réception du colis dans notre centre de distribution. En cas de paiement par carte bancaire, le remboursement peut prendre jusqu’à 10 jours avant d’apparaître sur le compte bancaire du client. ### Pays où le libre-service est pris en charge - AT - AU - BE - BG - CA - CY - CZ - DE - DK - EE - ES - FI - FR - GB - GI - GR - HR - HU - IE - IT - LI - LT - LU - LV - MT - NL - PL - PT - RO - SE - SI - SK - US ## Cliquez sur le bouton Retourner les articles Pour effectuer un retour depuis le Dashboard, accédez à vos commandes de matériel et sélectionnez la commande que vous souhaitez retourner. Après avoir sélectionné la commande, cliquez sur **Retourner les élément** pour lancer le processus. Le bouton **Retourner les élément** est disponible sur la page des détails de la commande Terminal si la commande de matériel présente l’état `Shipped` ou `Delivered`. ![Retours en libre-service - Étape 1](https://b.stripecdn.com/docs-statics-srv/assets/returns-step1.9346efe2a1f1a81856654b99566f5a0b.png) ## Confirmation du nombre d'unités à retourner Lorsque la fenêtre contextuelle s’ouvre, sélectionnez le nombre d’articles que vous souhaitez retourner pour chaque produit de la commande (si vous avez plus d’un article). Nous afficherons uniquement le nombre d’articles pouvant être retournés. Ainsi, si vous avez déjà acheté trois articles et en avez retourné un, vous ne pourrez sélectionner que deux unités à retourner. ![Retours en libre-service - Étape 2](https://b.stripecdn.com/docs-statics-srv/assets/returns-step2.18d56b1b58d3126dc3174bc2583d3d7b.png) ## Calcul du montant du remboursement La fenêtre contextuelle affiche le montant à rembourser une fois que vous avez sélectionné le nombre d’articles souhaité. Les frais de livraison sont remboursés lors du premier retour effectué dans le cadre d’une commande de matériel Terminal. Par exemple, si vous avez acheté trois lecteurs, puis renvoyé un appareil dans le cadre d’un remboursement partiel, et que vous décidez d’en renvoyer un autre, les frais de livraison à rembourser lors du deuxième retour dans le Dashboard seront de 0 USD, car ces frais auront déjà été remboursés. ## Sélection d'un motif de retour Ensuite, sélectionnez un motif de retour dans le menu déroulant. ![Retours en libre-service - Étape 4](https://b.stripecdn.com/docs-statics-srv/assets/returns-step4.d3e033266dc193ff0b4c666ad6fe48cf.png) - **Articles arrivés défectueux ou cassés** : sélectionnez cette option si l’un des articles reçus était endommagé ou défectueux. - **J’ai commandé trop d’appareils** : sélectionnez cette option si vous avez commandé un trop grand nombre d’appareils. - **La configuration de l’appareil est trop compliquée** : sélectionnez cette option si la mise en route de Stripe Terminal était trop complexe ou si le produit ne répondait pas à vos attentes. - **Autre** : sélectionnez cette option si aucune des options ci-dessus ne correspond à votre cas d’usage. Vous devez préciser un motif. ## Confirmation et export de l'étiquette d'expédition Vérifiez l’exactitude des informations, puis sélectionnez **Effectuer un retour**. Une fois l’article sélectionné, l’option permettant de télécharger l’étiquette d’expédition s’affiche. Vous pouvez sélectionner **Afficher les adresses UPS** pour trouver le point de dépôt le plus proche. ![Retours en libre-service - Étape 5](https://b.stripecdn.com/docs-statics-srv/assets/returns-step5.bd0eff6b670cad01b97216f4a32ad627.png) ## Remboursements Une fois le retour traité, nous vous redirigeons vers la page des détails de la commande. Si nécessaire, vous pouvez télécharger à nouveau l’étiquette d’expédition à partir de la page des détails. Stripe émet un remboursement en utilisant le moyen de paiement indiqué à la réception du retour. ## Retours dans les pays où le libre-service n’est pas pris en charge Pour retourner un appareil qui ne propose pas le retour en libre-service, contactez le service de support. Ouvrez le Dashboard, accédez à votre commande et cliquez sur **Contacter le service de support** afin de nous envoyer automatiquement les détails de votre commande. Nous pouvons rembourser les articles qui nous sont retournés dans leur emballage d’origine (accompagnés de tous leurs accessoires) dans un délai de 30 jours suivant la date d’achat. ## Expédition Stripe collabore avec un partenaire de distribution pour traiter les commandes Terminal. Selon le pays de destination, vous pouvez choisir entre un envoi standard, un envoi express ou un envoi prioritaire. Le matériel doit être expédié vers des adresses physiques (et non vers des boîtes postales). > #### Commandes en grande quantité > > Stripe sélectionne automatiquement les frais de livraison pour les commandes en grande quantité. Si vous êtes une [plateforme Connect qui utilise Terminal](https://docs.stripe.com/terminal/features/connect.md), vous pouvez expédier des lecteurs directement à vos comptes connectés en précisant l’adresse de destination au moment du paiement. | Pays de destination | Heure limite des commandes | Montant de la commande au-dessus duquel une signature est requise | Régions et territoires exclus pour la livraison (toutes les boîtes postales sont exclues) | | ------------------- | -------------------------------------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | US | 11 h 00, heure de l’Est | 500 USD | Les Îles Vierges et les adresses militaires | | CA | 13 h 00, heure du Pacifique | 400 CAD | – | | AT | 11 h 00, heure d’Europe centrale | 400 EUR | – | | BE | 11 h 00, heure d’Europe centrale | 400 EUR | – | | BG | 11 h 00, heure d’Europe centrale | 400 EUR | – | | HR | 11 h 00, heure d’Europe centrale | 400 EUR | – | | CY | 11 h 00, heure d’Europe centrale | 400 EUR | – | | CZ | 11 h 00, heure d’Europe centrale | 9 900 CZK | – | | DK | 11 h 00, heure d’Europe centrale | 2975 DKK | – | | EE | 11 h 00, heure d’Europe centrale | 400 EUR | – | | FI | 11 h 00, heure d’Europe centrale | 400 EUR | – | | FR | 11 h 00, heure d’Europe centrale | 400 EUR | Saint-Pierre-et-Miquelon, Saint-Barthélemy, les Terres australes et antarctiques françaises, Wallis-et-Futuna, la Polynésie française et la Nouvelle-Calédonie | | DE | 11 h 00, heure d’Europe centrale | 400 EUR | – | | GI | 11 h 00, heure d’Europe centrale | 400 EUR | – | | GR | 11 h 00, heure d’Europe centrale | 400 EUR | – | | HU | 11 h 00, heure d’Europe centrale | 155908 HUF | – | | IE | 11 h 00, heure d’Europe centrale | 400 EUR | – | | IT | 11 h 00, heure d’Europe centrale | 400 EUR | – | | LV | 11 h 00, heure d’Europe centrale | 400 EUR | – | | LI | 11 h 00, heure d’Europe centrale | 415 CHF | – | | LT | 11 h 00, heure d’Europe centrale | 400 EUR | – | | LU | 11 h 00, heure d’Europe centrale | 400 EUR | – | | MT | 11 h 00, heure d’Europe centrale | 400 EUR | – | | NL | 11 h 00, heure d’Europe centrale | 400 EUR | Aruba, Curaçao, Saint-Martin, Bonaire, Saint Eustache et Saba | | NO | 11 h 00, heure d’Europe centrale | 400 EUR | Svalbard et Jan Mayen | | PT | 11 h 00, heure d’Europe centrale | 400 EUR | – | | RO | 11 h 00, heure d’Europe centrale | 1930 RON | – | | SK | 11 h 00, heure d’Europe centrale | 400 EUR | – | | SI | 11 h 00, heure d’Europe centrale | 400 EUR | – | | ES | 11 h 00, heure d’Europe centrale | 400 EUR | – | | SE | 11 h 00, heure d’Europe centrale | 4315 SEK | – | | CH | 11 h 00, heure d’Europe centrale | 400 EUR | – | | GB | 11 h 00, heure d’Europe centrale | 400 GBP | Jersey, Guernesey, l’île de Man et les Îles Vierges britanniques | | AU | 11 h 00, heure de l’Est australien | 400 AUD | – | | HK | 11 h 00, heure de l’Est australien | 2 200 HKD | – | | MY | 11 h 00, heure de l’Est australien | 1 200 MYR | – | | NZ | 11 h 00, heure de l’Est australien | 400 NZD | – | | SG | 11 h 00, heure de l’Est australien | 400 SGD | – | | PL | 11 h 30, heure d’Europe centrale | 2100 PLN | – | | JP | 15 h 30, heure normale du Japon | 79000 JPY | – | ## Ajouter des numéros fiscaux Vous pouvez ajouter des numéros fiscaux dans vos [paramètres Terminal](https://dashboard.stripe.com/settings/terminal). Stripe les utilise afin d’appliquer des taxes aux commandes de matériel informatique, et de les intégrer aux factures fiscales et aux avoirs. Chaque commande passée en dehors des États-Unis génère une facture fiscale, que vous pouvez consulter en cliquant sur l’une des commandes figurant sur la liste des [commandes de matériel](https://dashboard.stripe.com/terminal/hardware_orders). ## Rôles et autorisations des utilisateurs Le tableau suivant indique quels [rôles d’utilisateurs](https://docs.stripe.com/get-started/account/teams/roles.md) peuvent passer des commandes pour leur compte dans le Dashboard : | | Administrateur | Développeur | Analyste | Spécialiste de Terminal | Spécialiste du service de support | Lecture seule | | ------------------------------- | -------------- | ------------- | ------------- | ----------------------- | --------------------------------- | ------------- | | Passer de nouvelles commandes | :check: Check | :check: Check | :check: Check | :check: Check | ❌ Cancel | ❌ Cancel | | Afficher la liste des commandes | :check: Check | :check: Check | :check: Check | :check: Check | :check: Check | :check: Check | | Annuler une commande | :check: Check | :check: Check | :check: Check | :check: Check | ❌ Cancel | ❌ Cancel | | Retour en libre-service | :check: Check | :check: Check | :check: Check | :check: Check | :check: Check | ❌ Cancel | ## Utiliser l’API Hardware Orders (Preview) L’API Terminal Hardware Orders est actuellement en version bêta. Si vous souhaitez l’utiliser, [contactez votre représentant commercial](https://stripe.com/contact/sales), qui évaluera votre admissibilité. Pour accéder à la version bêta, vous devez : - Avoir un gestionnaire de compte Stripe - Accepter la facturation mensuelle - Étant donné qu’il s’agit d’une version bêta, il est possible que vous deviez effectuer des mises à jour de temps à autre. L’API Hardware Orders de Terminal vous permet de programmer l’achat de lecteurs et d’accessoires Terminal qui peuvent être directement envoyés à vos utilisateurs. Les commandes étant traitées par des distributeurs partenaires de Stripe, vous n’avez aucun aspect logistique complexe à gérer et vous pouvez vous consacrer au développement de votre activité de paiement par TPE. - Créer un outil interne permettant à vos employés (des responsables de magasin par exemple) de commander du matériel - Créez un système de commande en ligne permettant à vos clients de commander des lecteurs Terminal et des accessoires Pour créer une commande de matériel à l’aide de l’API, suivez les étapes ci-dessous : 1. Récupérer les unités de gestion des stocks disponibles 1. Récupérer les moyens de livraison disponibles 1. (Facultatif) Prévisualiser la commande 1. Créer la commande > Vous devez inclure un en-tête bêta dans vos requêtes d’API avec la version de votre API et la version actuelle de l’aperçu de la commande de matériel Terminal : `Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5` ### Récupérer des unités de gestion des stocks Pour créer une page produit efficace pour vos utilisateurs, votre intégration doit demander les articles disponibles à Stripe. Chaque article est représenté par une unité de gestion des stocks et comprend des informations sur le produit en question, dont le token et le tarif. Chaque UGS est associée à un pays : un lecteur disponible aux États-Unis a une UGS différente de celle du même lecteur disponible au Canada. Pour récupérer les UGS, vous devez spécifier le paramètre `country` lorsque vous effectuez une demande au point de terminaison [Hardware Order SKUs](https://docs.stripe.com/api/terminal/hardware_skus/list.md) : ```bash curl https://api.stripe.com/v1/terminal/hardware_skus?country=US \ -u <>: \ -H "Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5" ``` Chaque UGS est également associée à un objet [Hardware Product](https://docs.stripe.com/api/terminal/hardware_products/object.md). Les produits représentent différentes catégories d’appareils. Si vous créez un système de commande en ligne pour vos clients, veillez à n’afficher que les UGS des produits qui s’appliquent à votre intégration Terminal. Par exemple, si votre intégration Terminal utilise uniquement le lecteur [BBPOS WisePOS E](https://docs.stripe.com/terminal/readers/bbpos-wisepos-e.md), ne rendez pas le lecteur [BBPOS Chipper 2X BT](https://docs.stripe.com/terminal/readers/bbpos-chipper2xbt.md) disponible à l’achat. Pour récupérer toutes les UGS [BBPOS WisePOS E](https://docs.stripe.com/terminal/readers/bbpos-wisepos-e.md), vous pouvez spécifier le paramètre facultatif `product` lorsque vous effectuez une demande au endpoint [Hardware Order SKUs](https://docs.stripe.com/api/terminal/hardware_skus/list.md) : ```bash curl 'https://api.stripe.com/v1/terminal/hardware_skus?country=US&product={{TERMINAL_HARDWARE_PRODUCT_ID}}' \ -u <>: \ -H "Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5" ``` Enfin, chaque unité de gestion des stocks est également associée à un [fournisseur](https://docs.stripe.com/api/terminal/hardware_skus/object.md#terminal_hardware_sku_object-provider). Par défaut, cette valeur est définie sur `stripe` mais vous filtrez les références d’unité de gestion des stocks d’un autre fournisseur en précisant le paramètre facultatif `provider` lors de l’envoi d’une requête à l’endpoint [Hardware Order SKUs](https://docs.stripe.com/api/terminal/hardware_skus/list.md). Toutes les unités de gestion des stocks et tous les modes de livraison d’une commande doivent partager le même `provider`. #### Disponibilité des unités de gestion des stocks Les unités de gestion des stocks et les produits peuvent devenir obsolètes lorsque nous les remplaçons par de nouveaux composants matériels. Pour vous aider à gérer l’obsolescence programmée, consultez [l’état de l’unité de gestion des stocks et des produits](https://docs.stripe.com/api/terminal/hardware_skus/object.md#terminal_hardware_sku_object-status), qui indique lesquels sont `available` ou `unavailable`. Vous ne pouvez pas créer de commande si l’[état de l’unité de gestion des stocks](https://docs.stripe.com/api/terminal/hardware_products/object.md#terminal_hardware_sku_object-status) est `unavailable`. En outre, chaque SKU et produit propose un [champ unavailable_after](https://docs.stripe.com/api/terminal/hardware_skus/object.md#terminal_hardware_sku_object-unavailable_after) facultatif qui indique quand il risque de devenir `unavailable`. Étant donné que la disponibilité de ces objets change au fil du temps, nous recommandons d’utiliser une approche permettant de les interroger de manière dynamique. Pour ce faire, vous pouvez soit effectuer une requête avant d’afficher les objets `available` à vos utilisateurs, soit périodiquement (tous les jours, par exemple) mettre en cache les résultats que vous présentez à vos utilisateurs. Nous déconseillons de coder en dur les tokens pour ces objets, car cette intégration nécessite des modifications du code lorsqu’une méthode d’expédition devient `unavailable`. Si vous n’effectuez pas ces modifications à temps, vous risquez d’essayer de passer des commandes avec des objets `unavailable`, ce qui entraînera des erreurs. ### Récupérer les moyens de livraison L’objet [Hardware Shipping Method](https://docs.stripe.com/api/terminal/hardware_shipping_methods/object.md) est obligatoire lors de la création d’une commande. Il détermine le délai de livraison estimé pour votre commande, ainsi que les frais de livraison. Vous devez utiliser un mode de livraison disponible dans le pays de livraison lors de la création de la commande. À l’instar des unités de gestion des stocks, chaque mode de livraison est associé à un pays : les modes de livraison disponibles aux États-Unis peuvent être différents de ceux disponibles au Canada. Chaque mode de livraison a également un `name`, qui indique sa catégorie de base, ainsi qu’un `provider`. Pour récupérer les modes de livraison, vous devez préciser le paramètre `country` et vous pouvez éventuellement indiquer le paramètre `name` ou `provider` lorsque vous effectuez une demande au endpoint [Hardware Shipping Methods](https://docs.stripe.com/api/terminal/hardware_shipping_methods/list.md) : ```bash curl https://api.stripe.com/v1/terminal/hardware_shipping_methods?country=US \ -u <>: \ -H "Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5" ``` Tout comme les unités de gestion des stocks et les produits, les modes de livraison peuvent évoluer avec le temps. Pour vous aider à gérer ces changements, l’[état](https://docs.stripe.com/api/terminal/hardware_skus/object.md#terminal_hardware_sku_object-status) de chaque mode de livraison indique s’il est actuellement disponible (`available`) ou non (`unavailable`). Ce mécanisme fonctionne de la même manière que pour les unités de gestion des stocks et les produits, comme décrit ci-dessus. Comme pour les unités de gestion des stocks et les produits, nous vous recommandons de récupérer régulièrement les Shipping Methods afin que votre intégration ne devienne pas obsolète. ### Prévisualiser une commande de matériel Pour prévisualiser une commande de matériel, envoyez à Stripe une requête contenant les unités de gestion des stocks, les quantités, l’adresse de livraison et le mode de livraison de la commande. ```bash curl https://api.stripe.com/v1/terminal/hardware_orders/preview \ -u <>: \ -H "Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5" \ --data-urlencode "shipping[name]"="Jenny Rosen" \ --data-urlencode "shipping[address][line1]"="1234 Main Street" \ --data-urlencode "shipping[address][city]"="San Francisco" \ --data-urlencode "shipping[address][state]"=CA \ --data-urlencode "shipping[address][country]"=US \ --data-urlencode "shipping[address][postal_code]"=94111 \ --data-urlencode "shipping[company]"="Rocket Rides" \ --data-urlencode "shipping[phone]"=15555555555 \ --data-urlencode "shipping[email]"="test@example.com" \ --data-urlencode shipping_method=thsm_MfuTjLaPEgXMa4 \ --data-urlencode payment_type=monthly_invoice \ --data-urlencode "hardware_order_items[][terminal_hardware_sku]"=thsku_JokaJ6KpLMlDID \ --data-urlencode "hardware_order_items[][quantity]"=2 \ -G ``` Afficher l’aperçu d’une commande vous permet de la valider et de déterminer le montant global des taxes applicables à la commande sans pour autant la passer. Vous pouvez utiliser cette fonction pour concevoir une page de paiement en ligne pour vos clients. Appeler l’endpoint Preview ne crée pas réellement de commande. Essayez de réduire le plus possible le délai entre l’envoi d’une requête aux endpoints [Preview Hardware Order](https://docs.stripe.com/api/terminal/hardware_orders/preview.md) et [Create Hardware Order](https://docs.stripe.com/api/terminal/hardware_orders/create.md), afin de limiter le (faible) risque que les tarifs évoluent dans l’intervalle. Si ce problème vous préoccupe, vous pouvez enregistrer l’aperçu et créer une commande en utilisant les mêmes paramètres. Cela vous permet ainsi de comparer l’aperçu enregistré avec la commande et d’annuler la commande en cas de modification. ### Créer une commande de matériel Pour créer un objet [Terminal Hardware Order](https://docs.stripe.com/api/terminal/hardware_orders/object.md), vous pouvez envoyer à Stripe une requête [Create Hardware Order](https://docs.stripe.com/api/terminal/hardware_orders/create.md) qui ressemble beaucoup à la requête [Preview Hardware Order](https://docs.stripe.com/api/terminal/hardware_orders/preview.md). Indiquez les unités de gestion des stocks, les quantités, l’adresse de livraison et le mode de livraison de la commande dans votre requête. ```bash curl https://api.stripe.com/v1/terminal/hardware_orders \ -u <>: \ -H "Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5" \ -d "shipping[name]"="Jenny Rosen" \ -d "shipping[address][line1]"="1234 Main Street" \ -d "shipping[address][city]"="San Francisco" \ -d "shipping[address][state]"="CA" \ -d "shipping[address][country]"="US" \ -d "shipping[address][postal_code]"="94111" \ -d "shipping[company]"="Rocket Rides" \ -d "shipping[phone]"="15555555555" \ -d "shipping[email]"="test@example.com" \ -d "hardware_order_items[][terminal_hardware_sku]"="thsku_JokaJ6KpLMlDID" \ -d "hardware_order_items[][quantity]"="2" \ -d shipping_method="thsm_MfuTjLaPEgXMa4" \ -d payment_type="monthly_invoice" ``` L’exemple ci-dessous indique un numéro de téléphone aux États-Unis. Si le numéro de téléphone spécifié via le paramètre `shipping.phone` est un numéro international, faites-le précéder du caractère d’échappement correspondant au signe + (par exemple, `shipping[phone]="%2B358131234567"` au lieu de `shipping[phone]="+358131234567"`). L’adresse e-mail renseignée dans le paramètre `shipping.email` reçoit des e-mails de mise à jour aux couleurs de Stripe en cas de changement d’état de la commande. Utilisez une adresse e-mail sur laquelle vous acceptez de recevoir des e-mails de Stripe. ### Récupérer et interroger les commandes de matériel Après avoir créé une commande, vous pouvez [récupérer un objet Terminal Hardware Order](https://docs.stripe.com/api/terminal/hardware_orders/retrieve.md) à l’aide de la requête suivante. ```bash curl https://api.stripe.com/v1/terminal/hardware_orders/{{TERMINAL_HARDWARE_ORDER_ID}} \ -u <>: \ -H "Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5" ``` Vous pouvez également [établir la liste de tous les Terminal Hardware Order](https://docs.stripe.com/api/terminal/hardware_orders/list.md). ```bash curl https://api.stripe.com/v1/terminal/hardware_orders \ -u <>: \ -H "Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5" ``` ### Webhooks Vous pouvez configurer [des événements de webhook](https://docs.stripe.com/webhooks.md) pour être informé des changements d’état des commandes. Vous devez ajouter une version d’en-tête (par exemple, `Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5`) à vos endpoints de webhook pour recevoir les événements correctement. Nous prenons en charge les événements de webhook suivants : - `terminal.hardware_order.created` - `terminal.hardware_order.canceled` - `terminal.hardware_order.ready_to_ship` - `terminal.hardware_order.shipped` - `terminal.hardware_order.delivered` - `terminal.hardware_order.undeliverable` ### Mettre à jour l’état d’une commande d’environnement de test Vous pouvez modifier l’état d’une commande de lecteurs Terminal dans un environnement de test à l’aide des endpoints suivants dans l’API : - `/v1/test_helpers/terminal/hardware_orders/:hardware_order/mark_ready_to_ship` - `/v1/test_helpers/terminal/hardware_orders/:hardware_order/ship` - `/v1/test_helpers/terminal/hardware_orders/:hardware_order/deliver` - `/v1/test_helpers/terminal/hardware_orders/:hardware_order/mark_undeliverable` Vous pouvez modifier l’état des commandes de lecteurs Terminal uniquement dans un *environnement de test* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). ### Taxes Lors de la création d’une commande, Stripe renvoie le montant des taxes associées à la commande. Cette somme est calculée sur la base des taxes dues à Stripe au titre de l’achat. Si vous facturez les taxes à vos utilisateurs finaux pour des commandes passées à l’aide de l’API, vous pouvez calculer les montants qui vous sont dus et les imputer à vos utilisateurs. Il est possible que les montants qui vous sont dus soient différents de ceux que vous devez à Stripe. Pour afficher les factures fiscales italiennes, visitez le [portail fiscal italien](https://www.agenziaentrate.gov.it/portale/area-riservata). ### Factures Pendant la phase bêta, Stripe envoie des factures mensuelles pour toutes les commandes créées avec l’API. Vous pouvez modifier l’adresse e-mail qui reçoit les factures dans votre [Dashboard](https://dashboard.stripe.com/settings/terminal). ### Suivi de livraison Comme indiqué dans la section [Livraison](https://docs.stripe.com/terminal/fleet/order-and-return-readers.md#shipping), Stripe travaille avec un partenaire de distribution qui traite les commandes Terminal. Lorsque notre partenaire reçoit les informations de suivi de la commande, celle-ci passe à l’état `shipped`. Vous pouvez configurer un endpoint de webhook pour la notification `terminal.hardware_order.shipped` si vous souhaitez recevoir une notification lorsqu’une commande dispose d’un numéro de suivi. ### Log des modifications #### Nouveaux transporteurs - Ajoutez de nouvelles valeurs (`canada_post`, `dhl`, `dpd` et `usps`) au champ d’énumération [Carrier](https://docs.stripe.com/api/terminal/hardware_orders/object.md#terminal_hardware_order_object-shipment_tracking-carrier). #### v5 (2024-11-25) - Ajoutez une pagination aux endpoints [List all Terminal Hardware SKUs](https://docs.stripe.com/api/terminal/hardware_skus/list.md), [List all Terminal Hardware Products](https://docs.stripe.com/api/terminal/hardware_products/list.md) et [List all Terminal Hardware Shipping Methods](https://docs.stripe.com/api/terminal/hardware_shipping_methods/list.md). - Exigez le filtre `country` pour les endpoints [List all Terminal Hardware SKUs](https://docs.stripe.com/api/terminal/hardware_skus/list.md) et [List all Terminal Hardware Shipping Methods](https://docs.stripe.com/api/terminal/hardware_shipping_methods/list.md). #### v4 (2023-01-23) - Ajoutez un nouvel endpoint [Preview Hardware Order](https://docs.stripe.com/api/terminal/hardware_orders/preview.md). Supprimez les états de commande `draft` et `expired`. Supprimez l’endpoint `/v1/terminal/hardware_orders/confirm` et le paramètre `confirm` de l’endpoint [Create Hardware Order](https://docs.stripe.com/api/terminal/hardware_orders/create.md). - Ajoutez un nouvel état [TerminalHardwareOrder](https://docs.stripe.com/api/terminal/hardware_orders/object.md) dénommé `ready_to_ship`, qui représente une commande qui ne peut plus être annulée, mais n’a pas encore été expédiée. - Ajoutez de nouveaux endpoints d’API pour faire passer l’état des commandes de lecteurs Terminal de test à l’état [ready_to_ship](https://docs.stripe.com/api/terminal/hardware_orders/test_mode_mark_ready_to_ship.md), [envoyée](https://docs.stripe.com/api/terminal/hardware_orders/test_mode_ship.md), [livrée](https://docs.stripe.com/api/terminal/hardware_orders/test_mode_deliver.md) et [livraison impossible](https://docs.stripe.com/api/terminal/hardware_orders/test_mode_mark_undeliverable.md). - Ajoutez un nouvel objet [Hardware Shipping Method](https://docs.stripe.com/api/terminal/hardware_shipping_methods/object.md) pour remplacer l’ancien objet dans le champ `shipping_method`, ainsi que des endpoints d’API pour interroger ces nouveaux objets et les récupérer. - Ajoutez un nouvel objet [Hardware Product](https://docs.stripe.com/api/terminal/hardware_products/object.md) pour remplacer l’ancien champ `product_type`, ainsi que des endpoints d’API pour interroger et récupérer ces nouveaux objets. - Ajoutez un nouveau champ dynamique `orderable` à l’objet [TerminalHardwareSku](https://docs.stripe.com/api/terminal/hardware_skus/object.md), en remplacement de l’ancien champ `max_per_order`. - Ajoutez des champs `status` et `unavailable_after` à [TerminalHardwareSku](https://docs.stripe.com/api/terminal/hardware_skus/object.md) pour déterminer le moment où une unité de gestion des stocks ne sera plus disponible à la commande, le cas échéant. Ces champs concernent également les nouveaux objets [Hardware Shipping Method](https://docs.stripe.com/api/terminal/hardware_shipping_methods/object.md) et [Hardware Product](https://docs.stripe.com/api/terminal/hardware_products/object.md). - Si les webhooks v3 et v4 sont activés dans le même mode (dans un environnement de test ou en mode production) en même temps, Stripe envoie le webhook `terminal.hardware_order.shipped` deux fois. Nous envoyons le webhook `terminal.hardware_order.shipped` lorsqu’une commande passe à l’état `ready_to_ship` et `shipped`, et non simplement lorsqu’elle passe à l’état `shipped`. La version v3 en mode production et la version v4 en mode test n’entraînent pas de doublons de webhooks. Si vous devez activer simultanément les versions v3 et v4 dans le même mode, veillez à mettre à jour votre intégration afin qu’elle gère d’abord les webhooks `terminal.hardware_order.shipped` en double. - Les commandes `ready_to_ship` dans la v4 apparaissent comme `shipped` dans la v3. Il est possible que vous voyiez une commande avec l’état `shipped` dans la v3 et `ready_to_ship` dans la v4 lors de la mise à jour de votre migration. Cela est dû au fait que le concept `ready_to_ship` n’existe pas dans la version v3. Ces commandes ne passent pas réellement à un état antérieur. #### v3 (2019-04-03) (Deprecated) - Mettez à jour [l’unité de gestion des stocks Terminal Hardware](https://docs.stripe.com/api/terminal/hardware_skus/object.md) et [l’objet SKU du poste Terminal Hardware Order](https://docs.stripe.com/api/terminal/hardware_orders/object.md#terminal_hardware_order_object-hardware_order_items-terminal_hardware_sku) en supprimant les champs de texte tels que `name`, `description`, `images` et `attributes`. - Rendez facultatif le paramètre de requête `shipping_country` des [unités de gestion des stocks Hardware Order](https://docs.stripe.com/api/terminal/hardware_skus/list.md) et renommez-le `country`. - Ajoutez la possibilité d’interroger des unités de gestion des stocks dans l’API, via les paramètres `product_type` et `country`. #### v2 (2019-12-20) (Deprecated) - Mettez à jour [Terminal Hardware Order](https://docs.stripe.com/api/terminal/hardware_orders/object.md) en transformant l’objet structuré `total_tax_amounts.rate.jurisdiction` en chaîne. #### v1 (20/11/2019) (Deprecated) - Sortie initiale