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.
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 Ruby côté serveur de Stripe pour accéder aux API Stripe depuis les applications rédigées 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 v13.0.0 de Stripe
- Envoyer votre première requête SDK
Configurer l'interface de ligne de commande Stripe
Tout d’abord, créez un compte Stripe ou connectez-vous.
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
Connectez-vous et authentifiez votre d’utilisateur Stripe compte afin de générer un jeu de clés limitées. Pour en savoir plus, consultez la documentation consacrée aux autorisations et aux clés de la CLI Stripe.
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"
Gérer les dépendances tierces
Nous vous recommandons de gérer les dépendances tierces avec l’outil de ligne de commande RubyGems, 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
gem --version
Si vous obtenez gem: command not found
, téléchargez RubyGems depuis sa page de téléchargement.
Installer le SDK de Ruby côté serveur
v13.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 :
ruby -v
Installer la bibliothèque
Créez un fichier gem, puis installez-le à l’aide d’un bundler à partir de RubyGems.
Ajoutez la dernière version du gem Stripe à un projet :
bundle add stripe
Installez les fichiers gem requis à partir des sources spécifiées :
bundle install
Autres méthodes d'installation
Exécuter votre première requête SDK
Maintenant que le SDK de Ruby 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.
Note
require 'rubygems' require 'stripe' Stripe.api_key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc" 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_
. 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 :
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.
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.