Après 6 années de bons et loyaux services, nous allons débrancher notre API V3 le 30 juin 2025.

Cette API, obsolète depuis plus de 4 ans, a été remplacée par notre API V5, qui est non seulement plus performante, mais également plus sécurisée et riche en fonctionnalités.

Pour les derniers nostalgiques, nous vous encourageons vivement à migrer vers l’API V5 dès que possible pour bénéficier de ces améliorations et assurer la continuité de vos services.

📘

Nous vous assurons qu’aucune des routes définies de l'API V5 ne sera affectée par cette opération.

Nous avons corrigé le retour du point d'API organizations/{organizationSlug}/payments afin qu'il retourne les paiements au statut PENDING. Ces paiements correspondent à des paiements par échéance prévus à une date future.

C’est une fonctionnalité que beaucoup attendaient pour renforcer la sécurité de vos intégrations : nous sommes ravis de vous annoncer la mise en place des signatures sur nos notifications !

🔍 Pourquoi c’est top ?

Grâce à cette signature, vous pouvez désormais être sûr(e) qu’une notification provient bien de HelloAsso, et éviter tout risque de falsification. La signature est ajoutée automatiquement dans le header de chaque notification envoyée.

🔑 Comment récupérer votre clé de signature ?

Utilisez le endpoint pour récupérer toutes les informations d'un partenaire, les clés de signature de chacune de vos URL de notification sont renvoyées par ce endpoint.

🚦

Disponible en avant-première pour nos partenaires

Pour l’instant, cette fonctionnalité est déployée uniquement pour nos partenaires.

📚 Envie d’en savoir plus ?

Découvrez tous les détails dans notre documentation. C’est par ici 🚀

Afin d’optimiser les performances, nous allons amorcé la dépréciation des champs TotalCount et TotalPages renvoyés sur les routes suivantes :

• GET organizations/{organizationSlug}/payments
• GET /organizations/{organizationSlug}/forms/{formType}/{formSlug}/payments
• GET /organizations/{organizationSlug}/forms/{formType}/{formSlug}/items
• GET /organizations/{organizationSlug}/items
• GET /organizations/{organizationSlug}/forms/{formType}/{formSlug}/orders
• GET /organizations/{organizationSlug}/orders

Calendrier de la transition 📆

N'hésitez à nous écrire directement à [email protected] si vous avez la moindre remarque sur le sujet.

Sur les campagnes Helloasso, il est possible de demander aux utilisateurs de joindre un fichier, dans les informations complémentaires, avant de procéder au paiement.
Ce point d'API permet de les récupérer.

Vous pouvez désormais accéder à ces fichiers, via le point API permettant de récupérer le détail d'une d'une commande:

Pour cela:

1. Générez un token ayant les droits organization_admin (avec une clé API association ou une mire d'authorisation)
2. Faites un appel API avec le token pour récupérer les détails d'une commande (avec ce point d'API par exemple)
3. Récupérez le fichier via son URL et en passant le token, comme décrit sur cette page.

Pour plus d'information, vous pouvez consulter cette page.

Nous avons mis en place deux nouveaux types de notifications afin de vous permettre d'en savoir plus sur l'état de vos paiements via les notifications.

La liste des types de notification s'agrémente donc de:

Remboursement refusé 🚫

Lorsqu'un remboursement n'a pas peu être fait sur le compte du payeur.

Paiement contesté 🧐

Lorsqu'un paiement est contesté par le payeur auprès de sa banque.

Vous trouverez ici toutes les nouveautés de l'API HelloAsso.