# Configurez l’environnement de développement

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

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

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

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

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

# Go


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

## Ce que vous apprenez

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

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

## Configuration initiale

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

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

### Installer

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

#### homebrew

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

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

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

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

#### apt

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

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

1. Ajouter la clé GPG de l’interface de ligne de commande Stripe au porte-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 l’interface de ligne de commande à la liste des sources apt :

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

1. Mettez à jour la liste des paquets :

```bash
sudo apt update
```

1. Installer l’interface de ligne de commande

```bash
sudo apt install stripe
```

#### yum

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

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

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

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

1. Installer l’interface de ligne de commande

```bash
sudo yum install stripe
```

#### Scoop

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

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

```bash
scoop install stripe
```

#### winget

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

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

#### macOS

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

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

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

#### Linux

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

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

#### Windows

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

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

> Les antivirus de Windows indiquent parfois que l’interface de ligne de commande n’est pas sécurisée. Il s’agit probablement d’un faux positif. Pour en savoir plus, consultez le [problème 692](https://github.com/stripe/stripe-cli/issues/692) dans le référentiel GitHub.

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

#### Docker

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

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

### M’authentifier

Connectez-vous et authentifiez votre [compte utilisateur Stripe](https://docs.stripe.com/get-started/account/set-up.md) afin de générer un jeu de clés limitées. Pour en savoir plus, consultez la documentation relative aux [clés de l’interface de ligne de commande Stripe et aux autorisations](https://docs.stripe.com/stripe-cli/keys.md).

```bash
  stripe login
```

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

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

### Confirmer la configuration

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

#### bash

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

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

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

#### bash

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

Ensuite, appelez l’API de [création de prix](https://docs.stripe.com/api/prices/create.md) pour joindre un prix de 30 USD. Remplacez l’espace réservé dans `product` par votre identifiant de produit (par exemple, `prod_LTenIrmp8Q67sa`).

#### bash

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

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

#### bash

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

## Gérer les dépendances tierces

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

### Initialisation de Go

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

#### Initialisation de Go

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

## Installer le SDK côté serveur Go

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

### Installer la bibliothèque

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

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

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

```go.mod
module stripe-example

go 1.18

require github.com/stripe/stripe-go/v85 85.2.0 // indirect
```

### Synchroniser les dépendances

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

```bash
go mod tidy
```

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

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

> #### 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 *bac à sable* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Vous seul pouvez 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éez un produit et un tarif

```go
package main

import (
  "context"
  "fmt"
  "github.com/stripe/stripe-go/v85"
)

func main() {
  // Don't embed any keys in production code. This is an example.
	// See https://docs.stripe.com/keys-best-practices.
  sc := stripe.NewClient("sk_test_BQokikJOvBiI2HlWgH4olfQ2")

	productParams := &stripe.ProductCreateParams{
		Name:        stripe.String("Starter Subscription"),
		Description: stripe.String("$12/Month subscription"),
	}
	starterProduct, _ := sc.V1Products.Create(context.TODO(), productParams)

	priceParams := &stripe.PriceCreateParams{
		Currency: stripe.String(stripe.CurrencyUSD),
		Product:  stripe.String(starterProduct.ID),
		Recurring: &stripe.PriceCreateRecurringParams{
			Interval: stripe.String(stripe.PriceRecurringIntervalMonth),
		},
		UnitAmount: stripe.Int64(1200),
	}
	starterPrice, _ := sc.V1Prices.Create(context.TODO(), priceParams)

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

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

#### create_price.rb

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

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

#### bash

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

## See also

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

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