PayPal Commerce est l'intégration PayPal moderne de Charitable – une seule connexion qui permet à vos donateurs de payer avec PayPal, Venmo, Pay Later, les cartes de crédit et de débit, Apple Pay et Google Pay. Cette page vous guide dans son activation sur votre site et ce qu'il faut faire si elle n'apparaît pas dans votre liste de passerelles.

PayPal Commerce remplace les anciennes configurations PayPal Standard, Express Checkout et Card Processing par une seule intégration qui débloque également Venmo, Pay Later, Apple Pay et Google Pay. Les donateurs voient des boutons de portefeuille modernes et un paiement plus rapide, et vous gérez les remboursements et les dons récurrents directement dans WordPress sans jongler avec plusieurs produits ou comptes PayPal. Pour plus d'informations, consultez Introduction à PayPal Commerce.

Disponible dans Charitable Pro 1.8.15+.

Activer PayPal Commerce

1. Dans votre administration WordPress, allez à Charitable → Paramètres → Passerelles de paiement.
2. Trouvez PayPal Commerce dans la liste des passerelles et cliquez sur Activer.
3. Cliquez sur Paramètres à côté de PayPal Commerce, puis cliquez sur Se connecter avec PayPal.
4. PayPal s'ouvre dans une nouvelle fenêtre. Connectez-vous à votre compte professionnel PayPal (ou créez-en un) et approuvez la connexion.
5. PayPal vous redirige vers WordPress. Le panneau de connexion affichera votre identifiant de commerçant et les fonctionnalités accordées à votre compte.

C'est tout – vos formulaires de don proposeront immédiatement PayPal Commerce comme option de paiement.

Mode Test – PayPal Commerce respecte le basculement standard du Mode Test de Charitable. Laissez le Mode Test activé pendant la validation du flux de don, puis désactivez-le lorsque vous êtes prêt à accepter des dons réels.

Vous ne voyez pas PayPal Commerce dans votre liste de passerelles ?

Pour que les choses restent prévisibles, une seule intégration PayPal est affichée par site à la fois. Si votre site est déjà configuré avec la passerelle PayPal existante (PayPal Standard / IPN), PayPal Commerce reste masqué par défaut et la liste des passerelles affiche votre configuration PayPal existante à la place.

Charitable décide laquelle afficher lors de la mise à niveau 1.8.15 en vérifiant deux signaux :

• La passerelle PayPal existante est-elle actuellement activée dans vos paramètres ?
• Y a-t-il des dons antérieurs sur votre site qui ont été traités via la passerelle PayPal existante ?

Si l'une de ces conditions est remplie, votre site conserve sa configuration PayPal existante et PayPal Commerce est masqué.

C'est le comportement approprié pour la grande majorité des sites – exécuter les deux intégrations côte à côte complique l'expérience du donateur et la comptabilité. Mais si vous souhaitez passer à PayPal Commerce de toute façon, vous le pouvez.

Passer à PayPal Commerce

Avant de passer – lisez ceci

Si vous avez des dons récurrents actifs en cours via la passerelle PayPal existante, veuillez lire ceci attentivement :

• PayPal continuera à facturer vos donateurs selon le calendrier que vous avez défini. Aucun de vos donateurs ne sera annulé.
• Cependant, après le changement, Charitable n'enregistrera plus ces renouvellements dans votre tableau de bord, car le gestionnaire IPN de la passerelle PayPal existante est désactivé lorsque vous effectuez le changement.

Si le suivi de ces renouvellements est important pour vous, annulez les dons récurrents dans votre tableau de bord PayPal avant de changer. Ou contactez notre équipe de support – nous pouvons vous aider à migrer les donateurs actifs lorsque notre outil de migration sera disponible dans une future version.

Si vous n'avez que des dons historiques ponctuels et aucun don récurrent actif, le changement n'a aucun impact sur le donateur.

Trois façons de changer

Choisissez la voie qui correspond à votre niveau d'accès. Les trois accomplissent la même chose.

Voie 1 – WP-CLI (recommandé pour les développeurs et les agences)

Si vous avez un accès shell à votre serveur (SSH, CLI d'hébergement, etc.), c'est la voie la plus propre :

wp charitable paypal force-commerce-tier --confirm-recurring-impact

L'indicateur --confirm-recurring-impact est requis lorsque vous avez des dons récurrents actifs sur la passerelle PayPal existante. La commande refusera de s'exécuter sinon, avec un décompte du nombre de dons qui seraient affectés.

Prévisualisez ce qui se passerait avec l'indicateur --dry-run avant de valider :

wp charitable paypal force-commerce-tier --dry-run

Après le changement, allez dans Charitable → Paramètres → Passerelles de paiement et complétez le flux Se connecter avec PayPal sur la carte PayPal Commerce pour commencer à accepter les dons.

Voie 2 – Filtre functions.php (pour les développeurs sans accès shell)

Ajoutez cet extrait à functions.php de votre thème ou à un petit plugin personnalisé :

add_filter( 'pre_option_charitable_paypal_user_tier', function () {
    return 'commerce';
} );

Le filtre s'exécute à chaque appel de get_option(), donc PayPal Commerce devient visible immédiatement lors du prochain chargement d'une page d'administration.

Il s'agit d'une substitution à l'exécution – elle ne modifie pas la valeur stockée dans votre base de données. La substitution reste en vigueur tant que le filtre est dans votre code ; supprimez le filtre et la visibilité d'origine est restaurée. Si vous souhaitez rendre le changement permanent sans conserver le filtre, laissez-le en place pour vérifier que tout fonctionne, puis exécutez la commande WP-CLI de la Voie 1.

Voie 3 – Mise à jour SQL (pour les utilisateurs de panneau d'hébergement / phpMyAdmin)

Si vous êtes à l'aise avec phpMyAdmin, Adminer ou l'outil de base de données de votre panneau d'hébergement, exécutez cette requête sur votre base de données WordPress :

UPDATE wp_options
SET option_value = 'commerce'
WHERE option_name = 'charitable_paypal_user_tier';

Remplacez wp_options par le préfixe de votre table réel s'il n'est pas celui par défaut. Le changement est immédiat – actualisez la page des paramètres de la passerelle et PayPal Commerce apparaîtra.

⚠️ Rappel : si vous avez des dons récurrents actifs sur la passerelle PayPal existante, PayPal continuera à facturer les donateurs mais Charitable n'enregistrera pas ces renouvellements. Annulez-les d'abord dans PayPal, ou procédez en connaissance de cause du compromis.

Ce qui se passe après le changement

• La passerelle PayPal existante disparaît de votre liste de paramètres de passerelle. Ses identifiants API enregistrés restent dans la base de données au cas où un chemin inverse serait ajouté à l'avenir.
• PayPal Commerce apparaît dans la liste des passerelles. Son bouton Se connecter avec PayPal est activé. Cliquez dessus pour commencer l'intégration avec PayPal.
• Jusqu'à ce que vous terminiez l'intégration, PayPal Commerce affiche un statut « non connecté » et les donateurs ne verront pas PayPal comme option de paiement sur le formulaire de don.
• Les dons enregistrés avant le changement ne sont pas affectés – ils conservent leur étiquette de passerelle d'origine et restent visibles dans vos rapports.

Comment annuler un changement

Il n'y a pas de bouton d'annulation dans l'interface utilisateur. Le changement est à sens unique dans le modèle actuel.

Si vous avez effectué le changement par erreur ou rencontré un problème inattendu, veuillez contacter notre équipe de support. Nous pouvons vous aider à restaurer directement votre configuration précédente, et nous suivons ces demandes pour déterminer si nous devrions créer un chemin de retour approprié dans une future version.

Besoin d'aide ?

Si quelque chose n'est pas clair, ou si vous souhaitez de l'aide pour effectuer le changement, notre équipe de support se fera un plaisir de vous guider. Ouvrez un ticket depuis votre compte Charitable et mentionnez « Activation de PayPal Commerce » – nous nous occuperons du reste.