# 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 installez la [CLI Stripe](https://docs.stripe.com/cli.md), un outil essentiel qui vous fournit un accès à votre intégration Stripe via une ligne de commande. Vous allez également installer le [SDK Node.js côté serveur de Stripe](https://github.com/stripe/stripe-node) pour accéder aux API Stripe depuis les applications rédigées 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 v23.0.0 de Stripe
- Envoyer votre première requête SDK

## Configurer l'interface de ligne de commande Stripe

### Installez et connectez

Installez la CLI Stripe avec [npm](https://www.npmjs.com/) :

```bash
npm install -g @stripe/cli@latest
```

Après l’installation, connectez-vous à votre compte Stripe :

```bash
stripe login
```

Après avoir installé la CLI, vous pouvez également installer [les outils d’agent](https://docs.stripe.com/cli/agent/setup) ou configurer l’[autocomplétion](https://docs.stripe.com/cli/completion).

> Pour plus d’options d’installation pour Windows, macOS, Linux et Docker, consultez le [fichier README de la CLI Stripe](https://github.com/stripe/stripe-cli#installation) sur GitHub.

### 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

v23.0.0 est la dernière version du SDK Stripe Node.js côté serveur. Elle prend en charge les versions 18 et ultérieures de Node.js.

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": "^23.0.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_...');

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.md)