> For the complete documentation index, see [llms.txt](https://docs.flycode.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flycode.com/docs/fr/integrations/how-to-connect-flycode-to-your-braintree-paypal-account.md).

# Guide d’intégration Braintree et PayPal : connectez FlyCode

{% hint style="info" %}
**TL;DR :** Dans le Braintree Control Panel, créez un rôle FlyCode avec uniquement les autorisations dont FlyCode a besoin, ajoutez un utilisateur avec accès API associé à ce rôle pour le compte marchand que vous souhaitez couvrir, et partagez les identifiants de manière sécurisée avec FlyCode. FlyCode récupère ensuite les paiements d’abonnement échoués sur Braintree et PayPal grâce à un timing de relance basé sur le machine learning et à une messagerie coordonnée. Aucun changement de code.
{% endhint %}

## À qui cela s’adresse

Entreprises SaaS et d’abonnement B2C et B2B traitant des paiements récurrents via Braintree (y compris PayPal via Braintree) qui souhaitent récupérer davantage de paiements échoués et réduire le churn involontaire sans modifier leur intégration de facturation.

## Prérequis

* Accès au Braintree Control Panel avec autorisation de gérer les rôles et les utilisateurs (administrateur du compte).
* Le ou les identifiants de compte marchand que vous souhaitez faire couvrir par FlyCode.
* Un compte FlyCode. [Commencer](https://www.flycode.com/get-started) si vous n’en avez pas ; vous recevrez l’adresse e-mail FlyCode à utiliser pour l’utilisateur API.

## Configuration

{% stepper %}
{% step %}

### Créer un rôle FlyCode

Dans le Braintree Control Panel, allez dans Settings, Team, Roles, puis créez un nouveau rôle nommé FlyCode. Accordez uniquement les autorisations indiquées ci-dessous (accès en lecture aux clients, aux moyens de paiement, aux abonnements et aux transactions, ainsi que la possibilité de créer des transactions et de mettre à jour des abonnements). N’accordez pas les autorisations de règlement, de remboursement ou de paramètres du compte.

<figure><img src="https://857825088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FedoXR9BFShbgporwvi7n%2Fuploads%2FYvPU28U7LeelMbRY0IPk%2FScreenshot%202024-06-18%20at%2012.46.49%20(1).png?alt=media&#x26;token=74d431a2-7269-4ff0-adac-442c1385a615" alt=""><figcaption><p>Autorisations pour le rôle FlyCode</p></figcaption></figure>
{% endstep %}

{% step %}

### Ajouter un utilisateur API FlyCode

Allez dans Settings, Team, Users, Add new user. Saisissez l’adresse e-mail FlyCode que vous avez reçue lors de l’inscription, puis :

* Activer **Accès API**.
* Sous **Rôles**, sélectionnez le rôle FlyCode que vous avez créé à l’étape 1.
* Sous **Compte marchand**, sélectionnez le ou les comptes que FlyCode doit couvrir.

Cliquez sur Create User. Braintree génère les identifiants API pour l’utilisateur.
{% endstep %}

{% step %}

### Partager les identifiants et fixer une date de lancement

Partagez les identifiants API avec FlyCode via le canal sécurisé fourni lors de l’onboarding (jamais par e-mail en clair). FlyCode se connecte, charge les transactions échouées existantes et les abonnements en état d’impayé, et convient avec vous d’une date de lancement. Si Braintree ou votre système de facturation envoie des e-mails d’échec de paiement, décidez si c’est FlyCode ou votre système qui gère la messagerie.
{% endstep %}
{% endstepper %}

## Comment FlyCode se comporte sur Braintree et PayPal

* Relance les transactions d’abonnement échouées avec un timing piloté par le modèle, dans les limites du réseau de cartes.
* Ne relance pas les refus définitifs ; bascule vers un autre moyen de paiement enregistré lorsqu’il est disponible, sinon déclenche une prise de contact.
* Enregistre chaque relance comme une transaction Braintree visible dans le Control Panel et reflétée dans vos rapports existants.
* Peut être limité à des comptes marchands spécifiques.

## Liste de contrôle avant mise en production

* [ ] Rôle FlyCode créé avec des autorisations restreintes
* [ ] Utilisateur API FlyCode créé avec accès API, rôle FlyCode et compte marchand correct
* [ ] Identifiants partagés de manière sécurisée
* [ ] Responsable de la messagerie défini
* [ ] Date de lancement convenue

## Dépannage

**FlyCode indique qu’il ne peut pas lire les abonnements ou les transactions.** Le rôle manque d’une autorisation de lecture, ou l’utilisateur n’est pas affecté au bon compte marchand. Comparez avec la capture d’écran de l’étape 1.

**Les relances n’apparaissent pas.** L’accès API n’est pas activé pour l’utilisateur, ou la date de lancement n’a pas été atteinte.

**E-mails clients en double.** Votre système de facturation et FlyCode envoient tous deux des messages sur les paiements échoués. Choisissez un seul responsable.

## FAQ

**FlyCode a-t-il besoin d’un accès administrateur complet ?** Non. Le rôle restreint limite FlyCode à la lecture des objets de facturation et à la création de transactions de relance.

**Cela couvre-t-il les paiements par portefeuille PayPal ?** Oui, pour les moyens de paiement PayPal enregistrés dans Braintree. Le comportement des relances suit les règles de PayPal pour les transactions de référence.

**Puis-je révoquer l’accès ?** Oui, à tout moment en supprimant ou en désactivant l’utilisateur FlyCode dans Braintree.

## Connexe

* [Plateformes de paiement et d’abonnement prises en charge](https://docs.flycode.com/docs/integrations/supported-payment-and-subscription-platforms)
* [Qu’est-ce que FlyCode ?](https://docs.flycode.com/docs/introduction/what-is-flycode)
* [Considérations d’intégration](https://help.flycode.com/understanding-involuntary-churn/integration-considerations) dans le centre d’aide


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.flycode.com/docs/fr/integrations/how-to-connect-flycode-to-your-braintree-paypal-account.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
