Publié à l’origine le 1er mars 2020
Vous est-il déjà arrivé de suivre un match sur votre téléphone en rafraîchissant sans cesse la page pour vérifier si votre équipe a marqué des points ? Vous n’arrêtez pas de rafraichir la page, et pourtant le score reste le même. Ne serait-il pas plus judicieux de recevoir une notification lorsque le score change ? Ce concept est similaire à l’expérience Notifications de paiement instantané d’Amazon Pay. Cependant au lieu de recevoir le score d’un match, vous recevez des informations actualisées sur votre commande/transaction.
Que sont les Notifications de paiement instantané ?
Les Notifications de paiement instantané d’Amazon Pay ou IPN sont envoyées en toute sécurité dès que votre paiement change de statut. Ces notifications sont utiles pour automatiser les processus back-end lorsque certains événements concernant le paiement surviennent. Voici quelques exemples d’envoi d’IPN :
- Une autorisation en attente est approuvée
- Un remboursement est en cours
- Une saisie en attente est rejetée.
Une liste complète de notifications et de tous les exemples de cas est disponible ici.
À quoi servent les IPN ?
Un développeur peut se servir des IPN pour synchroniser les systèmes back-end avec les modifications de statut de commandes Amazon Pay. Il est possible de coder pour mettre à jour les systèmes avec les données de transactions d’Amazon Pay. Exemples de systèmes qui sont généralement intégrés à Amazon Pay :
- logiciel de comptabilité
- service d’expédition/d’exécution des commandes
- gestion des commandes et de l’inventaire
- services d’e-mails
Comment activer les IPN
La configuration de votre compte Amazon Pay est simple : identifiez-vous sur Seller Central et saisissez votre URL marchand pour gérer les notifications dans les paramètres d’intégration IPN. Un guide complet pour la configuration des IPN est disponible ici. À partir de maintenant, vous recevrez des IPNs à l’URL du commerçant fourni.
Conseils pour l’intégration des IPN
Afficher les IPN sans avoir à coder
Au moment de tester votre workflow de réception d’IPN, il est utile de créer un intercepteur web temporaire pour analyser le type de notifications reçues. Il existe de nombreux outils qui permettent de configurer facilement et rapidement un intercepteur web temporaire. Ces outils génèrent une URL afin d’accéder à la configuration de votre Seller Central. Une fois l’accès autorisé, vous pouvez observer l’arrivée de toutes les notifications sur le site web de l’intercepteur. Voici quelques exemples de sites :
REMARQUE : Utiliser ces outils pour tester les transactions uniquement en mode d’environnement test. Les paramètres des IPN de production doivent toujours être reliés à un intercepteur web sécurisé qui vous appartient. Les intercepteurs web temporaires cités en exemples ne doivent être utilisés qu’à des fins de tests uniquement.
Envoi d’IPN à votre système local lors du développement
Les IPN Amazon Pay sont uniquement envoyés à des points de terminaison HTTPS. Ainsi, vous vous demandez sans doute comment tester votre code local avec de vrais exemples d’IPN. Les outils de tunneling de localhost permettent de passer votre intercepteur web local en mode public pendant les phases de développement et de test. Ces outils génèrent un point de terminaison HTTPS pour intercepter les IPN. Lorsque les outils sont utilisés sur votre système local, les IPN qui sont envoyés aux points de terminaison HTTPS sont automatiquement transférés vers votre système local, ce qui permet de recevoir facilement les IPN et les messages de débogage dans votre environnement de développement. Si votre système utilise un intercepteur web local avec l’URL http://localhost, Amazon Pay n’aura aucun moyen d’envoyer des IPN à votre système. Quelques exemples d’outils que vous pouvez utiliser pour le tunneling localhost :
Outils pour modifier le statut des transactions afin de générer des notifications IPN
Amazon Pay utilise des outils pour faciliter la création et la modification du statut des commandes test. Ces outils facilitent vos tests et vous permettent de simuler des actions afin de déclencher l’envoi d’une notification. Voici certains des outils que vous pouvez utiliser pour les tests :
- MWS Scratchpad, pour générer rapidement des requêtes API à Amazon Pay et simuler des changements de statut
- Remarque : Vous devrez choisir « En dehors de l’environnement test Amazon Pay » dans la liste déroulante de la section API afin d’envoyer des requêtes dans l’environnement test.
- Amazon Pay SDKs, pour analyser les IPN et faire des requêtes à l’API Amazon Pay
Puis-je synchroniser mes systèmes sans IPN ?
Les IPN ne sont pas le seul moyen de synchroniser les données Amazon Pay avec vos systèmes. Une autre technique est appelée « polling » : le code est exécuté à intervalles réguliers et demande les dernières données de transaction. Ceci correspond tout à fait à l’exemple du début concernant la mise à jour du score d’un match. Le polling peut être configuré à l’intervalle de votre choix, ou même par backoff exponentiel, c’est-à-dire que les temps de requête augmentent chaque fois que le résultat indique qu’aucun changement ne s’est produit. Le polling est également utile comme système de sauvegarde d’IPN. Si un incident s’est produit avec un intercepteur web d’IPN, mettre en place un processus qui vérifie régulièrement s’il y a eu des mises à jour permet de s’assurer que cette mise à jour a été reçue pendant le temps d’arrêt de l’intercepteur web.
Facile à configurer, mises à jour en temps réel
Les notifications de paiement instantané d’Amazon Pay constituent une excellente façon de synchroniser vos systèmes avec les dernières données de transaction de toutes vos commandes Amazon Pay. Elles sont faciles à configurer et assurent une mise à jour en temps réel afin que vos systèmes soient toujours à jour. Tenez-vous au courant des dernières nouveautés et améliorations de notre système IPN et en attendant bon codage !
