HelloAsso
HelloAsso
S'applique à : associations dont le compte HelloAsso est vérifié. Paiements en euros uniquement.
Le checkout HelloAsso permet à vos adhérents et clients de payer par carte bancaire. HelloAsso ne prélève pas de frais à l'association. Le payeur peut laisser une contribution volontaire à HelloAsso.
Ce que l'intégration permet
- Payer une Demande de paiement liée à une commande client ou une facture de vente, par un lien de paiement.
- Payer une commande sur le portail ou le site, si le mode de paiement HelloAsso y est autorisé.
HelloAsso n'enregistre pas la carte pour un paiement futur. Pour un abonnement à prélèvement automatique, choisissez une autre passerelle, par exemple GoCardless ou Stripe. Aucune donnée de carte n'est enregistrée dans Dokos.
Prérequis
- Un compte association HelloAsso vérifié.
- Le site Dokos est en HTTPS. Sinon, Dokos refuse de créer le paiement.
- L'identifiant client et le secret client, dans la section Intégrations et API de votre compte HelloAsso.
Configurer HelloAsso
- Ouvrez la liste Paramètres HelloAsso et créez un document.
- Renseignez le Nom de la passerelle de paiement, par exemple
Association. Dokos crée la passerelle HelloAsso-Association. - Saisissez l'Identifiant client et le Secret client. Pour tester avec un compte de test HelloAsso, cochez Utiliser la sandbox.
- Enregistrez. Dokos se connecte à HelloAsso et remplit le Slug de l'organisation. S'il reste vide, vérifiez les identifiants.
- Copiez l'URL de retour affichée dans le document. Dans votre compte HelloAsso, collez-la comme URL de notification de l'API. HelloAsso y signale chaque paiement à Dokos.
- Dans la section Configuration du paiement, ajoutez un compte de paiement et un mode de paiement pour chaque société. Voir Configurer une passerelle.
- Dans le mode de paiement, remplissez l'onglet Portail pour la page de paiement.
- Si vos clients paient en ligne, autorisez ce mode de paiement dans les paramètres du panier ou de l'e-commerce.
Le parcours de paiement
- Vous créez une demande de paiement avec la passerelle HelloAsso. Dokos envoie le lien au client.
- Le client ouvre le lien. Dokos crée un paiement chez HelloAsso et redirige le client vers la page HelloAsso.
- Le client paie. HelloAsso le renvoie sur votre site et notifie Dokos à l'URL de retour.
- Dokos interroge HelloAsso pour vérifier le statut. Si le paiement est validé, la demande de paiement passe à Payé et Dokos crée l'écriture de paiement.
Dokos vérifie toujours le statut auprès de HelloAsso. Une notification seule ne suffit pas à marquer un paiement comme payé.
Si la commande ou la facture a un contact et une adresse, Dokos préremplit le nom, l'email et l'adresse du payeur chez HelloAsso. Un nom refusé par HelloAsso (un chiffre, une seule lettre, « test », « nom »…) n'est pas transmis : le payeur le saisit lui-même.
Exemple
L'association Les Ateliers du Quai (exemple fictif) facture une cotisation annuelle de 30 €. La trésorière crée la facture de vente, puis une demande de paiement avec la passerelle HelloAsso-Association. L'adhérent reçoit l'email, paie par carte sur la page HelloAsso et revient sur le site. La demande de paiement passe à Payé et la facture est soldée.
Tester
- Cochez Utiliser la sandbox avec les identifiants d'un compte de test HelloAsso.
- Créez une commande client ou une facture de vente, puis une demande de paiement.
- Ouvrez le lien de paiement dans une fenêtre de navigation privée et payez avec une carte de test HelloAsso.
Problèmes fréquents
| Message | Cause |
|---|---|
| « Le Checkout HelloAsso ne peut être utilisé qu'avec un site sécurisé via HTTPS. » | Le site n'est pas en HTTPS. |
| « La configuration du checkout HelloAsso n'est pas terminée… » | Le slug de l'organisation est vide. Vérifiez les identifiants et enregistrez de nouveau. |
| Le paiement reste en attente | L'URL de notification n'est pas renseignée chez HelloAsso, ou le paiement n'est pas encore validé. |
| HelloAsso refuse la devise | HelloAsso accepte seulement l'euro. |