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 à l’aide de Stripe Shell. Stripe Shell vous permet d’exécuter des commandes de l’interface de ligne de commande Stripe directement depuis le site de documentation de Stripe. Celui-ci fonctionne uniquement dans un environnement de test, vous n’avez donc pas à vous soucier d’effectuer de véritables transactions de transfert de fonds.

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 passant votre clé secrète API dans un environnement de test :

   Command Line

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

   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 effectuez un appel aux API de Stripe, Stripe crée et stocke des objets API et Events pour votre compte d’utilisateur Stripe. La clé API que vous indiquez pour la requête détermine si les objets sont stockés dans un environnement de test ou en mode production. Par exemple, la dernière requête utilisait votre clé secrète API, donc Stripe a stocké les objets dans un environnement de 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.

Par défaut, tous les comptes disposent au total de quatre clés API :

Vos clés secrètes et publiables se trouvent dans l’onglet clés API du Dashboard. Si vous ne pouvez pas afficher vos clés API, demandez au propriétaire de votre compte Stripe de vous ajouter à son équipe avec les autorisations appropriées.

Si vous êtes connecté à Stripe, notre documentation remplit des exemples de code avec vos clés API 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 que vous pouvez remplacer par vos clés test. Vous pouvez également vous connecter pour voir les exemples de code remplis avec vos clés API test.

Exemples de clés API

Le tableau suivant présente des exemples de clés secrètes et publiques générées de manière aléatoire :