Configurer votre environnement de développement
Familiarisez-vous avec l'interface de ligne de commande Stripe et nos SDK côté serveur.
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
We recommend you build your payment integration with Stripe (such as Elements or Checkout) on your own website. Then, set up your Chrome extension to send users to this payment page when they’re ready to complete a purchase.
Cette méthode est plus sécurisée et plus facile à gérer que le traitement direct des paiements dans l’extension.
Dans ce guide de démarrage rapide, vous allez installer l’interface de ligne de commande Stripe, un outil essentiel qui vous fournit un accès à votre intégration Stripe via une ligne de commande. Vous allez également installer le SDK .NET côté serveur de Stripe pour accéder aux API Stripe depuis les applications rédigées en C#.
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 la CLI .NET Core, la CLI NuGet ou la console du gestionnaire de paquets
- Installer le dernier SDK .NET v48.0.0 de Stripe
- Envoyer votre première requête SDK
Configuration initiale
Tout d’abord, créez un compte Stripe ou connectez-vous.
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.
S’identifier
Log in and authenticate your Stripe user Account to generate a set of restricted keys. To learn more, see Stripe CLI keys and permissions.
stripe login
Appuyez sur la touche Entrée de votre clavier pour effectuer le processus d’authentification dans votre navigateur.
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.
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.
{ "id":
, "object": "product","prod_LTenIrmp8Q67sa"
Ensuite, effectuez un appel de création de tarif pour associer un tarif de 30 USD. Remplacez le paramètre substituable contenu dans product
par l’identifiant de votre produit (par exemple, prod_
).
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.
{ "id":
, "object": "price","price_1KzlAMJJDeE9fu01WMJJr79o"
Installer le SDK .NET côté serveur
v48.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 :
dotnet --list-sdks
Installer la bibliothèque
Utilisez l’interface de ligne de commande .NET Core pour créer un nouveau projet à partir de la ligne de commande :
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 (.
) :
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 .
. Par exemple :
<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="48.0.0" /> </ItemGroup> </Project>
Autres méthodes d'installation
Exécuter votre première requête SDK
Maintenant que le SDK .NET est installé, vous pouvez créer un abonnement Produit et associer un tarif avec deux requêtes API. Nous utilisons l’identifiant du produit renvoyé dans la réponse pour créer le tarif dans cet exemple.
Remarque
Cet exemple utilise les clés par défaut de votre compte d’utilisateur Stripe pour votre environnement de test. Personne d’autre que vous ne peut voir ces valeurs.
using System; using Stripe; class Program { static void Main(string[] args) { StripeConfiguration.ApiKey = "sk_test_BQokikJOvBiI2HlWgH4olfQ2"; var optionsProduct = new ProductCreateOptions { Name = "Starter Subscription", Description = "$12/Month subscription", }; var serviceProduct = new ProductService(); Product product = serviceProduct.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 }; var servicePrice = new PriceService(); Price price = servicePrice.Create(optionsPrice); Console.Write("Success! Here is your starter subscription price id: {0}\n", price.Id); } }
Enregistrez le code dans le fichier Program.
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 :
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.
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6 Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
Voir aussi
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.