Envoyer votre première requête à l'API Stripe

Ce guide vous explique comment effectuer une opération simple avec l’API Stripe : la création d’un client. Pour obtenir un aperçu plus complet des objets de l’API et de la manière dont ils fonctionnent entre eux, effectuez une visite guidée de l’API ou consultez la documentation de l’API. Si vous souhaitez commencer à accepter des paiements, consultez notre guide de démarrage rapide.

Vous pouvez commencer à explorer les API de Stripe en utilisant le Shell Stripe. Le Stripe Shell vous permet d’exécuter des commandes de l’interface de ligne de commande Stripe directement sur le site de documentation Stripe. Puisqu’il fonctionne uniquement en mode test, vous n’avez pas à craindre de créer des transactions réelles.

1. Pour créer un client à l’aide du Shell Stripe, saisissez la commande suivante :

   Command Line

   stripe customers create --email=jane.smith@email.com --name="Jane Smith" --description="My First Stripe Customer"

   Si tout a fonctionné correctement, la ligne de commande affiche la réponse suivante :

   {
     "id": 
   "cus_LfctGLAICpokzr",
     "object": 
   "customer",

   Afficher les 31 lignes

2. (Facultatif) Exécutez la même commande en transmettant votre clé API secrète pour le mode test :

   Command Line

   stripe customers create --email=jane.smith@email.com --name="Jane Smith" --description="My First Stripe Customer" --api-key sk_test_4eC39HqLyjWDarjtT1zdp7dc

   Si tout a fonctionné correctement, la ligne de commande affiche la réponse suivante :

   {
     "id": 
   "cus_LfdZgLFhah76qf",
     "object": 
   "customer",

   Afficher les 32 lignes

Lorsque vous appelez les API Stripe, Stripe crée et sauvegarde des objets API et Events pour votre compte utilisateur Stripe. La clé API spécifiée pour la requête détermine si les objets sont sauvegardés en mode test ou en mode production. Par exemple, la dernière requête ayant utilisé votre clé API secrète, Stripe a sauvegardé les objets en mode test.

• Pour afficher le log de requête API :

  • Ouvrez la page Logs.
  • Cliquez sur 200 OK POST /v1 customers.

• Pour afficher le log de l’événement :

  • Ouvrez la page Événements.
  • Cliquez sur jane.smith@email.com est un nouveau client.

Tous les comptes disposent par défaut de quatre clés API au total, deux pour le mode test et deux pour le mode production :

• Clé secrète du mode test : utilisez cette clé pour authentifier les requêtes sur votre serveur en mode test. Par défaut, vous pouvez l’utiliser pour effectuer n’importe quelle requête API sans restriction.
• Clé publiable du mode test : utilisez cette clé à des fins de test dans le code côté client de votre application Web ou mobile.
• Clé secrète du mode production : utilisez cette clé pour authentifier les requêtes sur votre serveur en mode production. Par défaut, vous pouvez l’utiliser pour effectuer n’importe quelle requête API sans restriction.
• Clé publiable du mode production : utilisez cette clé dans le code côté client de votre application Web ou mobile lorsque votre application est prête à être lancée.

Vous pouvez trouver vos clés secrètes et publiables dans les clés API. Lorsque vous êtes connecté, la documentation de Stripe alimente automatiquement les exemples de code avec vos clés API en mode test (vous seul pouvez voir ces valeurs). Si vous n’êtes pas connecté, nos exemples de code incluent des clés API générées aléatoirement. Vous pouvez les remplacer par vos propres clés de test ou vous connecter pour voir les exemples de code remplis avec vos clés API de test. Si vous ne pouvez pas voir vos clés API, demandez au propriétaire de votre compte Stripe de vous ajouter à leur équipe, avec les permissions appropriées.

Le tableau suivant contient des exemples de clés API de test secrète et publique générées de manière aléatoire :