Récupérer la clé d'API

Pour commencer il vous faut récupérer votre identifiant et votre clé secrète d'accès à l'API HelloAsso.

1. Connectez-vous à la gestion de votre association sur HelloAsso
2. Dans le menu, cliquez sur Mon compte, puis sur Intégrations et API
3. Si nécessaire, cliquez sur le bouton Générer ma clé API
4. Une fois la clé générée, copiez le Client ID
5. Puis copiez le Client Secret

Vous pouvez également vous référer au tuto vidéo de HelloAsso pour plus d'aide.

Renseigner la clé d'API dans l'extension

Si vous ne l'avez pas encore fait, activez l'extension HelloAsso dans Paheko, via le menu Configuration onglet Extensions sous-onglet Inactives. Cliquez sur Activer en face de « HelloAsso ».

• Dans l'extension HelloAsso de Paheko, rendez-vous dans l'onglet Configuration sous-onglet Connexion à HelloAsso.
• Recopiez ensuite le Client ID et le Client Secret fournis par HelloAsso à l'étape précédente.
• À moins de savoir ce que vous faites, laissez décochée la case "Utiliser l'environnement de test" ;-)
• Cliquez sur Enregistrer pour terminer la connexion à HelloAsso.

Vous pouvez ensuite réaliser votre premier rechargement des données HelloAsso.

Note sur la sécurité des données

Il est important de ne pas laisser la clé (ID) et le secret d'accès à l'API à n'importe qui : ne les notez pas dans un fichier texte sur votre ordinateur, ne les transmettez pas dans un e-mail, ou par téléphone. En effet ils sont aussi importants et secrets qu'un mot de passe.

L'accès à l'API permet de lister les commandes et paiements HelloAsso, de créer des paiements (Checkout) et de procéder à des remboursements. Il ne permet pas de modifier ou supprimer des commandes, paiements ou adhésions.

Quand vous transmettez votre identifiant et votre clé secrète à l'extension Paheko, la clé secrète est échangée pour un jeton à validité limitée par le serveur de HelloAsso. Ce jeton est ensuite chiffré avant d'être enregistré en base de données. La clé secrète n'est jamais conservée par Paheko.

Si vous souhaitez désinstaller l'extension Helloasso de Paheko et vous assurer que l'accès à l'API HelloAsso n'est plus possible par Paheko, il est possible de supprimer la clé d'API dans l'administration HelloAsso. Cela empêchera tout accès qui utiliserait les anciens identifiants d'accès à l'API.