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

# Python


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

## Configurer l'interface de ligne de commande Stripe

### Installez et connectez

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

```bash
npm install --global @stripe/cli
```

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

Après l’installation, connectez la CLI à votre compte Stripe en vous identifiant :

```bash
stripe login
```

La CLI affiche un code d’association et ouvre le Dashboard Stripe, où vous approuvez l’accès aux comptes, aux sandboxes et au mode production. La CLI stocke vos identifiants dans le magasin d’identifiants sécurisé de votre système d’exploitation (le cas échéant) et actualise la session automatiquement. Pour vous identifier avec une clé d’API à la place, exécutez `stripe login --interactive`, utilisez `stripe config`, transmettez `--api-key` ou définissez la variable d’environnement `STRIPE_API_KEY`.

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

> #### Appliquez les bonnes pratiques en matière de clés API.
> 
> Cet exemple utilise les clés par défaut de votre [compte](https://docs.stripe.com/get-started/account/set-up.md) utilisateur Stripe pour votre *environnement de test* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Vous êtes le seul à pouvoir voir ces valeurs. Suivez les [bonnes pratiques](https://docs.stripe.com/keys-best-practices.md) pour gérer vos clés en toute sécurité.

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

```python
import stripe

# Don't embed any keys in production code. This is an example.
# See https://docs.stripe.com/keys-best-practices.
client = stripe.StripeClient("sk_test_BQokikJOvBiI2HlWgH4olfQ2")

starter_subscription = client.v1.products.create(params={
  "name": "Starter Subscription",
  "description": "$12/Month subscription",
})

starter_subscription_price = client.v1.prices.create(params={
  "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.md)