Braintree est un service de paiement créé par PayPal qui vous permet d'accepter des dons en toute sécurité sur votre site Web, tout en offrant à vos donateurs la flexibilité de payer via PayPal, Venmo (aux États-Unis), cartes de crédit ou de débit, ou portefeuilles numériques tels que Google Pay et Apple Pay.

Installation

L'installation de Charitable Braintree est identique à celle de toute autre extension Charitable. Si vous n'êtes pas sûr de la procédure, nous vous recommandons d'abord de lire notre guide d'installation des extensions Charitable.

Activer la passerelle

Après avoir installé et activé le plugin Charitable Braintree, vous devez l'activer en tant que passerelle de paiement. Si vous êtes sur la page des plugins, vous pouvez le faire directement à partir de là en cliquant sur le lien « Activer la passerelle Braintree » :

Alternativement, vous pouvez activer la passerelle via la page des paramètres des passerelles de paiement :

1. Allez à Charitable > Paramètres > Passerelles de paiement
2. Cliquez sur Activer la passerelle dans le bloc Braintree.

Paramètres

Pour accepter des paiements avec Braintree, vous devrez configurer Charitable avec vos paramètres Braintree.

1. Allez dans Caritatif > Paramètres > Passerelles de paiement.
2. Cliquez sur Paramètres de la passerelle.

Configuration de vos clés API

Lorsque vous vous connectez pour la première fois à votre compte Braintree, ou si vous n'avez jamais effectué de transactions via celui-ci, votre ID de commerçant, votre clé publique et votre clé privée s'afficheront immédiatement une fois que vous vous serez connecté :

Copiez et collez ces clés dans vos paramètres Charitable.

Si vous ne voyez pas cela lorsque vous vous connectez à votre compte Braintree, vous pouvez suivre les instructions ci-dessous pour trouver les détails pertinents :

1. Dans le coin supérieur droit de votre tableau de bord Braintree, cliquez sur l'icône d'engrenage, puis cliquez sur API.
2. Vous trouverez votre clé publique dans la section « Clés API » en haut. Si aucune clé API n'apparaît, cliquez sur Générer une nouvelle clé API.
3. Cliquez sur le lien Afficher dans la colonne Clé privée. Sur l'écran suivant, vous verrez votre clé privée, votre ID de commerçant et votre clé publique listés.

Utilisation de Braintree en mode test

Pour tester le fonctionnement de Braintree, nous vous recommandons de le tester d'abord avec un compte sandbox. Vous pouvez créer un compte sandbox sur https://sandbox.braintreegateway.com

Vous trouverez votre clé publique, votre clé privée et votre ID de commerçant de la même manière que pour un compte réel (voir les instructions ci-dessus). Copiez et collez-les dans la section « Paramètres du mode test » de vos paramètres Charitable Braintree.

Configuration de méthodes de paiement supplémentaires

En plus des paiements par carte, vous pouvez accepter les paiements effectués par PayPal, Venmo (États-Unis uniquement), Apple Pay et Google Pay.

Pour accepter ces méthodes de paiement, vous devrez activer les méthodes de paiement dans Braintree ainsi que dans vos paramètres Charitable.

Étape 1 : Activer les méthodes de paiement dans Braintree

1. Dans le coin supérieur droit de votre tableau de bord Braintree, cliquez sur l'icône d'engrenage, puis sur Processing.
2. Sur la page Processing, activez toutes les méthodes de paiement pour lesquelles vous souhaitez ajouter la prise en charge. L'intégration de Charitable prend actuellement en charge PayPal, Venmo, Apple Pay et Google Pay.

Note : Venmo n'est disponible que pour les comptes Braintree basés aux États-Unis, vous ne le verrez donc peut-être pas comme option à activer.

Étape 2 : Activer les méthodes de paiement dans Charitable

Une fois que vous avez activé les méthodes de paiement dans Braintree, vous pouvez les activer dans Charitable en cochant simplement la case :

Activer la 3D Secure

Charitable s'intègre de manière transparente à la fonctionnalité 3D Secure 2 de Braintree, qui réduit la fraude, améliore la sécurité et aide à répondre aux exigences de l'authentification forte du client (SCA). Pour l'activer, cochez simplement la case :

Configuration des dons récurrents

Si vous utilisez Braintree avec notre extension Dons récurrents, des étapes de configuration supplémentaires sont nécessaires.

Créer un plan de facturation récurrente

Pour créer un don récurrent via Braintree, vous devez disposer d'un plan de facturation. Lorsqu'une personne initie un don récurrent, un abonnement sera créé pour elle, en utilisant ce plan.

Note : Bien que les plans que vous créez dans Braintree aient un prix défini, il s'agit d'une valeur par défaut. Pour les abonnements individuels, un abonnement de donateur peut remplacer ces valeurs. Pour cette raison, il est possible d'utiliser un seul plan de facturation récurrent pour tous les dons récurrents de la même période créés via votre site Web.

Pour créer un plan de facturation dans votre tableau de bord Braintree :

1. Dans la navigation supérieure, cliquez sur Subscriptions.
2. En haut de la page, cliquez sur Plans.
3. Si vous créez un nouveau plan, cliquez sur + Create A Plan ; si vous ajoutez un nouveau plan, cliquez sur + New Plan.
4. Pour les paramètres du plan, saisissez le nom de votre plan, le prix par défaut, la devise et la fréquence de facturation. Vous pouvez également préférer spécifier un identifiant de plan et une description, bien que les deux soient facultatifs. Tous les autres paramètres doivent être laissés vides ou inchangés.
5. Cliquez sur Create.

Une fois que vous avez créé votre plan, retournez au tableau de bord de votre site Web et accédez à la page des paramètres Braintree (Charitable > Settings > Payment Gateways > Braintree Gateway Settings). Faites défiler jusqu'à la section « Recurring Billing » :

Sélectionnez les plans de facturation par défaut que vous souhaitez utiliser pour chaque période de don récurrent, pour le mode Live et le mode Test. Pour le mode Test, vous devrez créer des plans de facturation dans votre tableau de bord sandbox Braintree.

Utiliser différents plans pour différentes campagnes

Vous pourriez trouver utile de définir différents plans de facturation récurrents pour différentes campagnes. Par exemple, cela peut vous permettre de trouver plus facilement tous les dons récurrents d'une campagne spécifique dans votre tableau de bord Braintree.

Pour ce faire, vous devrez d'abord créer autant de plans que nécessaire dans votre tableau de bord Braintree en suivant les étapes décrites ci-dessus. Vous pouvez laisser les paramètres de plan par défaut dans Charitable inchangés.

Pour modifier le plan de facturation récurrente utilisé pour une campagne spécifique, modifiez la campagne dans votre tableau de bord WordPress. Sous la section « Dons récurrents », sélectionnez votre plan de facturation préféré à utiliser pour la campagne. Notez qu'il existe des paramètres distincts pour le mode Live et le mode Test.

Ajouter un webhook

Lorsqu'un donateur a un don récurrent, Braintree peut envoyer des notifications à votre site Web via un webhook chaque fois que des événements importants liés à l'abonnement se produisent, tels que :

• Un renouvellement a été facturé
• Le don récurrent a été annulé
• Braintree n'a pas pu traiter le renouvellement le plus récent

Sans webhook, Charitable ne serait pas alerté de ces événements, il est donc important d'en ajouter un.

1. Dans le coin supérieur droit de votre tableau de bord Braintree, cliquez sur l'icône d'engrenage, puis cliquez sur API.
2. Cliquez sur le lien Webhooks en haut.
3. Cliquez sur + Créer un nouveau webhook pour ajouter votre webhook.
4. Pour « URL de destination », entrez l'URL de votre site Web suivie de /charitable-listener/braintree/. Par exemple, si votre site Web est exemple.com, votre URL de destination sera https://exemple.com/charitable-listener/braintree/.
5. Sous « Notifications », cochez toutes les options sous « Abonnement ».

Une fois que vous avez ajouté le webhook, cliquez sur Vérifier l'URL pour vous assurer que le webhook est correctement configuré et qu'il peut atteindre votre site Web. Votre serveur doit répondre avec un statut 200.

Si vous utilisez le Sandbox Braintree pour tester, nous vous recommandons également d'ajouter un webhook dans votre compte sandbox, en suivant le même processus.