Anciennes extensionsObsolète

Vous pouvez configurer ce paramètre dans la section Intégration de la page Paramètres des extensions

Pour commencer votre intégration, activez l’inscription des comptes Standard avec OAuth. Vous ne devez pas utiliser OAuth avec des comptes Express pour vos extensions.

Stripe provides a unique identifier for your extension called a client_id. You set the redirect_uri and users are directed to that page after they connect their accounts. You must specify all redirect URIs in your extension settings. The development and production versions of these two values help with testing. Take note of these values so you can create an OAuth link in the third step.

Vous pouvez personnaliser l’apparence de votre entreprise pour vos utilisateurs dans la section Adaptation à votre marque de la page Paramètres des extensions

Votre logo s’affiche lorsque les utilisateurs associent leurs comptes Stripe à votre application. Une fois les comptes associés, votre icône s’affiche dans la liste de leurs applications connectées.

Stripe fournit un flux OAuth 2.0 standard pour se connecter aux comptes Stripe. À l’aide des valeurs client_id et redirect_uri définies à la première étape, vous pouvez créer un lien OAuth permettant à vos utilisateurs de se connecter. Nous vous recommandons d’afficher ce lien via un bouton Connexion avec Stripe qui renvoie les utilisateurs vers l’endpoint authorize_url :

https://connect.stripe.com/oauth/authorize?response_type=code&client_id=ca_FkyHCg7X8mlvCUdMDao4mMxagUfhIwXb&scope=read_only

Voici comment vous pouvez présenter le lien ci-dessus à votre utilisateur via le bouton Connexion à Stripe :

Une fois que l’utilisateur a cliqué sur le lien de votre site, il est redirigé vers une page sur laquelle il peut autoriser ou refuser la connexion à votre extension. Il est ensuite invité à se connecter avec un compte existant ou à en créer un nouveau.

Une fois que l’utilisateur a connecté son nouveau compte ou un compte existant à votre extension, il est redirigé vers l’URL que vous avez définie comme valeur redirect_uri.

À l’issue du flux OAuth, vous recevrez des identifiants d’autorisation pour le compte de l’utilisateur :

{
  ...
  "stripe_user_id": "acct_0123456789",
  ...
}

Vous devez enregistrer le stripe_user_id afin de pouvoir identifier les comptes d’utilisateur.

Une fois que vos utilisateurs ont associé leurs comptes Stripe à votre application, vous pouvez effectuer des requêtes à l’API en leur nom. Pour ce faire, vous avez besoin de la clé secrète du compte de votre extension et d’un en-tête Stripe-Account, qui identifie le compte pour lequel vous effectuez la requête. Toutes les bibliothèques Stripe prennent en charge ce mode d’authentification par requête.

Récupération des données enregistrées

Les données enregistrées incluent notamment des informations sur les paiements et la clientèle. Avec l’accès en lecture seule (read_only), vous pouvez effectuer la plupart des requêtes GET dans l’API de Stripe. Vous pouvez extraire un objet précis (par exemple, un PaymentIntent) ou une liste d’objets (par exemple, la liste de tous les PaymentIntents).

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "created[lte]"=1612048287 \
  -d "limit"=50 \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}"

Si l’API est conçue pour être performante, les recherches répétées de grands ensembles de données diminuent la réactivité de votre application. Nous vous recommandons d’enregistrer les données extraites localement à des fins d’analyse et de reporting.

Accès aux données en temps réel

Outre les données stockées, vous pouvez accéder à des données en temps réel par le biais des webhooks. Une fois que vous avez défini un endpoint de webhook d’extension dans votre compte, Stripe envoie des notifications d’événements à votre endpoint pour chaque compte connecté. La propriété account de l’objet Event identifie le compte sur lequel s’est déroulé l’événement.

Par exemple, l’événement ci-dessous montre qu’un client a été créé sur le compte acct_0123456789. Une fois encore, nous vous recommandons d’enregistrer ces données localement à des fins d’analyse et de reporting. Si votre application peut prendre connaissance des événements au moment où ils surviennent, elle pourra répondre plus rapidement et vous aurez besoin de lancer moins d’appels à l’API.

{
  "id": "evt_zPhElw0JLk13Xl",
  "livemode": true,
  "object": "event",
  "type": "customer.created",
  "account": "acct_0123456789",
  "pending_webhooks": 2,
  "created": 1349654313,
  "data": {...}
}