✅ Validation de vos paiements
Lorsqu'un paiement checkout est validé nous redirigeons l'utilisateur sur la returnURL
défini.
Exemple : https://www.partnertest.com/return-checkout.php?type=return&checkoutIntentId=3&code=succeeded
Cependant, il n'est pas fiable d'implémenter la validation du paiement en se basant uniquement sur le code
transmis sur cette returnURL
. En effet, l'utilisateur peut perdre la connexion, fermer la page après son paiement ou falsifier ce code. Il ne peut donc être utiliser que pour afficher une page de confirmation de commande.
Afin de valider en toute sécurité le paiement, il est impératif de le réconcilier :
Via les webhook Recommandé
Recommandé
Configurez la réconciliation des paiements via webhook pour que HelloAsso envoie les événements de paiement directement à votre serveur, sans passer par le client. Les webhooks sont le moyen le plus fiable de savoir quand vous recevez le paiement. Si l’envoi d’un événement webhook échoue, nous réessayons plusieurs fois.
HelloAsso envoie deux notifications distinctes, pour permettre au partenaire de valider le statut du paiement et de la commande:
- Une notification de commande (Order)
- Une notification de paiement ainsi qu’une notification par échéance payée. (Paiement)
En savoir plus sur le système de notification.
Lors de ces notifications, l'objet metadata
transmis à l'initialisation du paiement vous sera renvoyé.
Exemple:
{
"data": {...},
"eventType": "Order",
"metadata": {
"payment_ref": 150,
"contributor_id": "1541"
}
}
Via du polling
Vous pouvez aussi implémenter un système de pooling afin de récupérer le statut du checkout initié à partir du checkoutIntentId
reçu en réponse de l’initialisation du panier
Vous pouvez le faire via un GET sur :
https://api.helloasso.com/v5/organizations/{asso-slug}/checkout-intents/{checkoutIntentId}
Vous recevrez en réponse les données suivantes :
Champs | Description |
---|---|
Id | Identifiant de la demande d’encaissement |
redirectUrl | URL de redirection vers la page d’encaissement qui a dû être donnée au contributeur |
metadata | Les metadata envoyées lors de l’initialisation du panier |
order | Le détail de la commande associée, si elle a bien été créée et que le paiement est un succès. |
Updated 3 months ago