Module HelloAsso FR

Informations

Module name	HelloAsso
Editor / Editeur	DoliCloud - www.dolicloud.com
Download or buy page / Page achat ou téléchargement
Status / Statut / Estado	Stable
Prerequisites / Prérequis	Dolibarr min version: 21
Last update date / Date mise à jour fiche / Fecha última actualización	2026-05-4
Note / Nota

Fonctionnalités

Prise en charge de la page de paiement en ligne HelloAsso (cartes bancaires) dans Dolibarr. Cela permet à vos clients d'effectuer via HelloAsso des paiements ponctuels ou liés à un objet Dolibarr spécifique (facture, commande, etc.).

Synchronisation automatique des membres depuis HelloAsso, avec envoi de rappel par e-mail à échéance de la cotisation.

Émission automatique des factures d'adhésion (ajout des tiers et des paiements inclus)

Ce module est utilisable sur votre propre Dolibarr mais aussi disponible par défaut dans DoliAsso, le service gratuit de gestion des petites associations : https://www.doliasso.org

Installation

From the application

Download the archive file of module (.zip file)
Go on menu Home -> Setup -> Modules -> Deploy external module and submit the file.
Module is then visible into list of available modules (Home -> Setup -> Modules) and can be activated.

Manually

Download the archive file of module (.zip file)
Put the file into the root directory of Dolibarr.
Uncompress the archive file, for example with command

unzip modulefile.zip

Module is then visible into list of available modules (Home -> Setup -> Modules) and can be activated.

Configuration

To use this module, you must first enable it using an administrator account, via the menu option "Home - Setup - Modules".

Choose the tab where the module is listed. Then click on "Activate".

The module is now activated.

If a cog icon appears on module thumb or at end of the line of the module, click on it to access the setup page specific to the module.

Configuration de l'API HelloAsso

Configuration obligatoire de l'API

Générer les deux clés API nécessaires au paiement en ligne avec HelloAsso. Vous les trouverez sur votre tableau de bord HelloAsso :

Accédez d'abord à la page de l'association (créez-en une depuis le menu « Mes identifiants - Gérer l'association - Ajouter une association »).
Une fois sur la page d'une association, accédez au menu « Mon compte > Intégrations et API ».

Configuration optionnelle de l'API pour la synchronisation des adhésions

Si vous souhaitez que les adhésions HelloAsso soient importées dans Dolibarr automatiquement, vous avez également besoin de relever le nom de votre formulaire d'adhésion HelloAsso :

Accédez d'abord à la page de l'association (ou bien créez-en une depuis le menu « Mes identifiants - Gérer l'association - Ajouter une association ».)
Une fois sur la page d'une association, accédez au menu « Mes adhésions » (créez-en une depuis le bouton « Créer une adhésion »).
Cliquez ensuite sur « Gérer ».
Comme encadré en vert sur la capture d'écran, relevez le « slug » du formulaire d'adhésion à utiliser ultérieurement lors de la configuration. Le « slug » à relever ne comporte pas d'espace, par exemple formulaire-de-cotisation-a-superasso

Configuration du module Dolibarr

Accès à la configuration du module

1) Créez un compte bancaire dédié à HelloAsso dans « banque | Caisses » puis « Nouveau compte », pour enregistrer les paiements effectués via HelloAsso.

2) Accédez à la page de configuration du module HelloAsso dans Dolibarr

3) Définissez le compte bancaire créé comme compte bancaire par défaut

Configuration du mode sandbox

4) Connectez-vous ensuite à votre compte HelloAsso-sandbox pour obtenir et remplir les trois champs suivants dans Dolibarr :

Nom de l'organisation cliente (pour laquelle vous souhaitez effectuer le paiement. Vous trouverez ce nom dans la section Mon compte - Mon association)
Clé de test de l'identifiant client (carré bleu sur l'image)
Clé secrète de test du client (carré rouge sur l'image)

Les deux clés (identifiant client et clé secrète) se trouvent sur votre compte HelloAsso-sandbox, dans le menu « Mon compte > Intégrations et API » de la page Organisation.

Configuration du mode live

5) Activez ensuite le mode live en activant le bouton « Helloasso On/Live ».

6) Connectez-vous ensuite à votre compte HelloAsso pour obtenir et remplir les trois champs suivants dans Dolibarr :

Nom de l'organisation cliente (pour laquelle vous souhaitez effectuer le paiement. Vous trouverez ce nom dans la section Mon compte - Mon association)
Clé d'identification client (carré bleu sur l'image)
Clé secrète client (carré rouge sur l'image)

Les deux clés (identifiant client et clé secrète) se trouvent sur votre compte HelloAsso-sandbox, dans le menu « Mon compte > Intégrations et API » de la page Organisation.

Optionnel : Configuration de la synchronisation des membres et de l'envoi d'un e-mail de rappel à expiration de l'adhésion

Poursuivez la configuration optionnelle si vous souhaitez synchroniser également la liste des membres :

7) Ouvrez l'onglet "Paramètres de synchronisation" de la même page de configuration

8) Saisissez le « slug » du formulaire de test et celui du formulaire live relevés précédemment dans la configuration de l'API HelloAsso (le slug ne comporte pas d'espace)

9) Avancé et optionnel : Si vous avez des champs personnalisés ou si vous avez des types de membres existants à préserver dans Dolibarr, référez-vous aux configurations avancées de correspondance ci-dessous. Sinon, passez à l'étape 10.

10) Utilisez le bouton « Tester l'obtention des membres HelloAsso » pour vérifier que la synchronisation fonctionne

11) Si le test est réussi, vous pouvez automatiser la synchronisation à intervalles réguliers avec le module « Travaux planifiés ». Pour activer la tâche planifiée :

Accédez à la configuration du module « Travaux planifiés ». Accédez à l'onglet « Travaux planifiées ».
Recherchez ensuite la tâche quotidienne intitulée « HelloAssoGetNewMembers ». Si elle n’apparaît pas, veuillez désactiver puis réactiver le module HelloAsso pour la créer automatiquement.
Ne modifiez aucune configuration, à l'exception de « Exécuter la tâche toutes les » et de « Prochaine exécution ».
- « Exécuter la tâche toutes les » définit la fréquence d'exécution de la tâche.
- « Prochaine exécution » définit la date de la prochaine exécution (après la première exécution, ce champ sera automatiquement mis à jour).
- Une fois la configuration terminée, cliquez sur « Lancer maintenant » pour lancer la tâche planifiée manuellement

12) Si vous souhaitez que les membres reçoivent un e-mail automatique de rappel à expiration de leur adhésion :

Toujours dans « Travaux planifiées », activez la tâche « Envoyer un rappel par e-mail pour l'adhésion expirée »

Avertissement : Pour que les deux tâches quotidiennes soient bien exécutée automatiquement, Dolibarr doit être correctement connecté au Crontab du serveur

Optionnel : Création de facture payée automatiquement à la synchronisation d'un membre

Cette configuration vous permet de créer automatiquement une facture d'adhésion à chaque fois qu'un de vos membres adhère via votre formulaire Dolibarr. Vous pouvez également faire saisir automatiquement le paiement associé ou conserver la facture impayée.

12) Dans la configuration du module HelloAsso, dans l'onglet « Paramètres d'adhésion », choisissez une « Action complémentaire lors de la synchronisation des membres » à savoir :

Aucun
Création d'une écriture directe sur le compte bancaire ou caisse
Création de facture sans paiement
Création d'une facture avec paiement sur compte bancaire ou caisse

13) Enregistrez

Configuration avancée des correspondances entre HelloAsso et Dolibarr

Correspondance des types de membres HelloAsso et Dolibarr (avancé)

Cette configuration n'est utile que si vous avez des types existants déjà dans Dolibarr que vous souhaitez relier aux types HelloAsso futurement importés. En l'absence de correspondance, la fonction de synchronisation créera un nouveau type de membre dans Dolibarr. C'est pourquoi la saisie de cette correspondance est inutile si vous n'avez pas déjà fait des saisie de types et membres dans Dolibarr.

1) Vous devez d'abord obtenir l'identifiant du type de membre HelloAsso :

Chargez les outils de développement dans votre navigateur, en étant connecté à un compte administrateur HelloAsso de votre organisation (F12 sur Mozilla Firefox).

Cliquez sur l'onglet Réseau.
Remplacez les valeurs entre <> par votre formulaire d'adhésion : (Exemple : https://admin.helloasso-sandbox.com/MyAssociation/adhesions/adhesion-helloasso/edition/2)
- https://admin.helloasso.com/<Nom de l'organisation>/adhesions/<Nom du formulaire d'adhésion>/edition/2 et chargez-le.
- Ou, pour le mode sandbox, https://admin.helloasso-sandbox.com/<Nom de l'organisation>/adhesions/<Nom du formulaire d'adhésion>/edition/2 et chargez-le.
Identifiez le Le fichier tiers renvoie un type JSON et parcourez tous les niveaux disponibles dans l'onglet Réponse. L'identifiant du niveau se trouve dans le champ id:.

2) Ensuite, dans la configuration du module HelloAsso, dans l'onglet Paramètres d'adhésion, recherchez le Dictionnaire de HelloAsso et la partie Correspondance des types de membres Dolibarr.

3) Remplissez les deux champs :

Sélectionnez le type de membre Dolibarr à lier.
Remplissez le champ avec l'identifiant du type de membre HelloAsso à lier.

4) Cliquez sur le bouton Enregistrer pour enregistrer votre configuration.

Correspondance des champs personnalisés des formulaires HelloAsso (avancé)

Cette configuration peut être omise si vous n'avez pas de champs personnalisés dans le formulaire HelloAsso à synchroniser avec les champs de Dolibarr.

Pour lier un champ de membre Dolibarr à un champ personnalisé HelloAsso :

1) Vous devez d'abord obtenir le slug du champ personnalisé HelloAsso :

Connectez-vous au tableau de bord HelloAsso et accédez à la page de l'association.
Une fois sur la page d'une association, accédez au menu « Mes adhésions ».
Cliquez ensuite sur « Gérer ».
Cliquez ensuite sur l'étape 3 « Informations complémentaires ».
Vous devez voir la page d'informations concernant vos membres. Consultez la section « Informations à fournir » ; vous y trouverez tous les slugs des champs personnalisés.

2) Accédez ensuite à la configuration du module HelloAsso, dans l'onglet « Paramètres d'adhésion ». Trouvez la section « Dictionnaire des champs personnalisés HelloAsso et des correspondances des champs Dolibarr »

3) Renseignez les deux champs :

Le champ de sélection doit contenir le champ membre Dolibarr à lier.
Remplissez le champ avec les slugs des champs personnalisés HelloAsso à lier.

4) Cliquez sur le bouton « Enregistrer » pour enregistrer votre configuration.

Utilisation

Utilisation de la page de paiement en ligne HelloAsso

Pour utiliser le module, il vous suffit d'utiliser un lien Dolibarr par défaut pour effectuer un paiement en ligne. Tous les liens fournis par Dolibarr pour effectuer un paiement en ligne sont compatibles avec HelloAsso.

Voici un exemple de page de paiement client :

Développement et contributions

Le développement de cette application Open Source n'est pas inclus dans le dépôt GIT standard de Dolibarr, mais dans un dépôt dédié aux modules non pris en charge par l'équipe de développement de Dolibarr, mais pris en charge par https://www.dolicloud.com sur GitHub :

Dépôt : https://github.com/Dolibarr/dolibarr-community-modules

La documentation de l'API HelloAsso est disponible ici : https://centredaide.helloasso.com/association?question=comment-fonctionne-l-api-helloasso

Vos demandes de correction ou d'amélioration sont les bienvenues.