Aller au contenu principal

Introduction

Ce cookbook a pour objectif de vous accompagner dans la mise en place d'une intégration Stripe complète, de la configuration du compte jusqu'à son intégration dans votre application.

Configuration Stripe : 1h30 Intégration Stripe : 30min Total : 2h

Il est organisé en deux parties complémentaires :

  • Configuration Stripe : configuration du compte, des produits, des taxes, des abonnements, des webhooks et des différents services proposés par Stripe.
  • Blueprints d'intégration : spécifications techniques indépendantes de toute technologie décrivant les modèles de données, les services, les API, les webhooks et les règles métier nécessaires à une intégration robuste.

L'objectif est de fournir une méthode reproductible permettant à n'importe quel développeur d'intégrer Stripe tout en conservant une architecture propre et maîtrisée.

Ce que vous allez obtenir
  • Un compte Stripe correctement configuré.
  • Une architecture d'intégration indépendante de la technologie utilisée.
  • Des blueprints réutilisables pour implémenter Stripe dans vos projets.

Commencer la lecture​

Objectifs

Ce cookbook vise deux résultats concrets.

La partie 1 permet de configurer Stripe de manière propre et exploitable en production : compte, fiscalité, produits, paiements, abonnements, webhooks et passage en production.

La partie 2 fournit des blueprints techniques agnostiques qui cadrent l'intégration dans l'application : modèle de données, services, API, traitements webhook, synchronisation, sécurité et tests.

L'ensemble doit permettre une mise en oeuvre cohérente, maintenable et réutilisable d'un projet à l'autre.

Prérequis

Côté configuration Stripe​

  • Les informations légales de l'entreprise ;
  • Un compte bancaire pour les virements ;
  • Les éléments fiscaux nécessaires (TVA, taxes, obligations locales).

Côté intégration applicative​

  • Compréhension de base de HTTP, JSON, API key, transactions et webhooks ;
  • Possibilité de stocker des données en base relationnelle ;
  • Possibilité d'exposer des endpoints HTTP ;
  • Possibilité d'appeler l'API Stripe en HTTPS ;
  • Possibilité de vérifier les signatures webhook et de traiter les événements de façon idempotente.

Architecture du cookbook

Le cookbook est divisé en deux espaces documentaires.

Suite du cookbook

Les sujets suivants seront traités dans des chapitres dédiés de la partie Blueprints d'intégration :

  • architecture cible de l'intégration ;
  • comment lire un blueprint ;
  • organisation des fichiers et conventions documentaires.