Skip to main content
Les endpoints de statut sont toujours disponibles. Pour une experience plus reactive, configurez aussi une URL de notification cote marchand lorsque votre dashboard ou votre integration le permet.

​
Role du webhook

Un webhook informe votre backend lorsqu’une transaction change d’etat. Il ne remplace pas votre endpoint de statut; il le complete. Votre traitement webhook doit:
  • repondre rapidement avec HTTP 200;
  • etre idempotent;
  • enregistrer le payload brut;
  • contenenir le header de x-private-key;
  • verifier ensuite le statut via l’API Mysoleas si l’action est sensible;
  • ignorer les duplications deja traitees.

​
Payload recommande cote marchand

Selon le provider et le flux, le payload peut varier. Structurez votre traitement autour des champs stables.

​
Validation d’une notification

Premiere étape, veuillez hasher votre token webhook en sha256.
Ensuite vous devez comparer la valeur du header x-private-key avec le resultat obtenus.
Si vous n’optenez pas la meme valeur alors ignorer cette notification car elle est illégitime et ne provient peut être pas de nous.

​
Verification defensive

Apres reception d’un webhook critique, appelez le statut.
Cette verification evite de traiter un payload incomplet ou un webhook rejoue.

​
Reponse attendue

Votre endpoint webhook doit retourner 200 des que l’evenement est bien recu.

​
Unités monétaires des notifications

Les notifications de transaction et de souscription portent des montants en valeur réelle : 4.01 pour 4,01 USD/EUR. Le core convertit le montant avant de publier l’événement. Votre récepteur doit conserver les décimales et ne doit pas diviser à nouveau ce montant par 100. Les callbacks bruts du provider conservent le contrat propre au provider. Consultez les montants et devises.