# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.agencyhandy.com/french/guide-dutilisation-dagencyhandy-pour-les-agences/abonnement/comment-paypal-genere-les-paiements-dabonnement-pour-agency-handy.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.