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

Lorsqu’un abonnement est payé via PayPal dans Agency Handy, plusieurs étapes sont impliquées côté back-end : création de l’abonnement, autorisation du paiement, facturation récurrente, et enregistrement de la transaction. Voici un aperçu détaillé du fonctionnement :

---

1. Création et Configuration de l’Abonnement

• Agency Handy est intégré à l’API PayPal Subscriptions.

• Lorsqu’un utilisateur sélectionne une offre d’abonnement, le système envoie une requête à l’API PayPal pour créer un accord d’abonnement.

• PayPal génère un ID d’abonnement et redirige l’utilisateur vers PayPal pour approuver l’accord.

---

2. Traitement du Premier Paiement

• Après approbation, PayPal traite le premier paiement de l’abonnement.

• Il vérifie la validité du moyen de paiement (solde PayPal, compte bancaire, carte de crédit/débit).

• En cas de succès, PayPal envoie un webhook à l’arrière-plan d’Agency Handy pour confirmer le paiement.

---

3. Planification des Paiements Récurrents

• PayPal gère un calendrier de facturation selon les termes de l’abonnement (mensuel, annuel...).

• À chaque échéance, PayPal débite automatiquement le client.

• En cas d’échec (carte expirée, fonds insuffisants...), PayPal effectue plusieurs tentatives à des intervalles définis.

---

4. Traitement et Enregistrement des Transactions

Chaque paiement suit plusieurs étapes :

(A) Autorisation & Capture

• PayPal autorise le montant avant de débiter.

• Puis, il capture les fonds et les enregistre dans l’historique des transactions de l’utilisateur.

• Un webhook de confirmation de paiement est envoyé à Agency Handy.

(B) Règlement du Paiement

• PayPal transfère le montant au compte PayPal de l’agence après déduction des frais de transaction.

• Le montant net apparaît dans le solde PayPal de l’agence, prêt à être retiré vers un compte bancaire.

(C) Enregistrement dans le Tableau de Bord PayPal

Chaque transaction comprend :

• ID de transaction : identifiant unique.

• ID d’abonnement : pour lier la transaction à l’abonnement actif.

• Horodatage et statut : succès, échec ou en attente.

• Frais déduits : les frais PayPal sont automatiquement soustraits avant le transfert.

---

5. Gestion des Annulations & Échecs d’Abonnement

• Si un utilisateur annule son abonnement, PayPal interrompt la facturation.

• En cas d’échecs répétés de paiement, PayPal suspend ou annule l’abonnement.

• Le backend d’Agency Handy reçoit des webhooks et met à jour les dossiers en conséquence.

---

6. Webhooks & Journaux API dans Agency Handy

Agency Handy écoute les webhooks de PayPal pour mettre à jour les statuts d’abonnement.

Webhooks courants :

• BILLING.SUBSCRIPTION.CREATED → Lorsqu’un nouvel abonnement est créé.

• PAYMENT.SALE.COMPLETED → Paiement récurrent réussi.

• BILLING.SUBSCRIPTION.CANCELLED → Abonnement annulé.

Toutes les transactions sont journalisées dans la base de données d’Agency Handy pour une traçabilité complète.

---

✅ Résumé Final du Flux

1. Création de l’abonnement → L’utilisateur approuve via PayPal.

2. Premier paiement traité → PayPal autorise puis capture le montant.

3. Paiements récurrents → Débits automatiques à chaque échéance.

4. Enregistrement des paiements → Dans PayPal et Agency Handy.

5. Annulation ou échec → Géré par PayPal avec notification à Agency Handy.