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.

Éligibilité des associations à recevoir des paiements

❗️

À partir de juin 2025 et conformément à l'article L561-5 du Code monétaire et financier, toute nouvelle association inscrite devra être vérifiée avant de pouvoir recevoir un paiement.

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

Si une associationn'a pas l'autorisation de recevoir des paiements:

• vous pouvez la rediriger vers son espace de vérification HelloAsso en utilisant l'URL suivante : https://admin.helloasso.com/OrganizationSlug/verification
• Il ne sera plus possible de générer un checkout pour cette association. Dans ce cas, une erreur 409 sera renvoyée.

Vérifiez que l'association peut recevoir des paiements

Via le compte HelloAsso de l'association

Si vous êtes une association, vous pouvez vérifier dans le back-office de votre association si vous avez bien le statut vérifié. Si c'est le cas, 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/<OrganisationSlug>/verification
  Elle pourra ainsi compléter ses informations de vérification.

Via notification

À chaque fois qu'un changement de CashinCompliance a lieu, une notification est envoyée. Vous pouvez ainsi mettre à jour l'éligibilité de l'association au paiement.

Voir un exemple ici

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 :

Payer avec

Paiement sécurisé

Voir le code HTML

Intégrez une explication sur la contribution volontaire

Utiliser 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.

Exemple

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