Comment Stripe Génère les Paiements d’Abonnement pour Agency Handy

Agency Handy s’intègre à Stripe pour gérer les paiements d’abonnement. Voici un aperçu détaillé du processus backend — de la création d’un abonnement jusqu’à l’enregistrement et le traitement des transactions.


1. Configuration de l’Abonnement (Création Initiale)

Lorsqu’un utilisateur souscrit à un abonnement via Stripe, Agency Handy effectue les étapes suivantes :

a. Création d’un client dans Stripe

  • Agency Handy envoie une requête à Stripe pour créer un client.

  • Stripe génère un identifiant client (cus_xxx) et enregistre les informations de paiement (carte bancaire, compte, etc.).

  • Les données sensibles sont stockées de manière sécurisée chez Stripe. Seul l’identifiant client est conservé dans la base de données d’Agency Handy.

b. Création de l’abonnement

  • Agency Handy envoie à Stripe une requête pour créer un abonnement (mensuel ou annuel).

  • Stripe génère un identifiant d’abonnement (sub_xxx) qui permet de suivre l’offre de l’utilisateur.

  • Le mode de paiement est associé à cet abonnement.

  • Stripe configure la facturation récurrente selon le plan sélectionné.


2. Traitement des Paiements d’Abonnement

Une fois l’abonnement configuré, Stripe gère les paiements comme suit :

a. Facturation du client

  • À chaque échéance, Stripe tente automatiquement de débiter le moyen de paiement enregistré.

  • En cas de succès, l’abonnement est marqué comme actif et une facture est générée.

  • En cas d’échec, Stripe applique sa logique Smart Retries (nouvelle tentative après 1 jour, 3 jours, 7 jours, etc.).

b. Génération d’une facture

Après un paiement réussi, Stripe crée une facture (in_xxx) contenant :

  • Le montant facturé

  • Le statut du paiement

  • Les détails de l’abonnement

  • Les éventuelles taxes ou remises

c. Notification via Webhook à Agency Handy

  • Stripe envoie un événement webhook (invoice.payment_succeeded) à Agency Handy.

  • Agency Handy met à jour le statut de l’abonnement en actif.

d. Gestion des paiements échoués

  • En cas d’échec, Stripe déclenche l’événement invoice.payment_failed.

  • Agency Handy est alerté et peut :

    • Suspendre l’accès aux services.

    • Envoyer un e-mail demandant une mise à jour du moyen de paiement.

    • Tenter un nouveau paiement avant d’annuler l’abonnement.


3. Enregistrement et Traitement des Transactions

Chaque transaction dans Stripe suit un processus structuré :

a. Création d’un enregistrement de paiement

  • Un paiement réussi génère un identifiant de transaction (ch_xxx).

  • Ce paiement est lié à la facture (in_xxx) et à l’abonnement (sub_xxx).

b. Enregistrement du paiement

  • Stripe enregistre le moyen de paiement utilisé (ex. : Visa se terminant par 1234).

  • La transaction est visible dans le tableau de bord Stripe.

  • Agency Handy reçoit les données via webhook et les enregistre dans sa base interne.

c. Versements à Agency Handy

  • Stripe collecte les paiements des clients mais conserve les fonds dans un solde Stripe.

  • Les versements vers le compte bancaire d’Agency Handy ont lieu selon une fréquence définie (quotidienne, hebdomadaire...).

  • Chaque versement génère un identifiant (po_xxx) et est enregistré.

d. Remboursements & Litiges

  • Agency Handy ne permet pas de remboursements directs via Stripe.

  • En cas de litige bancaire, Stripe examine les justificatifs et gère le différend.

  • Le montant contesté est bloqué temporairement jusqu’à résolution.


4. Résumé des Identifiants Stripe & Flux de Données

Étape
Objet Stripe
Format ID
Utilité

Création du client

customer

cus_xxx

Stocke les informations de l’utilisateur.

Création d’abonnement

subscription

sub_xxx

Gère la facturation récurrente.

Génération de facture

invoice

in_xxx

Enregistre les paiements liés à l’abonnement.

Paiement (transaction)

charge

ch_xxx

Représente la transaction Stripe.

Versement bancaire

payout

po_xxx

Transfert d’argent vers Agency Handy.

Notification webhook

event

evt_xxx

Informe Agency Handy de tout changement.


🔁 Flux Final du Paiement d’Abonnement

  1. L’utilisateur souscrit via Agency Handy.

  2. Agency Handy crée un Customer et un Subscription dans Stripe.

  3. À la date d’échéance, Stripe débite automatiquement.

  4. Stripe génère une facture et la marque comme payée.

  5. Stripe envoie un webhook à Agency Handy, qui met à jour le statut.

  6. Les paiements s’accumulent dans le solde Stripe.

  7. Stripe effectue des versements programmés à Agency Handy.

  8. Agency Handy met à jour sa base de données interne.

Last updated

Was this helpful?