# Configurer votre environnement de développement

Familiarisez-vous avec l'interface de ligne de commande Stripe et nos SDK côté serveur.

Consultez notre [documentation relative aux intégrations sans code](https://docs.stripe.com/no-code.md), utilisez une [solution préconfigurée](https://stripe.com/partners/directory) de notre répertoire de partenaires, ou faites appel à un [expert Stripe certifié](https://stripe.com/partners/directory?t=Consulting).

Les SDK côté serveur et l’interface de ligne de commande (CLI) de Stripe vous permettent de communiquer avec les API REST de Stripe. Commencez par l’interface de commande Stripe pour rationaliser votre environnement de développement et effectuer des appels à l’API.

Utilisez les SDK pour éviter d’avoir à rédiger du code standard. Si vous souhaitez commencer à envoyer des requêtes depuis votre environnement, choisissez un langage pour consulter un guide de démarrage rapide.

> #### Extensions Chrome
> 
> Nous vous recommandons de créer votre intégration de paiement avec Stripe (par exemple [Elements](https://docs.stripe.com/payments/elements.md) ou [Checkout](https://docs.stripe.com/payments/checkout.md)) sur votre propre site Web. Ensuite, configurez votre extension Chrome pour rediriger les utilisateurs vers cette page de paiement lorsqu’ils sont prêts à effectuer un achat.
> 
> Cette méthode est plus sécurisée et plus facile à gérer que le traitement direct des paiements dans l’extension.

# Node.js


Dans ce guide de démarrage rapide, vous installerez la [Stripe CLI](https://docs.stripe.com/stripe-cli.md), un outil essentiel qui vous donne accès à votre intégration Stripe depuis la ligne de commande. Vous installerez également le [SDK Stripe Node.js côté serveur](https://github.com/stripe/stripe-node) pour accéder aux API Stripe depuis des applications écrites en Node.js.

## Objectifs d’apprentissage

Dans ce guide de démarrage rapide, vous apprendrez à :

- Appeler les API Stripe sans avoir à écrire une ligne de code
- Gérer les dépendances tierces à l’aide du gestionnaire de paquets npm ou Yarn
- Installer le dernier SDK Node v22.2.0 de Stripe
- Envoyer votre première requête SDK

## Configuration initiale

Tout d’abord, [créez un compte Stripe](https://dashboard.stripe.com/register) ou [connectez-vous](https://dashboard.stripe.com/login).

## Configurer l'interface de ligne de commande Stripe

### Installer

À partir de la ligne de commande, utilisez un script d’installation ou téléchargez et extrayez un fichier d’archive versionné pour votre système d’exploitation afin d’installer la CLI.

#### homebrew

Pour installer la CLI Stripe avec [homebrew](https://brew.sh/), exécutez la commande suivante :

```bash
brew install stripe/stripe-cli/stripe
```

Cette commande échoue si vous l’exécutez sur la version Linux de homebrew, mais vous pouvez utiliser cette alternative ou suivre les instructions de l’onglet Linux.

```bash
brew install stripe-cli
```

#### apt

> Le paquet Debian de la CLI est disponible sur JFrog à l’adresse https://packages.stripe.dev, qui n’est pas un domaine appartenant à Stripe. Lorsque vous accédez à cette URL, vous êtes redirigé vers la liste d’artefacts JFrog.

Pour installer la CLI Stripe sur des distributions Debian ou Ubuntu :

1. Ajoutez la clé GPG de l’interface de ligne de commande Stripe au trousseau de clés des sources apt :

```bash
curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg > /dev/null
```

1. Ajoutez le référentiel apt de la CLI à la liste des sources apt :

```bash
echo "deb [signed-by=/usr/share/keyrings/stripe.gpg] https://packages.stripe.dev/stripe-cli-debian-local stable main" | sudo tee -a /etc/apt/sources.list.d/stripe.list
```

1. Mettez à jour la liste des paquets :

```bash
sudo apt update
```

1. Installez la CLI :

```bash
sudo apt install stripe
```

#### yum

> Le paquet RPM de la CLI est disponible sur JFrog à l’adresse https://packages.stripe.dev, qui n’est pas un domaine appartenant à Stripe. Lorsque vous accédez à cette URL, vous êtes redirigé vers la liste d’artefacts JFrog.

Pour installer la CLI Stripe sur des distributions RPM :

1. Ajoutez le référentiel yum de la CLI à la liste des sources yum :

```bash
echo -e "[Stripe]\nname=stripe\nbaseurl=https://packages.stripe.dev/stripe-cli-rpm-local/\nenabled=1\ngpgcheck=0" >> /etc/yum.repos.d/stripe.repo
```

1. Installez la CLI :

```bash
sudo yum install stripe
```

#### Scoop

Pour installer la CLI Stripe avec [Scoop](https://scoop.sh/), exécutez la commande suivante :

```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```

```bash
scoop install stripe
```

#### winget

Pour installer la CLI Stripe avec [winget](https://learn.microsoft.com/en-us/windows/package-manager/winget/), exécutez :

```bash
winget install Stripe.StripeCLI
```

#### macOS

Pour installer la CLI Stripe sous macOS sans homebrew :

1. Téléchargez la dernière version du fichier tar.gz `mac-os` correspondant au type d’architecture de votre processeur sur [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
2. Décompressez le fichier : `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.

Vous pouvez au besoin installer le binaire dans un emplacement à partir duquel vous pourrez l’exécuter globalement (par exemple, `/usr/local/bin`).

#### Linux

Pour installer la CLI Stripe sous Linux sans gestionnaire de paquets :

1. Téléchargez la dernière version du fichier tar.gz `linux` sur [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
2. Décompressez le fichier : `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.
3. Déplacez `./stripe` sur votre chemin d’exécution.

#### Windows

Pour installer la CLI Stripe sous Windows sans Scoop :

1. Téléchargez la dernière version du fichier zip `windows` sur [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
2. Décompressez le fichier `stripe_X.X.X_windows_x86_64.zip`.
3. Ajoutez le chemin d’accès au fichier `stripe.exe` décompressé à votre variable d’environnement `Path`. Pour découvrir comment mettre à jour les variables d’environnement, consultez la [documentation Microsoft PowerShell](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.3#saving-changes-to-environment-variables).

> Les analyseurs antivirus de Windows signalent parfois la CLI Stripe comme dangereuse. Il s’agit probablement d’un faux positif. Pour plus d’informations, consultez le [problème #692](https://github.com/stripe/stripe-cli/issues/692) dans le référentiel GitHub.

1. Exécutez le fichier `.exe` décompressé.

#### Docker

La CLI Stripe est aussi disponible sous forme d’[image Docker](https://hub.docker.com/r/stripe/stripe-cli). Pour installer la version la plus récente, exécutez la commande suivante :

```bash
docker run --rm -it stripe/stripe-cli:latest
```

### S’identifier

Connectez-vous et authentifiez votre compte [utilisateur](https://docs.stripe.com/get-started/account/set-up.md) Stripe pour générer un ensemble de clés limitées. Pour en savoir plus, consultez la page [Clés et autorisations de la Stripe CLI](https://docs.stripe.com/stripe-cli/keys.md).

```bash
  stripe login
```

Appuyez sur la touche **Entrer** de votre clavier pour accomplir le processus d’authentification dans votre navigateur.

```bash
Your pairing code is: enjoy-enough-outwit-win
This pairing code verifies your authentication with Stripe.
Press Enter to open the browser or visit https://dashboard.stripe.com/stripecli/confirm_auth?t=THQdJfL3x12udFkNorJL8OF1iFlN8Az1 (^C to quit)
```

### Confirmer la configuration

Maintenant que l’interface de ligne de commande est installée, vous pouvez effectuer une requête unique à l’API afin de [créer un produit](https://docs.stripe.com/api/products/create.md).

#### bash

```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```

Recherchez l’identifiant produit (dans `id`) dans l’objet réponse. Conservez-le pour la prochaine étape.

Si tout a bien fonctionné, la ligne de commande affiche la réponse suivante.

#### bash

```json
{
  "id": "prod_LTenIrmp8Q67sa", // L'identifiant s'apparente à ceci.
  "object": "product",
  "active": true,
  "attributes": [],
  "created": 1668198126,
  "default_price": null,
  "description": "Created with the Stripe CLI",
  "identifiers": {},
  "images": [],
  "livemode": false,
  "metadata": {},
  "name": "My First Product",
  "package_dimensions": null,
  "price": null,
  "product_class": null,
  "shippable": null,
  "sku": "my-first-product-10",
  "statement_descriptor": null,
  "tax_code": null,
  "type": "service",
  "unit_label": null,
  "updated": 1668198126,
  "url": null
}
```

Ensuite, effectuez un appel de [création de tarif](https://docs.stripe.com/api/prices/create.md) pour associer un tarif de 30 USD. Remplacez le paramètre substituable contenu dans `product` par l’identifiant de votre produit (par exemple, `prod_LTenIrmp8Q67sa`).

#### bash

```bash
stripe prices create \
  --unit-amount=3000 \
  --currency=usd \
  --product="{{PRODUCT_ID}}"
```

Si tout a bien fonctionné, la ligne de commande affiche la réponse suivante.

#### bash

```json
{
  "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // L'identifiant s'apparente à ceci.
  "object": "price",
  "active": true,
  "billing_scheme": "per_unit",
  "created": 1652636348,
  "currency": "usd",
  "livemode": false,
  "lookup_key": null,
  "metadata": {},
  "nickname": null,
  "product": "prod_Lh9iTGZhb2mcBy",
  "recurring": null,
  "tax_behavior": "unspecified",
  "tiers_mode": null,
  "transform_quantity": null,
  "type": "one_time",
  "unit_amount": 3000,
  "unit_amount_decimal": "3000"
}
```

## Installer le SDK de Node.js côté serveur

v22.2.0 est la dernière version du SDK Stripe Node.js côté serveur. Elle prend en charge les versions versions 12 et ultérieures.

Vérifiez votre version Node :

```bash
node --version
```

### Initialiser Node

#### Initialiser Node

```bash
npm init
```

### Installer la bibliothèque

Installez la bibliothèque avec [npm](https://www.npmjs.com/package/node), un gestionnaire de paquets pour Node :

```bash
npm install stripe --save
```

Une fois que vous avez installé la bibliothèque avec npm, celle-ci est ajoutée automatiquement en tant que dépendance dans le fichier package.json de votre projet. Par exemple :

```json
{
  "name": "stripe-node-example",
  "version": "1.0.0",
  "description": "A Stripe demo",
  "main": "index.js",
  "scripts": {
    "node ": "node create_price.js",
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC",
  "dependencies": {
    "stripe": "^22.2.0"
  }
}
```

### Autres méthodes d'installation

**Yarn** : vous pouvez installer la bibliothèque avec [Yarn](https://yarnpkg.com/), un autre gestionnaire de paquets pour Node :

```bash
yarn add stripe
```

## Exécuter votre première requête SDK

Maintenant que le SDK de Node.js est installé, vous pouvez créer un abonnement [Produit](https://docs.stripe.com/api/products/create.md) et associer un [tarif](https://docs.stripe.com/api/prices/create.md) avec deux requêtes API. Le SDK de Node.js renvoie des [promesses](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) qui peuvent être utilisées comme des rappels modulables. Pour démonstration, nous transmettons l’identifiant du produit renvoyé dans la réponse Produit pour créer un tarif dans cet exemple.

> #### Appliquez les bonnes pratiques en matière de clés API.
> 
> Cet exemple utilise les clés par défaut de votre [compte](https://docs.stripe.com/get-started/account/set-up.md) utilisateur Stripe pour votre *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). Vous êtes le seul à pouvoir voir ces valeurs. Suivez les [bonnes pratiques](https://docs.stripe.com/keys-best-practices.md) pour gérer vos clés en toute sécurité.

#### Créer un produit et un tarif

```node
// Don't embed any keys in production code. This is an example.
// See https://docs.stripe.com/keys-best-practices.
const stripe = require('stripe')('sk_test_BQokikJOvBiI2HlWgH4olfQ2');

stripe.products.create({
  name: 'Starter Subscription',
  description: '$12/Month subscription',
}).then(product => {
  stripe.prices.create({
    unit_amount: 1200,
    currency: 'usd',
    recurring: {
      interval: 'month',
    },
    product: product.id,
  }).then(price => {
    console.log('Success! Here is your starter subscription product id: ' + product.id);
    console.log('Success! Here is your starter subscription price id: ' + price.id);
  });
});
```

Enregistrez le fichier sous `create_price.js`. Depuis la ligne de commande, utilisez la commande `cd` pour pointer vers le répertoire contenant le fichier que vous venez d’enregistrer, puis exécutez ce qui suit :

#### create_price.js

```bash
node create_price.js
```

Si tout a bien fonctionné, la ligne de commande affiche la réponse suivante. Enregistrez ces identifiants afin de pouvoir les utiliser lors de la création de votre intégration.

#### bash

```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```

## See also

Cela marque la conclusion du QuickStart. Référez-vous aux liens ci-dessous pour découvrir différents moyens de traiter un paiement pour le produit que vous venez de créer.

- [Créer un lien de paiement](https://docs.stripe.com/payment-links.md)
- [Une page hébergée par Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Intégration avancée](https://docs.stripe.com/payments/quickstart-checkout-sessions.md)