# Configurez l’environnement de développement

Découvrez l’interface de ligne de commande de Stripe et nos trousses SDK côté serveur.

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

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

Utilisez les trousses SDK pour éviter de rédiger du code en paragraphe passe-partout. Pour commencer à envoyer des requêtes à partir de votre environnement, choisissez une langue pour suivre les instructions d’un guide de démarrage rapide.

> #### Extensions Chrome
> 
> Nous vous recommandons de créer votre intégration de paiement avec Stripe (comme [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.

# Ruby

> This is a Ruby for when lang is ruby. View the full page at https://docs.stripe.com/get-started/development-environment?lang=ruby.

Dans ce démarrage rapide, vous installez [l’interface de ligne de commande Stripe](https://docs.stripe.com/stripe-cli.md) : un outil essentiel qui vous permet d’accéder à une ligne de commande de votre intégration Stripe. Vous installez également la [trousse de développement logiciel (SDK) côté serveur Stripe Ruby pour accéder aux API](https://github.com/stripe/stripe-ruby) Stripe à partir des applications écrites dans Ruby.

## Ce que vous apprenez

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

- Comment appeler des API Stripe sans écrire de ligne de code
- Comment gérer les dépendances tierces à l’aide d’un regroupeur avec RubyGems
- Comment installer la trousse SDK Stripe Ruby v18.4.0
- Comment envoyer votre première demande de SDK

## Configuration initiale

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

## Configurer l’interface de ligne de commande de Stripe

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

### 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 l’interface de ligne de commande.

#### homebrew

Pour installer l’interface de ligne de commande de 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 solution alternative ou suivre les instructions de l’onglet Linux.

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

#### apt

> La version Debian conçue pour CLI est disponible sur JFrog à l’adresse https://packages.stripe.dev, qui n’est pas un domaine qui appartient à Stripe. Lorsque vous entrez cette adresse URL, elle vous redirige vers la liste d’archivage des versions Jfrog.

Pour installer l’interface de ligne de commande Stripe sur des distributions dérivées de Debian et Ubuntu :

1. Add Stripe CLI’s GPG key to the apt sources keyring:

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

1. Ajoutez le référentiel apt de l’interface de ligne de commande à 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. Installer l’interface de ligne de commande

```bash
sudo apt install stripe
```

#### yum

> Le RPM conçu pour CLI est disponible sur JFrog à l’adresse https://packages.stripe.dev, qui n’est pas un domaine appartenant à Stripe. Lorsque vous entrez cette URL, elle vous redirige vers la liste d’archivage des versions Jfrog.

Pour installer l’interface de ligne de commande Stripe sur des distributions dérivées de RPM :

1. Ajoutez le référentiel yum de l’interface de ligne de commande à 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. Installer l’interface de ligne de commande

```bash
sudo yum install stripe
```

#### Scoop

Pour installer l’interface de ligne de commande de 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
```

#### macOS

Pour installer l’interface de ligne de commande de 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).
1. Décompressez le fichier `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.

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

#### Linux

Pour installer l’interface de ligne de commande de Stripe sous Linux sans gestionnaire de paquets :

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

#### Windows

Pour installer l’interface de ligne de commande de Stripe sous Windows sans Scoop :

1. Téléchargez la dernière version du fichier `windows` zip à partir de [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Décompressez le fichier `stripe_X.X.X_windows_x86_64.zip`.
1. Ajoutez le chemin vers le fichier `stripe.exe` décompressé à votre variable d’environnement `Path`. Pour découvrir comment mettre à jour les variables d’environnement, consultez la [documentation de 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 antivirus de Windows indiquent parfois que l’interface de ligne de commande n’est pas sécurisée. Il s’agit probablement d’un faux positif. Pour en savoir plus, 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
```

### M’authentifier

Connectez-vous et authentifiez votre [compte utilisateur Stripe](https://docs.stripe.com/get-started/account/activate.md) afin de générer un jeu de clés limitées. Pour en savoir plus, consultez la documentation relative aux [clés de l’interface de ligne de commande Stripe et aux autorisations](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 de réponse. Enregistrez-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, appelez l’API de [création de prix](https://docs.stripe.com/api/prices/create.md) pour joindre un prix de 30 USD. Remplacez l’espace réservé dans `product` par votre identifiant de 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"
}
```

## Gérer les dépendances tierces

Nous vous recommandons de gérer les dépendances tierces à l’aide de l’outil de ligne de commande [RubyGems](http://rubygems.org/), ce qui vous permet d’ajouter de nouvelles bibliothèques et de les inclure dans vos projets Ruby. Vérifiez si RubyGems est installé :

### Installation de RubyGems

#### Installation de RubyGems

```bash
gem --version
```

Si vous obtenez `gem: command not found`, [téléchargez RubyGems](http://rubygems.org/pages/download) depuis sa page de téléchargement.

## Installer le SDK côté serveur Ruby

///v18.4.0 est la dernière version du SDK côté serveur de Ruby de Stripe. Elle prend en charge les versions 2.3 et supérieures de Ruby.

Vérifier votre version Ruby :

```bash
ruby -v
```

### Installer la bibliothèque

[Créez un fichier gem](https://guides.rubygems.org/make-your-own-gem/) et installez le gem généré à l’aide d’un bundler avec [RubyGems](https://rubygems.org/).

Ajoutez la version la plus récente du [gem Stripe](https://rubygems.org/gems/stripe) à un projet :

```bash
bundle add stripe
```

Installez les gems requis à partir de vos sources précisées :

```bash
bundle install
```

### Autres possibilités d'installation

**Ajouter en tant que dépendance** : Ajouter la version la plus récente de la bibliothèque en tant que du gem :

```ruby
source 'https://rubygems.org'

gem 'rails'
gem 'stripe'
```

**Installation globale** : Installez la bibliothèque globalement avec [RubyGems](https://rubygems.org/) :

```bash
gem install stripe
```

**Installation manuelle** : [créer le gem à partir de la source](https://github.com/stripe/stripe-ruby), et installer ensuite la bibliothèque en exécutant :

```bash
gem build stripe.gemspec
```

## Exécutez votre première demande de SDK

Maintenant que vous avez installé la trousse SDK Ruby, vous pouvez créer un abonnement [Produit](https://docs.stripe.com/api/products/create.md) et joindre un [Prix](https://docs.stripe.com/api/prices/create.md) avec quelques requêtes API. Dans cet exemple, nous utilisons l’ID du produit renvoyé dans la réponse pour créer le prix.

> Cet exemple utilise les clés par défaut de votre [compte](https://docs.stripe.com/get-started/account/activate.md) utilisateur Stripe pour votre environnement de *bac à sable* (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). Personne d’autre que vous ne peut voir ces valeurs.

#### Créez un produit et un tarif

```ruby
require 'rubygems'
require 'stripe'
Stripe.api_key = "sk_test_BQokikJOvBiI2HlWgH4olfQ2"

starter_subscription = Stripe::Product.create(
  name: 'Starter Subscription',
  description: '$12/Month subscription',
)

starter_subscription_price = Stripe::Price.create(
  currency: 'usd',
  unit_amount: 1200,
  recurring: {interval: 'month'},
  product: starter_subscription['id'],
)

puts "Success! Here is your starter subscription product id: #{starter_subscription.id}"
puts "Success! Here is your starter subscription price id: #{starter_subscription_price.id}"
```

Enregistrez le fichier sous `create_price.rb`. De la ligne de commande, `cd` vers le répertoire contenant le fichier que vous venez d’enregistrer et exécutez :

#### create_price.rb

```bash
ruby create_price.rb
```

Si tout a 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

Ceci conclut le démarrage rapide. Cliquez sur les liens ci-dessous pour découvrir différentes façons de traiter un paiement pour le produit que vous venez de créer.

- [Créez un lien de paiement](https://docs.stripe.com/payment-links.md)
- [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)


# Python

> This is a Python for when lang is python. View the full page at https://docs.stripe.com/get-started/development-environment?lang=python.

Dans ce démarrage rapide, vous installez [l’interface de ligne de commande Stripe](https://docs.stripe.com/stripe-cli.md) : un outil essentiel qui vous permet d’accéder à une ligne de commande de votre intégration Stripe. Vous installez également la [trousse de développement logiciel (SDK) côté serveur Stripe Python pour accéder aux API](https://github.com/stripe/stripe-python) Stripe à partir des applications écrites dans Python.

## Ce que vous apprenez

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

- Comment appeler des API Stripe sans écrire de ligne de code
- Comment gérer les dépendances tierces à l’aide d’un environnement virtuel et du gestionnaire de paquets pip
- Installation du dernier SDK Stripe Python v14.4.0
- Comment envoyer votre première demande de SDK

## Configuration initiale

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

## Configurer l’interface de ligne de commande de 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 l’interface de ligne de commande.

#### homebrew

Pour installer l’interface de ligne de commande de 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 solution alternative ou suivre les instructions de l’onglet Linux.

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

#### apt

> La version Debian conçue pour CLI est disponible sur JFrog à l’adresse https://packages.stripe.dev, qui n’est pas un domaine qui appartient à Stripe. Lorsque vous entrez cette adresse URL, elle vous redirige vers la liste d’archivage des versions Jfrog.

Pour installer l’interface de ligne de commande Stripe sur des distributions dérivées de Debian et Ubuntu :

1. Add Stripe CLI’s GPG key to the apt sources keyring:

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

1. Ajoutez le référentiel apt de l’interface de ligne de commande à 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. Installer l’interface de ligne de commande

```bash
sudo apt install stripe
```

#### yum

> Le RPM conçu pour CLI est disponible sur JFrog à l’adresse https://packages.stripe.dev, qui n’est pas un domaine appartenant à Stripe. Lorsque vous entrez cette URL, elle vous redirige vers la liste d’archivage des versions Jfrog.

Pour installer l’interface de ligne de commande Stripe sur des distributions dérivées de RPM :

1. Ajoutez le référentiel yum de l’interface de ligne de commande à 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. Installer l’interface de ligne de commande

```bash
sudo yum install stripe
```

#### Scoop

Pour installer l’interface de ligne de commande de 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
```

#### macOS

Pour installer l’interface de ligne de commande de 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).
1. Décompressez le fichier `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.

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

#### Linux

Pour installer l’interface de ligne de commande de Stripe sous Linux sans gestionnaire de paquets :

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

#### Windows

Pour installer l’interface de ligne de commande de Stripe sous Windows sans Scoop :

1. Téléchargez la dernière version du fichier `windows` zip à partir de [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Décompressez le fichier `stripe_X.X.X_windows_x86_64.zip`.
1. Ajoutez le chemin vers le fichier `stripe.exe` décompressé à votre variable d’environnement `Path`. Pour découvrir comment mettre à jour les variables d’environnement, consultez la [documentation de 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 antivirus de Windows indiquent parfois que l’interface de ligne de commande n’est pas sécurisée. Il s’agit probablement d’un faux positif. Pour en savoir plus, 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
```

### M’authentifier

Connectez-vous et authentifiez votre [compte utilisateur Stripe](https://docs.stripe.com/get-started/account/activate.md) afin de générer un jeu de clés limitées. Pour en savoir plus, consultez la documentation relative aux [clés de l’interface de ligne de commande Stripe et aux autorisations](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 de réponse. Enregistrez-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, appelez l’API de [création de prix](https://docs.stripe.com/api/prices/create.md) pour joindre un prix de 30 USD. Remplacez l’espace réservé dans `product` par votre identifiant de 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"
}
```

## Gérer les dépendances tierces

Nous vous recommandons de gérer les dépendances tierces à l’aide du module [venv](https://docs.python.org/3/tutorial/venv.html), ce qui vous permet d’ajouter de nouvelles bibliothèques et de les inclure dans vos projets Python 3.

### Sur Windows (cmd.exe) :

#### Sur Windows (cmd.exe)

```bash
python3 -m venv env
.\env\Scripts\activate.bat
```

### Sur GNU Linux ou MacOS (Bash) :

#### Sur GNU/Linux ou MacOS (Bash)

```bash
python3 -m venv env
source env/bin/activate
```

## Installer la trousse SDK Python côté serveur

La dernière version du SDK côté serveur de Python de Stripe est v14.4.0. Elle prend en charge les versions 3.6 et supérieures de Python.

///Vérifier votre version Python :

```bash
python3 --version
```

### Installer la bibliothèque

Installez la bibliothèque avec [PyPi](http://pypi.python.org/pypi/stripe/), un gestionnaire de paquets pour Python :

```bash
pip3 install --upgrade stripe
```

Ensuite, indiquez la version suivante dans votre fichier requirements.txt :

```txt
stripe>=14.4.0
```

### Autres possibilités d'installation

\** Installation manuelle ** : [Télécharger le code source](https://github.com/stripe/stripe-python) du SDK, et installer la bibliothèque en exécutant :

```bash
python3 setup.py install
```

## Exécutez votre première demande de SDK

Maintenant que vous avez installé la trousse SDK Python, vous pouvez créer un abonnement [Produit](https://docs.stripe.com/api/products/create.md) et joindre un [Prix](https://docs.stripe.com/api/prices/create.md) avec quelques requêtes API. Dans cet exemple, nous utilisons l’ID du produit renvoyé dans la réponse pour créer le prix.

> Cet exemple utilise les clés par défaut de votre [compte](https://docs.stripe.com/get-started/account/activate.md) utilisateur Stripe pour votre environnement de *bac à sable* (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). Personne d’autre que vous ne peut voir ces valeurs.

#### Créez un produit et un tarif

```python
import stripe
stripe.api_key = "sk_test_BQokikJOvBiI2HlWgH4olfQ2"

starter_subscription = stripe.Product.create(
  name="Starter Subscription",
  description="$12/Month subscription",
)

starter_subscription_price = stripe.Price.create(
  unit_amount=1200,
  currency="usd",
  recurring={"interval": "month"},
  product=starter_subscription['id'],
)

# Save these identifiers
print(f"Success! Here is your starter subscription product id: {starter_subscription.id}")
print(f"Success! Here is your starter subscription price id: {starter_subscription_price.id}")
```

Enregistrez le fichier sous `create_price.py`. De la ligne de commande, `cd` vers le répertoire contenant le fichier que vous venez d’enregistrer et exécutez :

#### create_price.py

```bash
python3 create_price.py
```

Si tout a 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

Ceci conclut le démarrage rapide. Cliquez sur les liens ci-dessous pour découvrir différentes façons de traiter un paiement pour le produit que vous venez de créer.

- [Créez un lien de paiement](https://docs.stripe.com/payment-links.md)
- [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)


# Go

> This is a Go for when lang is go. View the full page at https://docs.stripe.com/get-started/development-environment?lang=go.

Dans ce démarrage rapide, vous installez [l’interface de ligne de commande Stripe](https://docs.stripe.com/stripe-cli.md) : un outil essentiel qui vous permet d’accéder à une ligne de commande de votre intégration Stripe. Vous installez également la [trousse de développement logiciel (SDK) côté serveur Stripe Go pour accéder aux API](https://github.com/stripe/stripe-go) Stripe à partir des applications écrites dans Go.

## Ce que vous apprenez

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

- Comment appeler des API Stripe sans écrire de ligne de code
- Comment gérer les dépendances tierces à l’aide des modules Go
- Installation du dernier SDK Stripe Go v84.4.0
- Comment envoyer votre première demande de SDK

## Configuration initiale

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

## Configurer l’interface de ligne de commande de 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 l’interface de ligne de commande.

#### homebrew

Pour installer l’interface de ligne de commande de 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 solution alternative ou suivre les instructions de l’onglet Linux.

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

#### apt

> La version Debian conçue pour CLI est disponible sur JFrog à l’adresse https://packages.stripe.dev, qui n’est pas un domaine qui appartient à Stripe. Lorsque vous entrez cette adresse URL, elle vous redirige vers la liste d’archivage des versions Jfrog.

Pour installer l’interface de ligne de commande Stripe sur des distributions dérivées de Debian et Ubuntu :

1. Add Stripe CLI’s GPG key to the apt sources keyring:

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

1. Ajoutez le référentiel apt de l’interface de ligne de commande à 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. Installer l’interface de ligne de commande

```bash
sudo apt install stripe
```

#### yum

> Le RPM conçu pour CLI est disponible sur JFrog à l’adresse https://packages.stripe.dev, qui n’est pas un domaine appartenant à Stripe. Lorsque vous entrez cette URL, elle vous redirige vers la liste d’archivage des versions Jfrog.

Pour installer l’interface de ligne de commande Stripe sur des distributions dérivées de RPM :

1. Ajoutez le référentiel yum de l’interface de ligne de commande à 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. Installer l’interface de ligne de commande

```bash
sudo yum install stripe
```

#### Scoop

Pour installer l’interface de ligne de commande de 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
```

#### macOS

Pour installer l’interface de ligne de commande de 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).
1. Décompressez le fichier `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.

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

#### Linux

Pour installer l’interface de ligne de commande de Stripe sous Linux sans gestionnaire de paquets :

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

#### Windows

Pour installer l’interface de ligne de commande de Stripe sous Windows sans Scoop :

1. Téléchargez la dernière version du fichier `windows` zip à partir de [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Décompressez le fichier `stripe_X.X.X_windows_x86_64.zip`.
1. Ajoutez le chemin vers le fichier `stripe.exe` décompressé à votre variable d’environnement `Path`. Pour découvrir comment mettre à jour les variables d’environnement, consultez la [documentation de 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 antivirus de Windows indiquent parfois que l’interface de ligne de commande n’est pas sécurisée. Il s’agit probablement d’un faux positif. Pour en savoir plus, 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
```

### M’authentifier

Connectez-vous et authentifiez votre [compte utilisateur Stripe](https://docs.stripe.com/get-started/account/activate.md) afin de générer un jeu de clés limitées. Pour en savoir plus, consultez la documentation relative aux [clés de l’interface de ligne de commande Stripe et aux autorisations](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 de réponse. Enregistrez-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, appelez l’API de [création de prix](https://docs.stripe.com/api/prices/create.md) pour joindre un prix de 30 USD. Remplacez l’espace réservé dans `product` par votre identifiant de 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"
}
```

## Gérer les dépendances tierces

Nous vous recommandons de gérer les dépendances tierces à l’aide des [modules Go](https://go.dev/blog/using-go-modules), ce qui vous permet d’ajouter de nouvelles bibliothèques et de les inclure dans vos projets Go.

### Initialisation de Go

Si vous démarrez à partir de zéro dans un nouveau répertoire, vous devez d’abord créer un fichier `go.mod` pour suivre les dépendances. Par exemple :

#### Initialisation de Go

```bash
go mod init stripe-example
```

## Installer le SDK côté serveur Go

///v84.4.0 est la dernière version du SDK Go de Stripe. Elle prend en charge toutes les versions 1,15 et supérieures de Go.

### Installer la bibliothèque

Installez la bibliothèque avec des [modules Go](https://go.dev/blog/using-go-modules), un gestionnaire de paquets pour Go :

```bash
go get github.com/stripe/stripe-go/v84
```

Après avoir installé la bibliothèque avec les modules Go sur un *nouveau* projet, la bibliothèque est automatiquement ajoutée en tant que dépendance dans le fichier go.mod de votre projet. Par exemple :

```go.mod
module stripe-example

go 1.18

require github.com/stripe/stripe-go/v84 84.4.0 // indirect
```

### Synchroniser les dépendances

Pour garder votre dépendance gérée en ordre pour un *existing* project, exécutez la commande suivante pour [synchroniser les dépendances de votre code](https://go.dev/doc/modules/managing-dependencies).

```bash
go mod tidy
```

## Exécutez votre première demande de SDK

Maintenant que vous avez installé la trousse SDK Go, vous pouvez créer un abonnement [Produit](https://docs.stripe.com/api/products/create.md) et joindre un [Prix](https://docs.stripe.com/api/prices/create.md) avec quelques requêtes API. Dans cet exemple, nous utilisons l’ID du produit renvoyé dans la réponse pour créer le prix.

> Cet exemple utilise les clés par défaut de votre [compte](https://docs.stripe.com/get-started/account/activate.md) utilisateur Stripe pour votre environnement de *bac à sable* (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). Personne d’autre que vous ne peut voir ces valeurs.

#### Créez un produit et un tarif

```go
package main

import (
  "fmt"
  "github.com/stripe/stripe-go/v84"
  "github.com/stripe/stripe-go/v84/product"
  "github.com/stripe/stripe-go/v84/price"
)

func main() {
  stripe.Key = "sk_test_BQokikJOvBiI2HlWgH4olfQ2"

	product_params := &stripe.ProductParams{
		Name:        stripe.String("Starter Subscription"),
		Description: stripe.String("$12/Month subscription"),
	}
	starter_product, _ := product.New(product_params)

	price_params := &stripe.PriceParams{
		Currency: stripe.String(string(stripe.CurrencyUSD)),
		Product:  stripe.String(starter_product.ID),
		Recurring: &stripe.PriceRecurringParams{
			Interval: stripe.String(string(stripe.PriceRecurringIntervalMonth)),
		},
		UnitAmount: stripe.Int64(1200),
	}
	starter_price, _ := price.New(price_params)

	fmt.Println("Success! Here is your starter subscription product id: " + starter_product.ID)
	fmt.Println("Success! Here is your starter subscription price id: " + starter_price.ID)
}
```

Enregistrez le fichier sous `create_price.go`. De la ligne de commande, `cd` vers le répertoire contenant le fichier que vous venez d’enregistrer et exécutez :

#### create_price.rb

```bash
go run create_price.go
```

Si tout a 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

Ceci conclut le démarrage rapide. Cliquez sur les liens ci-dessous pour découvrir différentes façons de traiter un paiement pour le produit que vous venez de créer.

- [Créez un lien de paiement](https://docs.stripe.com/payment-links.md)
- [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)


# Java

> This is a Java for when lang is java. View the full page at https://docs.stripe.com/get-started/development-environment?lang=java.

Dans ce démarrage rapide, vous installez [l’interface de ligne de commande Stripe](https://docs.stripe.com/stripe-cli.md) : un outil essentiel qui vous permet d’accéder à une ligne de commande de votre intégration Stripe. Vous installez également la [trousse de développement logiciel (SDK) côté serveur Stripe Java pour accéder aux API](https://github.com/stripe/stripe-java) Stripe à partir des applications écrites dans Java.

## Ce que vous apprenez

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

- Comment appeler des API Stripe sans écrire de ligne de code
- Comment gérer les dépendances tierces à l’aide de Maven ou Gradle
- Installation du dernier SDK Java Stripe v31.4.0
- Comment envoyer votre première demande de SDK

## Configuration initiale

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

## Configurer l’interface de ligne de commande de 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 l’interface de ligne de commande.

#### homebrew

Pour installer l’interface de ligne de commande de 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 solution alternative ou suivre les instructions de l’onglet Linux.

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

#### apt

> La version Debian conçue pour CLI est disponible sur JFrog à l’adresse https://packages.stripe.dev, qui n’est pas un domaine qui appartient à Stripe. Lorsque vous entrez cette adresse URL, elle vous redirige vers la liste d’archivage des versions Jfrog.

Pour installer l’interface de ligne de commande Stripe sur des distributions dérivées de Debian et Ubuntu :

1. Add Stripe CLI’s GPG key to the apt sources keyring:

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

1. Ajoutez le référentiel apt de l’interface de ligne de commande à 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. Installer l’interface de ligne de commande

```bash
sudo apt install stripe
```

#### yum

> Le RPM conçu pour CLI est disponible sur JFrog à l’adresse https://packages.stripe.dev, qui n’est pas un domaine appartenant à Stripe. Lorsque vous entrez cette URL, elle vous redirige vers la liste d’archivage des versions Jfrog.

Pour installer l’interface de ligne de commande Stripe sur des distributions dérivées de RPM :

1. Ajoutez le référentiel yum de l’interface de ligne de commande à 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. Installer l’interface de ligne de commande

```bash
sudo yum install stripe
```

#### Scoop

Pour installer l’interface de ligne de commande de 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
```

#### macOS

Pour installer l’interface de ligne de commande de 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).
1. Décompressez le fichier `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.

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

#### Linux

Pour installer l’interface de ligne de commande de Stripe sous Linux sans gestionnaire de paquets :

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

#### Windows

Pour installer l’interface de ligne de commande de Stripe sous Windows sans Scoop :

1. Téléchargez la dernière version du fichier `windows` zip à partir de [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Décompressez le fichier `stripe_X.X.X_windows_x86_64.zip`.
1. Ajoutez le chemin vers le fichier `stripe.exe` décompressé à votre variable d’environnement `Path`. Pour découvrir comment mettre à jour les variables d’environnement, consultez la [documentation de 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 antivirus de Windows indiquent parfois que l’interface de ligne de commande n’est pas sécurisée. Il s’agit probablement d’un faux positif. Pour en savoir plus, 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
```

### M’authentifier

Connectez-vous et authentifiez votre [compte utilisateur Stripe](https://docs.stripe.com/get-started/account/activate.md) afin de générer un jeu de clés limitées. Pour en savoir plus, consultez la documentation relative aux [clés de l’interface de ligne de commande Stripe et aux autorisations](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 de réponse. Enregistrez-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, appelez l’API de [création de prix](https://docs.stripe.com/api/prices/create.md) pour joindre un prix de 30 USD. Remplacez l’espace réservé dans `product` par votre identifiant de 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"
}
```

## Gérer les dépendances tierces

Nous vous recommandons de gérer les dépendances tierces à l’aide de [Maven](https://maven.apache.org/guides/getting-started/index.html) ou [Gradle](https://docs.gradle.org), qui permettent d’ajouter de nouvelles bibliothèques et de les inclure dans vos projets Java.

### Initialiser un projet

- Pour créer un projet avec **Maven**, veuillez consulter le guide [Comment réaliser mon premier projet Maven?](https://maven.apache.org/guides/getting-started/index.html#How_do_I_make_my_first_Maven_project).
- Pour créer un projet avec **Gradle**, veuillez consulter l’[exemple de développement d’applications Java](https://docs.gradle.org/current/samples/sample_building_java_applications.html).

## Installer la trousse SDK Java côté serveur

///v31.4.0 est la dernière version du SDK Java de Stripe. Elle prend en charge les versions de Java 1.8 et supérieures.

///Vérifier votre version Java :

```bash
java -version
```

### Installer la bibliothèque

- Avec **Maven**, ajoutez les éléments suivants au fichier pom.xml de votre projet :

```xml
<dependency>
  <groupId>com.stripe</groupId>
  <artifactId>stripe-java</artifactId>
  <version>31.4.0</version>
</dependency>
```

- Avec **Gradle**, collez la ligne suivante dans le bloc des dépendances de votre fichier build.gradle&nbsp;:

```groovy
implementation 'com.stripe:stripe-java:31.4.0'
```

### Autres possibilités d'installation

\** Installation manuelle **&nbsp;: Vous pouvez installer manuellement stripe-java avec les fichiers JAR suivants&nbsp;: [Télécharger le JAR de Stripe (.jar)](https://search.maven.org/remote_content?g=com.stripe&a=stripe-java&v=LATEST).

[Téléchargez le JAR Gson (.jar)](https://repo1.maven.org/maven2/com/google/code/gson/gson/2.8.9/gson-2.8.9.jar) pour [Google Gson](https://github.com/google/gson).

**Proguard**&nbsp;: Si vous utilisez ProGuard, assurez-vous d’avoir exclu la bibliothèque en ajoutant les éléments suivants à votre fichier `proguard.cfg`&nbsp;:

```proguard
-keep class com.stripe.** { *; }
```

## Exécutez votre première demande de SDK

Maintenant que vous avez installé la trousse SDK Java, vous pouvez créer un abonnement [Produit](https://docs.stripe.com/api/products/create.md) et joindre un [Prix](https://docs.stripe.com/api/prices/create.md) avec quelques requêtes API. Dans cet exemple, nous utilisons l’ID du produit renvoyé dans la réponse pour créer le prix.

> Cet exemple utilise les clés par défaut de votre [compte](https://docs.stripe.com/get-started/account/activate.md) utilisateur Stripe pour votre environnement de *bac à sable* (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). Personne d’autre que vous ne peut voir ces valeurs.

#### Créez un produit et un tarif

```java
package com.stripe.sample;

import com.stripe.Stripe;
import com.stripe.exception.StripeException;
import com.stripe.model.Product;
import com.stripe.param.ProductCreateParams;
import com.stripe.param.PriceCreateParams;
import com.stripe.model.Price;

public class Server {
    public static void main(String[] args) throws StripeException {
        Stripe.apiKey = "sk_test_BQokikJOvBiI2HlWgH4olfQ2";


        ProductCreateParams productParams =
            ProductCreateParams.builder()
                .setName("Starter Subscription")
                .setDescription("$12/Month subscription")
                .build();
        Product product = Product.create(productParams);
        System.out.println("Success! Here is your starter subscription product id: " + product.getId());

        PriceCreateParams params =
            PriceCreateParams
                .builder()
                .setProduct(product.getId())
                .setCurrency("usd")
                .setUnitAmount(1200L)
                .setRecurring(
                    PriceCreateParams.Recurring
                        .builder()
                        .setInterval(PriceCreateParams.Recurring.Interval.MONTH)
                        .build())
                .build();
        Price price = Price.create(params);
        System.out.println("Success! Here is your starter subscription price id: " + price.getId());
    }
}
```

Enregistrez le fichier sous `CreatePrice.java`. Exécutez l’exemple à partir du projet dans votre IDE pour Maven ou Gradle. Par exemple&nbsp;: `Run 'CreatePrice.main()'`.

Si tout a 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

Ceci conclut le démarrage rapide. Cliquez sur les liens ci-dessous pour découvrir différentes façons de traiter un paiement pour le produit que vous venez de créer.

- [Créez un lien de paiement](https://docs.stripe.com/payment-links.md)
- [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)


# Node.js

> This is a Node.js for when lang is node. View the full page at https://docs.stripe.com/get-started/development-environment?lang=node.

Dans ce démarrage rapide, vous installez [l’interface de ligne de commande Stripe](https://docs.stripe.com/stripe-cli.md)&nbsp;: un outil essentiel qui vous permet d’accéder à une ligne de commande de votre intégration Stripe. Vous installez également la [trousse de développement logiciel (SDK) côté serveur Stripe Node.js pour accéder aux API](https://github.com/stripe/stripe-node) Stripe à partir des applications écrites dans Node.js.

## Ce que vous apprenez

Dans ce guide de démarrage rapide, vous apprendrez&nbsp;:

- Comment appeler des API Stripe sans écrire de ligne de code
- Comment gérer les dépendances tierces à l’aide du gestionnaire de paquets Yarn ou Npm
- Installation du dernier SDK Stripe Node v20.4.0
- Comment envoyer votre première demande de SDK

## Configuration initiale

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

## Configurer l’interface de ligne de commande de 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 l’interface de ligne de commande.

#### homebrew

Pour installer l’interface de ligne de commande de Stripe avec [homebrew](https://brew.sh/), exécutez la commande suivante&nbsp;:

```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 solution alternative ou suivre les instructions de l’onglet Linux.

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

#### apt

> La version Debian conçue pour CLI est disponible sur JFrog à l’adresse https://packages.stripe.dev, qui n’est pas un domaine qui appartient à Stripe. Lorsque vous entrez cette adresse URL, elle vous redirige vers la liste d’archivage des versions Jfrog.

Pour installer l’interface de ligne de commande Stripe sur des distributions dérivées de Debian et Ubuntu&nbsp;:

1. Add Stripe CLI’s GPG key to the apt sources keyring:

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

1. Ajoutez le référentiel apt de l’interface de ligne de commande à la liste des sources apt&nbsp;:

```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&nbsp;:

```bash
sudo apt update
```

1. Installer l’interface de ligne de commande

```bash
sudo apt install stripe
```

#### yum

> Le RPM conçu pour CLI est disponible sur JFrog à l’adresse https://packages.stripe.dev, qui n’est pas un domaine appartenant à Stripe. Lorsque vous entrez cette URL, elle vous redirige vers la liste d’archivage des versions Jfrog.

Pour installer l’interface de ligne de commande Stripe sur des distributions dérivées de RPM&nbsp;:

1. Ajoutez le référentiel yum de l’interface de ligne de commande à la liste des sources yum&nbsp;:

```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. Installer l’interface de ligne de commande

```bash
sudo yum install stripe
```

#### Scoop

Pour installer l’interface de ligne de commande de Stripe avec [Scoop](https://scoop.sh/), exécutez la commande suivante&nbsp;:

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

```bash
scoop install stripe
```

#### macOS

Pour installer l’interface de ligne de commande de Stripe sous macOS sans homebrew&nbsp;:

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).
1. Décompressez le fichier `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.

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

#### Linux

Pour installer l’interface de ligne de commande de Stripe sous Linux sans gestionnaire de paquets&nbsp;:

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

#### Windows

Pour installer l’interface de ligne de commande de Stripe sous Windows sans Scoop&nbsp;:

1. Téléchargez la dernière version du fichier `windows` zip à partir de [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Décompressez le fichier `stripe_X.X.X_windows_x86_64.zip`.
1. Ajoutez le chemin vers le fichier `stripe.exe` décompressé à votre variable d’environnement `Path`. Pour découvrir comment mettre à jour les variables d’environnement, consultez la [documentation de 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 antivirus de Windows indiquent parfois que l’interface de ligne de commande n’est pas sécurisée. Il s’agit probablement d’un faux positif. Pour en savoir plus, consultez le [problème&nbsp;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&nbsp;:

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

### M’authentifier

Connectez-vous et authentifiez votre [compte utilisateur Stripe](https://docs.stripe.com/get-started/account/activate.md) afin de générer un jeu de clés limitées. Pour en savoir plus, consultez la documentation relative aux [clés de l’interface de ligne de commande Stripe et aux autorisations](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 de réponse. Enregistrez-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, appelez l’API de [création de prix](https://docs.stripe.com/api/prices/create.md) pour joindre un prix de 30&nbsp;USD. Remplacez l’espace réservé dans `product` par votre identifiant de 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 la trousse SDK Node.js côté serveur

///v20.4.0 est la dernière version du SDK côté serveur Node.js de Stripe. Elle prend en charge les versions de 12 et supérieures de Node.js.

///Vérifier votre version Node&nbsp;:

```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&nbsp;:

```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&nbsp;:

```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": "^20.4.0"
  }
}
```

### Autres possibilités d'installation

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

```bash
yarn add stripe
```

## Exécutez votre première demande de SDK

Maintenant que vous avez installé la trousse SDK Node.js, vous pouvez créer un abonnement [Produit](https://docs.stripe.com/api/products/create.md) et joindre un [Prix](https://docs.stripe.com/api/prices/create.md) avec quelques requêtes API. La trousse SDK Node.js renvoie des [promesses](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) qui peuvent être utilisées comme rappels dans un enchaînement. Dans cet exemple, nous utilisons l’ID du produit renvoyé dans la réponse du produit pour créer le prix.

> Cet exemple utilise les clés par défaut de votre [compte](https://docs.stripe.com/get-started/account/activate.md) utilisateur Stripe pour votre environnement de *bac à sable* (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). Personne d’autre que vous ne peut voir ces valeurs.

#### Créez un produit et un tarif

```node
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`. De la ligne de commande, `cd` vers le répertoire contenant le fichier que vous venez d’enregistrer et exécutez&nbsp;:

#### create_price.js

```bash
node create_price.js
```

Si tout a 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

Ceci conclut le démarrage rapide. Cliquez sur les liens ci-dessous pour découvrir différentes façons de traiter un paiement pour le produit que vous venez de créer.

- [Créez un lien de paiement](https://docs.stripe.com/payment-links.md)
- [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)


# PHP

> This is a PHP for when lang is php. View the full page at https://docs.stripe.com/get-started/development-environment?lang=php.

Dans ce démarrage rapide, vous installez [l’interface de ligne de commande Stripe](https://docs.stripe.com/stripe-cli.md)&nbsp;: un outil essentiel qui vous permet d’accéder à une ligne de commande de votre intégration Stripe. Vous installez également la [trousse de développement logiciel (SDK) côté serveur Stripe&nbsp;PHP pour accéder aux API](https://github.com/stripe/stripe-php) Stripe à partir des applications écrites dans PHP.

## Ce que vous apprenez

Dans ce guide de démarrage rapide, vous apprendrez&nbsp;:

- Comment appeler des API Stripe sans écrire de ligne de code
- Comment gérer les dépendances tierces à l’aide de Composer
- Installation du dernier SDK Stripe PHP v19.4.0
- Comment envoyer votre première demande de SDK

## Configuration initiale

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

## Configurer l’interface de ligne de commande de 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 l’interface de ligne de commande.

#### homebrew

Pour installer l’interface de ligne de commande de Stripe avec [homebrew](https://brew.sh/), exécutez la commande suivante&nbsp;:

```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 solution alternative ou suivre les instructions de l’onglet Linux.

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

#### apt

> La version Debian conçue pour CLI est disponible sur JFrog à l’adresse https://packages.stripe.dev, qui n’est pas un domaine qui appartient à Stripe. Lorsque vous entrez cette adresse URL, elle vous redirige vers la liste d’archivage des versions Jfrog.

Pour installer l’interface de ligne de commande Stripe sur des distributions dérivées de Debian et Ubuntu&nbsp;:

1. Add Stripe CLI’s GPG key to the apt sources keyring:

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

1. Ajoutez le référentiel apt de l’interface de ligne de commande à la liste des sources apt&nbsp;:

```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&nbsp;:

```bash
sudo apt update
```

1. Installer l’interface de ligne de commande

```bash
sudo apt install stripe
```

#### yum

> Le RPM conçu pour CLI est disponible sur JFrog à l’adresse https://packages.stripe.dev, qui n’est pas un domaine appartenant à Stripe. Lorsque vous entrez cette URL, elle vous redirige vers la liste d’archivage des versions Jfrog.

Pour installer l’interface de ligne de commande Stripe sur des distributions dérivées de RPM&nbsp;:

1. Ajoutez le référentiel yum de l’interface de ligne de commande à la liste des sources yum&nbsp;:

```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. Installer l’interface de ligne de commande

```bash
sudo yum install stripe
```

#### Scoop

Pour installer l’interface de ligne de commande de Stripe avec [Scoop](https://scoop.sh/), exécutez la commande suivante&nbsp;:

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

```bash
scoop install stripe
```

#### macOS

Pour installer l’interface de ligne de commande de Stripe sous macOS sans homebrew&nbsp;:

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).
1. Décompressez le fichier `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.

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

#### Linux

Pour installer l’interface de ligne de commande de Stripe sous Linux sans gestionnaire de paquets&nbsp;:

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

#### Windows

Pour installer l’interface de ligne de commande de Stripe sous Windows sans Scoop&nbsp;:

1. Téléchargez la dernière version du fichier `windows` zip à partir de [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Décompressez le fichier `stripe_X.X.X_windows_x86_64.zip`.
1. Ajoutez le chemin vers le fichier `stripe.exe` décompressé à votre variable d’environnement `Path`. Pour découvrir comment mettre à jour les variables d’environnement, consultez la [documentation de 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 antivirus de Windows indiquent parfois que l’interface de ligne de commande n’est pas sécurisée. Il s’agit probablement d’un faux positif. Pour en savoir plus, consultez le [problème&nbsp;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&nbsp;:

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

### M’authentifier

Connectez-vous et authentifiez votre [compte utilisateur Stripe](https://docs.stripe.com/get-started/account/activate.md) afin de générer un jeu de clés limitées. Pour en savoir plus, consultez la documentation relative aux [clés de l’interface de ligne de commande Stripe et aux autorisations](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 de réponse. Enregistrez-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, appelez l’API de [création de prix](https://docs.stripe.com/api/prices/create.md) pour joindre un prix de 30&nbsp;USD. Remplacez l’espace réservé dans `product` par votre identifiant de 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"
}
```

## Gérer les dépendances tierces

Nous vous recommandons de gérer les dépendances tierces issues de [Packagist](https://packagist.org/) à l’aide de [Composer](https://getcomposer.org/download/), ce qui vous permet d’ajouter de nouvelles bibliothèques et de les inclure dans vos projets PHP.

### Installer Composer

Depuis la ligne de commande et à l’aide des instructions, [téléchargez Composer](https://getcomposer.org/download/).

## Installer la trousse SDK PHP côté serveur

///v19.4.0 est la dernière version du SDK côté serveur de PHP de Stripe. Elle prend en charge les versions 5.6.0 et supérieures de PHP.

///Vérifier votre version PHP&nbsp;:

```bash
php --version
```

### Installer la bibliothèque

Installez la bibliothèque avec [Composer](http://getcomposer.org/), un gestionnaire de paquets pour PHP&nbsp;:

```bash
composer require stripe/stripe-php
```

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

```json
{
    "require": {
        "stripe/stripe-php": "^19.4.0"
    }
}
```

Pour vous servir des liaisons, utilisez le [chargement automatique](https://getcomposer.org/doc/01-basic-usage.md#autoloading) de Composer. Par exemple&nbsp;:

```php
require_once('vendor/autoload.php');
```

### Autres possibilités d'installation

**Installation manuelle**

Vous pouvez [télécharger la version la plus récente](https://github.com/stripe/stripe-php/releases) pour utiliser les liaisons, et inclure ensuite le fichier init.php&nbsp;:

```php
require_once('/path/to/stripe-php/init.php');
```

Ensuite, ajoutez les extensions suivantes&nbsp;: [cURL](https://secure.php.net/manual/en/book.curl.php) (ou éventuellement, utilisez votre propre curl autre que client) [json](https://secure.php.net/manual/en/book.json.php) [mbstring](https://secure.php.net/manual/en/book.mbstring.php)

## Exécutez votre première demande de SDK

Maintenant que vous avez installé la trousse SDK PHP, vous pouvez créer un abonnement [Produit](https://docs.stripe.com/api/products/create.md) et joindre un [Prix](https://docs.stripe.com/api/prices/create.md) avec quelques requêtes API. Dans cet exemple, nous utilisons l’ID du produit renvoyé dans la réponse pour créer le prix.

> Cet exemple utilise les clés par défaut de votre [compte](https://docs.stripe.com/get-started/account/activate.md) utilisateur Stripe pour votre environnement de *bac à sable* (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). Personne d’autre que vous ne peut voir ces valeurs.

#### Créez un produit et un tarif

```php
<?php
require_once('vendor/autoload.php');

$stripe = new \Stripe\StripeClient("sk_test_BQokikJOvBiI2HlWgH4olfQ2");

$product = $stripe->products->create([
  'name' => 'Starter Subscription',
  'description' => '$12/Month subscription',
]);
echo "Success! Here is your starter subscription product id: " . $product->id . "\n";

$price = $stripe->prices->create([
  'unit_amount' => 1200,
  'currency' => 'usd',
  'recurring' => ['interval' => 'month'],
  'product' => $product['id'],
]);
echo "Success! Here is your starter subscription price id: " . $price->id . "\n";

?>
```

Enregistrez le fichier sous `create_price.php`. De la ligne de commande, `cd` vers le répertoire contenant le fichier que vous venez d’enregistrer et exécutez&nbsp;:

#### create_price.php

```bash
php create_price.php

```

Si tout a 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: price_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```

## See also

Ceci conclut le démarrage rapide. Cliquez sur les liens ci-dessous pour découvrir différentes façons de traiter un paiement pour le produit que vous venez de créer.

- [Créez un lien de paiement](https://docs.stripe.com/payment-links.md)
- [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)


# .NET

> This is a .NET for when lang is dotnet. View the full page at https://docs.stripe.com/get-started/development-environment?lang=dotnet.

Dans ce démarrage rapide, vous installez [l’interface de ligne de commande Stripe](https://docs.stripe.com/stripe-cli.md)&nbsp;: un outil essentiel qui vous permet d’accéder à une ligne de commande de votre intégration Stripe. Vous installez également la [trousse de développement logiciel (SDK) côté serveur Stripe&nbsp;.NET pour accéder aux API](https://github.com/stripe/stripe-dotnet) Stripe à partir des applications écrites dans C#.

## Ce que vous apprenez

Dans ce guide de démarrage rapide, vous apprendrez&nbsp;:

- Comment appeler des API Stripe sans écrire de ligne de code
- Comment gérer les dépendances tierces à l’aide de l’interface de ligne de commande .NET Core, de l’interface de ligne de commande NuGet ou de la console Package Manager
- Installation de la dernière trousse SDK Stripe .NET v50.4.0
- Comment envoyer votre première demande de SDK

## Configuration initiale

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

## Configurer l’interface de ligne de commande de 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 l’interface de ligne de commande.

#### homebrew

Pour installer l’interface de ligne de commande de Stripe avec [homebrew](https://brew.sh/), exécutez la commande suivante&nbsp;:

```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 solution alternative ou suivre les instructions de l’onglet Linux.

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

#### apt

> La version Debian conçue pour CLI est disponible sur JFrog à l’adresse https://packages.stripe.dev, qui n’est pas un domaine qui appartient à Stripe. Lorsque vous entrez cette adresse URL, elle vous redirige vers la liste d’archivage des versions Jfrog.

Pour installer l’interface de ligne de commande Stripe sur des distributions dérivées de Debian et Ubuntu&nbsp;:

1. Add Stripe CLI’s GPG key to the apt sources keyring:

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

1. Ajoutez le référentiel apt de l’interface de ligne de commande à la liste des sources apt&nbsp;:

```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&nbsp;:

```bash
sudo apt update
```

1. Installer l’interface de ligne de commande

```bash
sudo apt install stripe
```

#### yum

> Le RPM conçu pour CLI est disponible sur JFrog à l’adresse https://packages.stripe.dev, qui n’est pas un domaine appartenant à Stripe. Lorsque vous entrez cette URL, elle vous redirige vers la liste d’archivage des versions Jfrog.

Pour installer l’interface de ligne de commande Stripe sur des distributions dérivées de RPM&nbsp;:

1. Ajoutez le référentiel yum de l’interface de ligne de commande à la liste des sources yum&nbsp;:

```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. Installer l’interface de ligne de commande

```bash
sudo yum install stripe
```

#### Scoop

Pour installer l’interface de ligne de commande de Stripe avec [Scoop](https://scoop.sh/), exécutez la commande suivante&nbsp;:

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

```bash
scoop install stripe
```

#### macOS

Pour installer l’interface de ligne de commande de Stripe sous macOS sans homebrew&nbsp;:

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).
1. Décompressez le fichier `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.

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

#### Linux

Pour installer l’interface de ligne de commande de Stripe sous Linux sans gestionnaire de paquets&nbsp;:

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

#### Windows

Pour installer l’interface de ligne de commande de Stripe sous Windows sans Scoop&nbsp;:

1. Téléchargez la dernière version du fichier `windows` zip à partir de [GitHub](https://github.com/stripe/stripe-cli/releases/latest).
1. Décompressez le fichier `stripe_X.X.X_windows_x86_64.zip`.
1. Ajoutez le chemin vers le fichier `stripe.exe` décompressé à votre variable d’environnement `Path`. Pour découvrir comment mettre à jour les variables d’environnement, consultez la [documentation de 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 antivirus de Windows indiquent parfois que l’interface de ligne de commande n’est pas sécurisée. Il s’agit probablement d’un faux positif. Pour en savoir plus, consultez le [problème&nbsp;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&nbsp;:

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

### M’authentifier

Connectez-vous et authentifiez votre [compte utilisateur Stripe](https://docs.stripe.com/get-started/account/activate.md) afin de générer un jeu de clés limitées. Pour en savoir plus, consultez la documentation relative aux [clés de l’interface de ligne de commande Stripe et aux autorisations](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 de réponse. Enregistrez-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, appelez l’API de [création de prix](https://docs.stripe.com/api/prices/create.md) pour joindre un prix de 30&nbsp;USD. Remplacez l’espace réservé dans `product` par votre identifiant de 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 la trousse SDK .NET côté serveur

v50.4.0 est la dernière version du SDK côté serveur de .NET de Stripe. Elle prend en charge .NET Standard 2.0+, .NET Core 2.0+ et .NET Framework 4.6.1+.

Vérifiez la version de votre [.NET SDK](https://docs.microsoft.com/en-us/dotnet/core/install/how-to-detect-installed-versions)&nbsp;:

```bash
dotnet --list-sdks
```

### Installer la bibliothèque

Utilisez l’[interface de ligne de commande .NET (CLI)](https://docs.microsoft.com/en-us/dotnet/core/tools/) pour créer un nouveau projet à partir de la ligne de commande&nbsp;:

```bash
dotnet new console
```

Pour installer la bibliothèque, exécutez cette commande pour ajouter la référence du paquet au fichier de projet (`.csproj`)&nbsp;:

```bash
dotnet add package Stripe.net
```

Une fois que vous avez installé la bibliothèque avec l’interface de ligne de commande, celle-ci est ajoutée automatiquement en tant que dépendance dans votre fichier de projet `.csproj`. Par exemple&nbsp;:

```xml
<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net6.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Stripe.net" Version="50.4.0" />
  </ItemGroup>

</Project>
```

### Autres possibilités d'installation

**Interface de ligne de commande NuGet (CLI)**&nbsp;: Vous pouvez utiliser le [CLI NuGet](https://docs.microsoft.com/en-us/nuget/tools/nuget-exe-cli-reference) pour installer la bibliothèque&nbsp;:

```bash
nuget install Stripe.net
```

**Console du gestionnaire de paquets (PowerShell)**&nbsp;: Si vous utilisez la [console du gestionnaire de paquets (PowerShell)](https://docs.microsoft.com/en-us/nuget/tools/package-manager-console), exécutez la commande suivante pour installer la bibliothèque&nbsp;:

```PowerShell
Install-Package Stripe.net
```

**VisualStudio**&nbsp;: Pour ajouter le progiciel Stripe.net à Visual Studio&nbsp;: Ouvrez l’explorateur de solutions. Faites un clic droit sur votre projet. Cliquez sur **Gérer les paquets NuGet**. Cliquez sur l’onglet **Parcourir** et recherchez **Stripe.net**. Cliquez sur le paquet **Stripe.net**, sélectionnez la version appropriée dans l’onglet et cliquez sur **Installer**.

## Exécutez votre première demande de SDK

Maintenant que vous avez installé la trousse SDK .NET, vous pouvez créer un abonnement [Produit](https://docs.stripe.com/api/products/create.md) et joindre un [Prix](https://docs.stripe.com/api/prices/create.md) avec quelques requêtes API. Dans cet exemple, nous utilisons l’ID du produit renvoyé dans la réponse pour créer le prix.

> Cet exemple utilise les clés par défaut de votre [compte](https://docs.stripe.com/get-started/account/activate.md) utilisateur Stripe pour votre environnement de *bac à sable* (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). Personne d’autre que vous ne peut voir ces valeurs.

#### Créez un produit et un tarif

```dotnet
using System;
using Stripe;

class Program
{
  static void Main(string[] args)
  {
    var client = new StripeClient("sk_test_BQokikJOvBiI2HlWgH4olfQ2");

    var optionsProduct = new ProductCreateOptions
    {
      Name = "Starter Subscription",
      Description = "$12/Month subscription",
    };
    Product product = client.V1.Products.Create(optionsProduct);
    Console.Write("Success! Here is your starter subscription product id: {0}\n", product.Id);

    var optionsPrice = new PriceCreateOptions
    {
      UnitAmount = 1200,
      Currency = "usd",
      Recurring = new PriceRecurringOptions
      {
          Interval = "month",
      },
      Product = product.Id
    };
    Price price = client.V1.Prices.Create(optionsPrice);
    Console.Write("Success! Here is your starter subscription price id: {0}\n", price.Id);
  }
}
```

Enregistrez le code dans le fichier `Program.cs` dans votre projet. De la ligne de commande, `cd` vers le répertoire contenant le fichier que vous venez d’enregistrer et exécutez&nbsp;:

#### Program.cs

```bash
dotnet run
```

Si tout a 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

Ceci conclut le démarrage rapide. Cliquez sur les liens ci-dessous pour découvrir différentes façons de traiter un paiement pour le produit que vous venez de créer.

- [Créez un lien de paiement](https://docs.stripe.com/payment-links.md)
- [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)