Paiements

HelloAsso

Encaisser des paiements ponctuels par carte avec le checkout HelloAsso, réservé aux associations.

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.

Vérifiez que HelloAsso a validé votre association avant de configurer l'intégration. HelloAsso doit contrôler les associations pour lutter contre la fraude et le blanchiment.

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

  1. Ouvrez la liste Paramètres HelloAsso et créez un document.
  2. Renseignez le Nom de la passerelle de paiement, par exemple Association. Dokos crée la passerelle HelloAsso-Association.
  3. Saisissez l'Identifiant client et le Secret client. Pour tester avec un compte de test HelloAsso, cochez Utiliser la sandbox.
  4. Enregistrez. Dokos se connecte à HelloAsso et remplit le Slug de l'organisation. S'il reste vide, vérifiez les identifiants.
  5. 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.
  6. Dans la section Configuration du paiement, ajoutez un compte de paiement et un mode de paiement pour chaque société. Voir Configurer une passerelle.
  7. Dans le mode de paiement, remplissez l'onglet Portail pour la page de paiement.
  8. 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

  1. Vous créez une demande de paiement avec la passerelle HelloAsso. Dokos envoie le lien au client.
  2. Le client ouvre le lien. Dokos crée un paiement chez HelloAsso et redirige le client vers la page HelloAsso.
  3. Le client paie. HelloAsso le renvoie sur votre site et notifie Dokos à l'URL de retour.
  4. 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

  1. Cochez Utiliser la sandbox avec les identifiants d'un compte de test HelloAsso.
  2. Créez une commande client ou une facture de vente, puis une demande de paiement.
  3. 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

MessageCause
« 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 attenteL'URL de notification n'est pas renseignée chez HelloAsso, ou le paiement n'est pas encore validé.
HelloAsso refuse la deviseHelloAsso accepte seulement l'euro.