✅ 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é

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 :