Installer la Stripe CLI
Installez la Stripe CLI sur macOS, Windows ou Linux.
La Stripe CLI vous permet de créer, tester et gérer votre intégration depuis la ligne de commande. Vous pouvez utiliser la Stripe CLI pour :
- Inscrivez-vous et obtenez des clés API de test directement depuis le terminal, sans passer par un navigateur.
- Créez, récupérez, mettez à jour ou supprimez n’importe laquelle de vos ressources Stripe dans un environnement de test.
- Diffusez en temps réel les requêtes API et les événements qui se produisent dans votre compte.
- Déclenchez des événements pour tester votre intégration de webhooks.
Pour plus de détails, consultez la documentation de l’interface de ligne de commande (CLI) Stripe.
Installer l'interface de ligne de commande Stripe
Depuis 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.
Pour installer la CLI Stripe avec npm, exécutez :
npm i -g @stripe/cli
Démarrer sans compte
La commande sandbox create crée un nouvel environnement de test avec des clés API de test fonctionnelles, sans nécessiter de compte. Elle vous permet, ainsi qu’à un agent de code ou à un flux de travail automatisé, de commencer immédiatement à développer une intégration Stripe.
stripe sandbox create --email you@example.com
Remarque
Utilisez --from-git au lieu de --email <email> pour récupérer l’e-mail depuis votre configuration Git. Les agents et scripts automatisés doivent ajouter --non-interactive pour afficher la sortie sans attendre d’interaction.
Cela renvoie un environnement de test avec des clés API de test fonctionnelles :
Setting up your sandbox... done. { "secret_key": "rkcs_test_abc123", "publishable_key": "pk_test_def456", "claim_url": "https://dashboard.stripe.com/onboard_sandbox/0000000...", "account_id": "acct_ghi789", "expires_at": "2026-06-22" }
Vos identifiants temporaires d’environnement de test sont enregistrés dans votre profil d’interface de ligne de commande, ce qui permet aux autres commandes de fonctionner sans nécessiter de connexion.
Les environnements de test expirent après 7 jours. Vous pouvez transformer un environnement de test en compte Stripe complet avec la commande sandbox claim.
stripe sandbox claim
Si vous êtes déjà connecté, sandbox create ouvre la page de gestion des environnements de test dans votre Dashboard Stripe.
Se connecter à l'interface de ligne de commande
Connectez-vous et authentifiez votre compte utilisateur Stripe pour générer un ensemble de clés limitées. Pour en savoir plus, consultez la page Clés et autorisations de la Stripe CLI.
Command Linestripe loginAppuyez sur la touche Entrer de votre clavier pour accomplir le processus d’authentification dans votre navigateur.
OutputYour 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)
En option, si vous ne souhaitez pas utiliser de navigateur, utilisez l’option --interactive pour vous authentifier avec une clé secrète d’API ou une clé limitée existante. Ceci est utile pour s’authentifier à la CLI sans navigateur, par exemple dans un pipeline d’intégration et de déploiement continus (CI/CD).
stripe login --interactive
Vous pouvez également utiliser l’option --api-key pour spécifier votre clé secrète d’API en ligne à chaque fois que vous envoyez une requête.
stripe login --api-keysk_test_VePHdqKTYQjKNInc7u56JBrQ