# Configurer votre environnement de développement

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

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

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

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

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

# 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 guide de démarrage rapide, vous installerez la [Stripe CLI](https://docs.stripe.com/stripe-cli.md), un outil essentiel qui vous donne accès à votre intégration Stripe depuis la ligne de commande. Vous installerez également le [SDK Stripe Ruby côté serveur](https://github.com/stripe/stripe-ruby) pour accéder aux API Stripe depuis des applications écrites en Ruby.

## Objectifs d’apprentissage

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

- Appeler les API Stripe sans avoir à écrire une ligne de code
- Gérer les dépendances tierces à l’aide d’un bundler avec RubyGems
- Installer le dernier SDK Ruby v19.0.0 de Stripe
- Envoyer votre première requête SDK

## Configuration initiale

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

## Configurer l'interface de ligne de commande Stripe

Tout d’abord, [créez un compte Stripe](https://dashboard.stripe.com/register) ou [connectez-vous](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 la CLI.

#### homebrew

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

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

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

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

#### apt

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

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

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

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

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

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

1. Mettez à jour la liste des paquets :

```bash
sudo apt update
```

1. Installez la CLI :

```bash
sudo apt install stripe
```

#### yum

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

Pour installer la CLI Stripe sur des distributions RPM :

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

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

1. Installez la CLI :

```bash
sudo yum install stripe
```

#### Scoop

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

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

```bash
scoop install stripe
```

#### macOS

Pour installer la CLI Stripe sous macOS sans homebrew :

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

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

#### Linux

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

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

#### Windows

Pour installer la CLI Stripe sous Windows sans Scoop :

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

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

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

#### Docker

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

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

### S’identifier

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

```bash
  stripe login
```

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

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

### Confirmer la configuration

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

#### bash

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

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

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

#### bash

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

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

#### bash

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

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

#### bash

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

## Gérer les dépendances tierces

Nous vous recommandons de gérer les dépendances tierces avec 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 que 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 de Ruby côté serveur

v19.0.0 est la dernière version du SDK Stripe Ruby côté serveur. Elle prend en charge les versions 2.3 et ultérieures de Ruby.

Vérifiez votre version Ruby :

```bash
ruby -v
```

### Installer la bibliothèque

[Créez un fichier gem](https://guides.rubygems.org/make-your-own-gem/), puis installez-le à l’aide d’un bundler à partir de [RubyGems](https://rubygems.org/).

Ajoutez la dernière version du [gem Stripe](https://rubygems.org/gems/stripe) à un projet :

```bash
bundle add stripe
```

Installez les fichiers gem requis à partir des sources spécifiées :

```bash
bundle install
```

### Autres méthodes d'installation

**Ajouter en tant que dépendance** : ajoutez la dernière version de la bibliothèque en tant que dépendance gem :

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

gem 'rails'
gem 'stripe'
```

**Installation globale** : installez la bibliothèque de manière globale avec [RubyGems](https://rubygems.org/) :

```bash
gem install stripe
```

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

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

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

Maintenant que le SDK de Ruby est installé, vous pouvez créer un abonnement [Produit](https://docs.stripe.com/api/products/create.md) et associer un [tarif](https://docs.stripe.com/api/prices/create.md) avec deux requêtes API. Nous utilisons l’identifiant du produit renvoyé dans la réponse pour créer le tarif dans cet exemple.

> Cet exemple utilise les clés par défaut de votre [compte](https://docs.stripe.com/get-started/account/activate.md) d’utilisateur Stripe pour votre *environnement de test* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Personne d’autre que vous ne peut voir ces valeurs.

#### Créer 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`. Depuis la ligne de commande, utilisez la commande `cd` pour pointer vers le répertoire contenant le fichier que vous venez d’enregistrer, puis exécutez ce qui suit :

#### create_price.rb

```bash
ruby create_price.rb
```

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

#### bash

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

## See also

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

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


# 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 guide de démarrage rapide, vous installerez la [Stripe CLI](https://docs.stripe.com/stripe-cli.md), un outil essentiel qui vous donne accès à votre intégration Stripe depuis la ligne de commande. Vous installerez également le [SDK Stripe Python côté serveur](https://github.com/stripe/stripe-python) pour accéder aux API Stripe depuis des applications écrites en Python.

## Objectifs d’apprentissage

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

- Appeler les API Stripe sans avoir à écrire une ligne de code
- Gérer les dépendances tierces à l’aide d’un environnement virtuel et du gestionnaire de paquets pip
- Installer le dernier SDK Python v15.0.0 de Stripe
- Envoyer votre première requête SDK

## Configuration initiale

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

## Configurer l'interface de ligne de commande Stripe

### Installer

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

#### homebrew

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

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

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

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

#### apt

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

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

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

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

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

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

1. Mettez à jour la liste des paquets :

```bash
sudo apt update
```

1. Installez la CLI :

```bash
sudo apt install stripe
```

#### yum

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

Pour installer la CLI Stripe sur des distributions RPM :

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

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

1. Installez la CLI :

```bash
sudo yum install stripe
```

#### Scoop

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

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

```bash
scoop install stripe
```

#### macOS

Pour installer la CLI Stripe sous macOS sans homebrew :

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

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

#### Linux

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

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

#### Windows

Pour installer la CLI Stripe sous Windows sans Scoop :

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

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

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

#### Docker

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

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

### S’identifier

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

```bash
  stripe login
```

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

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

### Confirmer la configuration

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

#### bash

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

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

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

#### bash

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

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

#### bash

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

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

#### bash

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

## Gérer les dépendances tierces

Nous vous recommandons de gérer les dépendances tierces en utilisant le 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.

### Sous Windows (cmd.exe) :

#### Sous Windows (cmd.exe)

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

### Sous GNU, Linux ou MacOS (Bash) :

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

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

## Installer le SDK de Python côté serveur

v15.0.0 est la dernière version du SDK Stripe Python côté serveur. Elle prend en charge les versions 3.6 et ultérieures de Python.

Vérifiez 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
```

Spécifiez ensuite la version suivante dans votre fichier requirements.txt :

```txt
stripe>=15.0.0
```

### Autres méthodes d'installation

**Installation manuelle** : [téléchargez le code source](https://github.com/stripe/stripe-python) du SDK, puis installez la bibliothèque en exécutant :

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

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

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

> Cet exemple utilise les clés par défaut de votre [compte](https://docs.stripe.com/get-started/account/activate.md) d’utilisateur Stripe pour votre *environnement de test* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Personne d’autre que vous ne peut voir ces valeurs.

#### Créer 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`. Depuis la ligne de commande, utilisez la commande `cd` pour pointer vers le répertoire contenant le fichier que vous venez d’enregistrer, puis exécutez ce qui suit :

#### create_price.py

```bash
python3 create_price.py
```

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

#### bash

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

## See also

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

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


# 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 guide de démarrage rapide, vous installerez la [Stripe CLI](https://docs.stripe.com/stripe-cli.md), un outil essentiel qui vous donne accès à votre intégration Stripe depuis la ligne de commande. Vous installerez également le [SDK Stripe Go côté serveur](https://github.com/stripe/stripe-go) pour accéder aux API Stripe depuis des applications écrites en Go.

## Objectifs d’apprentissage

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

- Appeler les API Stripe sans avoir à écrire une ligne de code
- Gérer les dépendances tierces à l’aide des modules Go
- Installer le dernier SDK Go v85.0.0 de Stripe
- Envoyer votre première requête SDK

## Configuration initiale

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

## Configurer l'interface de ligne de commande Stripe

### Installer

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

#### homebrew

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

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

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

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

#### apt

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

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

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

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

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

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

1. Mettez à jour la liste des paquets :

```bash
sudo apt update
```

1. Installez la CLI :

```bash
sudo apt install stripe
```

#### yum

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

Pour installer la CLI Stripe sur des distributions RPM :

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

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

1. Installez la CLI :

```bash
sudo yum install stripe
```

#### Scoop

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

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

```bash
scoop install stripe
```

#### macOS

Pour installer la CLI Stripe sous macOS sans homebrew :

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

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

#### Linux

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

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

#### Windows

Pour installer la CLI Stripe sous Windows sans Scoop :

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

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

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

#### Docker

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

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

### S’identifier

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

```bash
  stripe login
```

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

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

### Confirmer la configuration

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

#### bash

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

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

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

#### bash

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

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

#### bash

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

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

#### bash

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

## Gérer les dépendances tierces

Nous vous recommandons de gérer les dépendances tierces en utilisant 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.

### Initialiser Go

Si vous partez 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 :

#### Initialiser Go

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

## Installer le SDK de Go côté serveur

v85.0.0 est la dernière version du SDK Stripe Go côté serveur. Elle prend en charge les versions Go 1.15+.

### Installer la bibliothèque

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

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

Une fois que vous avez installé la bibliothèque avec les modules Go dans 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/v85 85.0.0 // indirect
```

### Synchroniser les dépendances

Pour bien ordonner votre ensemble de dépendances gérées en vue d’un projet *existant*, exécutez la commande suivante afin de [synchroniser les dépendances de votre code](https://go.dev/doc/modules/managing-dependencies).

```bash
go mod tidy
```

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

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

> Cet exemple utilise les clés par défaut de votre [compte](https://docs.stripe.com/get-started/account/activate.md) d’utilisateur Stripe pour votre *environnement de test* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Personne d’autre que vous ne peut voir ces valeurs.

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

```go
package main

import (
  "fmt"
  "github.com/stripe/stripe-go/v85"
  "github.com/stripe/stripe-go/v85/product"
  "github.com/stripe/stripe-go/v85/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`. Depuis la ligne de commande, utilisez la commande `cd` pour pointer vers le répertoire contenant le fichier que vous venez d’enregistrer, puis exécutez ce qui suit :

#### create_price.rb

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

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

#### bash

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

## See also

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

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


# 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 guide de démarrage rapide, vous installerez la [Stripe CLI](https://docs.stripe.com/stripe-cli.md), un outil essentiel qui vous donne accès à votre intégration Stripe depuis la ligne de commande. Vous installerez également le [SDK Stripe Java côté serveur](https://github.com/stripe/stripe-java) pour accéder aux API Stripe depuis des applications écrites en Java.

## Objectifs d’apprentissage

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

- Appeler les API Stripe sans avoir à écrire une ligne de code
- Gérer les dépendances tierces à l’aide de Maven ou Gradle
- Installer le dernier SDK Java v32.0.0 de Stripe
- Envoyer votre première requête SDK

## Configuration initiale

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

## Configurer l'interface de ligne de commande Stripe

### Installer

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

#### homebrew

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

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

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

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

#### apt

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

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

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

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

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

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

1. Mettez à jour la liste des paquets :

```bash
sudo apt update
```

1. Installez la CLI :

```bash
sudo apt install stripe
```

#### yum

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

Pour installer la CLI Stripe sur des distributions RPM :

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

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

1. Installez la CLI :

```bash
sudo yum install stripe
```

#### Scoop

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

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

```bash
scoop install stripe
```

#### macOS

Pour installer la CLI Stripe sous macOS sans homebrew :

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

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

#### Linux

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

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

#### Windows

Pour installer la CLI Stripe sous Windows sans Scoop :

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

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

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

#### Docker

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

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

### S’identifier

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

```bash
  stripe login
```

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

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

### Confirmer la configuration

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

#### bash

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

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

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

#### bash

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

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

#### bash

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

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

#### bash

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

## 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 de [Gradle](https://docs.gradle.org), ce qui vous permet d’ajouter de nouvelles bibliothèques et de les inclure dans vos projets Java en toute simplicité.

### Initialiser un projet

- Pour créer un projet avec **Maven**, consultez 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**, consultez l’[exemple de développement d’applications Java](https://docs.gradle.org/current/samples/sample_building_java_applications.html).

## Installer le SDK de Java côté serveur

v32.0.0 est la dernière version du SDK Stripe Java côté serveur. Elle prend en charge les versions 1.8 et ultérieures de Java.

Vérifiez votre version Java :

```bash
java -version
```

### Installer la bibliothèque

- Si vous utilisez **Maven**, ajoutez les éléments suivants dans le fichier pom.xml de votre projet :

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

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

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

### Autres méthodes d'installation

**Installation manuelle**&nbsp;: vous pouvez installer stripe-java manuellement à l’aide des JAR suivants. [Téléchargez le JAR 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, pensez à exclure la bibliothèque en ajoutant les éléments suivants à votre fichier `proguard.cfg`&nbsp;:

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

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

Maintenant que le SDK de Java est installé, vous pouvez créer un abonnement [Produit](https://docs.stripe.com/api/products/create.md) et associer un [tarif](https://docs.stripe.com/api/prices/create.md) avec deux requêtes API. Nous utilisons l’identifiant du produit renvoyé dans la réponse pour créer le tarif dans cet exemple.

> Cet exemple utilise les clés par défaut de votre [compte](https://docs.stripe.com/get-started/account/activate.md) d’utilisateur Stripe pour votre *environnement de test* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Personne d’autre que vous ne peut voir ces valeurs.

#### Créer 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 depuis votre environnement de développement intégré pour Maven ou Gradle. Par exemple&nbsp;: `Run 'CreatePrice.main()'`.

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

#### bash

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

## See also

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

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


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

## Objectifs d’apprentissage

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

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

## Configuration initiale

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

## Configurer l'interface de ligne de commande Stripe

### Installer

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

#### homebrew

Pour installer la CLI Stripe avec [homebrew](https://brew.sh/), exécutez la commande suivante&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 alternative ou suivre les instructions de l’onglet Linux.

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

#### apt

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

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

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

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

1. Ajoutez le référentiel apt de la CLI à la liste des sources apt&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. Installez la CLI&nbsp;:

```bash
sudo apt install stripe
```

#### yum

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

Pour installer la CLI Stripe sur des distributions RPM&nbsp;:

1. Ajoutez le référentiel yum de la CLI à 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. Installez la CLI&nbsp;:

```bash
sudo yum install stripe
```

#### Scoop

Pour installer la CLI 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 la CLI 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&nbsp;: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.

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

#### Linux

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

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

#### Windows

Pour installer la CLI Stripe sous Windows sans Scoop&nbsp;:

1. Téléchargez la dernière version du fichier zip `windows` sur [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 d’accès au fichier `stripe.exe` décompressé à votre variable d’environnement `Path`. Pour découvrir comment mettre à jour les variables d’environnement, consultez la [documentation Microsoft PowerShell](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.3#saving-changes-to-environment-variables).

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

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

#### Docker

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

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

### S’identifier

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

```bash
  stripe login
```

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

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

### Confirmer la configuration

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

#### bash

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

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

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

#### bash

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

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

#### bash

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

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

#### bash

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

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

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

Vérifiez votre version Node&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": "^21.0.1"
  }
}
```

### Autres méthodes 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écuter votre première requête SDK

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

> Cet exemple utilise les clés par défaut de votre [compte](https://docs.stripe.com/get-started/account/activate.md) d’utilisateur Stripe pour votre *environnement de test* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Personne d’autre que vous ne peut voir ces valeurs.

#### Créer 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`. Depuis la ligne de commande, utilisez la commande `cd` pour pointer vers le répertoire contenant le fichier que vous venez d’enregistrer, puis exécutez ce qui suit&nbsp;:

#### create_price.js

```bash
node create_price.js
```

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

#### bash

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

## See also

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

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


# 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 guide de démarrage rapide, vous installerez la [Stripe CLI](https://docs.stripe.com/stripe-cli.md), un outil essentiel qui vous donne accès à votre intégration Stripe depuis la ligne de commande. Vous installerez également le [SDK Stripe PHP côté serveur](https://github.com/stripe/stripe-php) pour accéder aux API Stripe depuis des applications écrites en PHP.

## Objectifs d’apprentissage

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

- Appeler les API Stripe sans avoir à écrire une ligne de code
- Gérer les dépendances tierces à l’aide de Composer
- Installer le dernier SDK PHP v20.0.0 de Stripe
- Envoyer votre première requête SDK

## Configuration initiale

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

## Configurer l'interface de ligne de commande Stripe

### Installer

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

#### homebrew

Pour installer la CLI Stripe avec [homebrew](https://brew.sh/), exécutez la commande suivante&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 alternative ou suivre les instructions de l’onglet Linux.

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

#### apt

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

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

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

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

1. Ajoutez le référentiel apt de la CLI à la liste des sources apt&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. Installez la CLI&nbsp;:

```bash
sudo apt install stripe
```

#### yum

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

Pour installer la CLI Stripe sur des distributions RPM&nbsp;:

1. Ajoutez le référentiel yum de la CLI à 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. Installez la CLI&nbsp;:

```bash
sudo yum install stripe
```

#### Scoop

Pour installer la CLI 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 la CLI 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&nbsp;: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.

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

#### Linux

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

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

#### Windows

Pour installer la CLI Stripe sous Windows sans Scoop&nbsp;:

1. Téléchargez la dernière version du fichier zip `windows` sur [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 d’accès au fichier `stripe.exe` décompressé à votre variable d’environnement `Path`. Pour découvrir comment mettre à jour les variables d’environnement, consultez la [documentation Microsoft PowerShell](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.3#saving-changes-to-environment-variables).

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

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

#### Docker

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

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

### S’identifier

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

```bash
  stripe login
```

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

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

### Confirmer la configuration

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

#### bash

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

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

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

#### bash

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

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

#### bash

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

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

#### bash

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

## Gérer les dépendances tierces

Nous vous recommandons de gérer les dépendances tierces issues de [Packagist](https://packagist.org/) en utilisant [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, [téléchargez Composer](https://getcomposer.org/download/) en suivant les instructions.

## Installer le SDK de PHP côté serveur

v20.0.0 est la dernière version du SDK Stripe PHP côté serveur. Elle prend en charge les versions 5.6.0 et ultérieures de PHP.

Vérifiez 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 automatiquement ajoutée en tant que dépendance dans le fichier composer.json de votre projet. Par exemple&nbsp;:

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

Pour utiliser les 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 méthodes d'installation

**Installation manuelle**

Vous pouvez [télécharger la dernière version en date](https://github.com/stripe/stripe-php/releases) pour utiliser les intégrations, puis inclure le fichier init.php&nbsp;:

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

Ajoutez ensuite les extensions suivantes&nbsp;: [cURL](https://secure.php.net/manual/en/book.curl.php) (vous pouvez aussi utiliser votre propre client non curl), [json](https://secure.php.net/manual/en/book.json.php), [mbstring](https://secure.php.net/manual/en/book.mbstring.php)

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

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

> Cet exemple utilise les clés par défaut de votre [compte](https://docs.stripe.com/get-started/account/activate.md) d’utilisateur Stripe pour votre *environnement de test* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Personne d’autre que vous ne peut voir ces valeurs.

#### Créer 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`. Depuis la ligne de commande, utilisez la commande `cd` pour pointer vers le répertoire contenant le fichier que vous venez d’enregistrer, puis exécutez ce qui suit&nbsp;:

#### create_price.php

```bash
php create_price.php

```

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

#### bash

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

## See also

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

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


# .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 guide de démarrage rapide, vous installerez la [Stripe CLI](https://docs.stripe.com/stripe-cli.md), un outil essentiel qui vous donne accès à votre intégration Stripe depuis la ligne de commande. Vous installerez également le [SDK Stripe .NET côté serveur](https://github.com/stripe/stripe-dotnet) pour accéder aux API Stripe depuis des applications écrites en C#.

## Objectifs d’apprentissage

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

- Appeler les API Stripe sans avoir à écrire une ligne de code
- Gérer les dépendances tierces à l’aide de la CLI .NET Core, la CLI NuGet ou la console du gestionnaire de paquets
- Installer le dernier SDK .NET v51.0.0 de Stripe
- Envoyer votre première requête SDK

## Configuration initiale

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

## Configurer l'interface de ligne de commande Stripe

### Installer

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

#### homebrew

Pour installer la CLI Stripe avec [homebrew](https://brew.sh/), exécutez la commande suivante&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 alternative ou suivre les instructions de l’onglet Linux.

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

#### apt

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

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

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

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

1. Ajoutez le référentiel apt de la CLI à la liste des sources apt&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. Installez la CLI&nbsp;:

```bash
sudo apt install stripe
```

#### yum

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

Pour installer la CLI Stripe sur des distributions RPM&nbsp;:

1. Ajoutez le référentiel yum de la CLI à 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. Installez la CLI&nbsp;:

```bash
sudo yum install stripe
```

#### Scoop

Pour installer la CLI 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 la CLI 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&nbsp;: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.

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

#### Linux

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

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

#### Windows

Pour installer la CLI Stripe sous Windows sans Scoop&nbsp;:

1. Téléchargez la dernière version du fichier zip `windows` sur [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 d’accès au fichier `stripe.exe` décompressé à votre variable d’environnement `Path`. Pour découvrir comment mettre à jour les variables d’environnement, consultez la [documentation Microsoft PowerShell](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.3#saving-changes-to-environment-variables).

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

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

#### Docker

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

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

### S’identifier

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

```bash
  stripe login
```

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

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

### Confirmer la configuration

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

#### bash

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

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

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

#### bash

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

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

#### bash

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

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

#### bash

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

## Installer le SDK .NET côté serveur

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

Vérifiez la version de votre [SDK .NET](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 Core](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 afin d’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 la CLI, 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="51.0.0" />
  </ItemGroup>

</Project>
```

### Autres méthodes d'installation

**Interface de ligne de commande NuGet**&nbsp;: vous pouvez aussi utiliser l’[interface 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 packages (PowerShell)**&nbsp;: si vous utilisez la [console du gestionnaire de packages (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 paquet Stripe.net à Visual Studio, ouvrez l’explorateur de solutions. Effectuez un clic droit sur votre projet, puis cliquez sur **Gérer les packages NuGet**. Cliquez sur l’onglet **Parcourir** et recherchez **Stripe.net**, puis cliquez sur le paquet **Stripe.net**. Sélectionnez ensuite la version appropriée dans l’onglet, et cliquez sur **Installer**.

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

Maintenant que le SDK .NET est installé, vous pouvez créer un abonnement [Produit](https://docs.stripe.com/api/products/create.md) et associer un [tarif](https://docs.stripe.com/api/prices/create.md) avec deux requêtes API. Nous utilisons l’identifiant du produit renvoyé dans la réponse pour créer le tarif dans cet exemple.

> Cet exemple utilise les clés par défaut de votre [compte](https://docs.stripe.com/get-started/account/activate.md) d’utilisateur Stripe pour votre *environnement de test* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Personne d’autre que vous ne peut voir ces valeurs.

#### Créer 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`de votre projet. Depuis la ligne de commande, utilisez la commande `cd` pour pointer vers le répertoire contenant le fichier que vous venez d’enregistrer, puis exécutez ce qui suit&nbsp;:

#### Program.cs

```bash
dotnet run
```

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

#### bash

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

## See also

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

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