Guide d'intégration

Pour intégrer au mieux votre connecteur HelloAsso et offrir à vos associations un parcours utilisateur fluide et efficace, nous vous invitons à suivre les conseils suivants.

Vérifiez que l'association peut recevoir des paiements

❗️

Vérification des associations obligatoire

(selon l'article L561-5 du Code monétaire et financier)

À partir de juin 2025, toute nouvelle association inscrite devra être vérifiée avant de pouvoir recevoir un paiement.

Nous vous conseillons de vérifier si l'association à le droit de recevoir des paiements en amont des premiers paiements, lors de la liaison mire par exemple.

Via le compte HelloAsso de l'association

Si vous êtes une association, vous pouvez vérifier dans le BackOffice de votre association si vous avez bien le statut vérifié, si oui vous pouvez alors recevoir des paiements. Voir cet article du centre d'aide.

Via API

Pour une utilisation via API, vous pouvez utiliser ce point d'API, qui renvoie le champ isCashInCompliant (true ou false).

  • À noter que ce champ n'est renvoyé que si vous possédez le rôle OrganizationAdmin, obtenu via l'utilisation d'une clé association ou d'un token issu d'une mire d'autorisation.
  • Dans le cas d'une association n'ayant pas l'autorisation de recevoir des paiements, vous pouvez la rediriger vers son espace de vérification sur HelloAsso avec l'URL suivante: https://admin.helloasso.com//verification
    Elle pourra ainsi compléter ses informations de vérification.

Intégrez le bouton "Payer avec HelloAsso"

Afin de rassurer les utilisateurs sur le mode de paiement qu'ils s'apprêtent à utiliser nous vous conseillons d'utiliser notre bouton de paiement:

Paiement sécurisé Logo Visa Logo Mastercard Logo CB Logo PCI

Voir le code HTML

Intégrez une explication sur la Contribution Volontaire

Intégrer HelloAsso, c’est rejoindre un système solidaire, financé uniquement par les contributions volontaires des utilisateurs, afin d’offrir des services en ligne, de qualité et gratuits aux associations.

En le rejoignant, vous ferez bénéficier à vos associations de ce modèle solidaire, leur permettant de collecter sans frais des paiements en ligne.

Il est donc primordial de communiquer sur ce modèle, pour informer les utilisateurs de la portée de leurs paiements.

🤝

Texte à intégrer sur la page panier, avant le paiement via HelloAsso

Le modèle solidaire de HelloAsso garantit que 100% de votre paiement sera versé à l’association choisie. Vous pouvez soutenir l’aide qu’ils apportent aux associations en laissant une contribution volontaire à HelloAsso au moment de votre paiement.

Cette phrase pourra par exemple se trouver au niveau du choix du mode de paiement.


Lorsque vous implémentez une connexion à HelloAsso via l’API dans un outil pour les associations, il est essentiel que celles-ci puissent identifier HelloAsso et son modèle économique, afin qu’elles puissent communiquer sur ce sujet à leurs publics et ainsi, éviter toute incompréhension ou friction.

Il est donc nécessaire d’intégrer la phrase suivante dans le parcours de l’association, soit dans la page de liste de modules, soit au clic en pop up ou au survol :


🤝

Texte à intégrer en back office de l'outil

“HelloAsso aide les associations à collecter des paiements en ligne et propose ses services gratuitement. Elle prend à sa charge tous les frais de transaction pour que vous puissiez bénéficier de la totalité des sommes versées par vos publics, sans frais. Les contributions volontaires laissées par ces derniers sont leur unique source de revenus.”

Cette phrase pourra par exemple se trouver dans la bibliothèque de modules, dans la page de connexion à HelloAsso. .


Voici un exemple d'intégration dans un parcours de commande :

Exemple d'intégration réalisée par notre partenaire Illisite dans le cadre de la refonte d'un site d'une fédération professionnelle.

Exemple d'intégration réalisée par notre partenaire Illisite dans le cadre de la refonte d'un site d'une fédération professionnelle.