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 Node.js côté serveur de Stripe pour accéder aux API Stripe depuis les applications rédigées en Node.js.
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 du gestionnaire de paquets npm ou Yarn
- Installer le dernier SDK Node v17.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
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"
Installer le SDK de Node.js côté serveur
v17.0.0 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 :
node --version
Initialiser Node
npm init
Installer la bibliothèque
Installez la bibliothèque avec npm, un gestionnaire de paquets pour Node :
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 :
{ "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": "^17.0.0" } }
Autres méthodes d'installation
Exécuter votre première requête SDK
Maintenant que le SDK de Node.js est installé, vous pouvez créer un abonnement Produit et associer un tarif avec deux requêtes API. Le SDK de Node.js renvoie des promesses 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.
Note
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc'); 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_
. 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 :
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.
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.