Visa partnered with FlyCode
Read more >
Ctrlk
HomepageCustomersGet Started
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Guide d'intégration Braintree et PayPal : connecter FlyCode

Connectez FlyCode à Braintree ou PayPal pour récupérer les paiements d'abonnement échoués : rôle restreint, utilisateur API, compte marchand, checklist de mise en production, dépannage.

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.

À 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 si vous n’en avez pas ; vous recevrez l’adresse e-mail FlyCode à utiliser pour l’utilisateur API.

Configuration

1

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.

Autorisations pour le rôle FlyCode
2

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.

3

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.

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

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

Mis à jour

Ce contenu vous a-t-il été utile ?