Adyen

Comment gérer l'abandon de la solution actuelle d'idempotence d'Adyen ?

Pourquoi changeons-nous notre solution d'idempotence ?

Adyen a développé un nouveau framework d'idempotence capable de mieux s'adapter à la croissance de notre plateforme. Ce nouveau framework permet un meilleur traitement synchrone, ainsi qu'une logique de relance des transactions et une résilience améliorées.

Avec la mise en place de ce nouveau framework d'idempotence, la solution d'idempotence existante sera bientôt abandonnée. Les marchands qui utilisent notre ancienne solution devront revoir leur intégration et procéder aux mises à jour nécessaires.

Quand ces changements prendront-ils effet ?
L'abandon de la solution d'idempotence existante se fera en deux étapes :

Environnement de test – La solution existante sera abandonnée d'ici le mercredi 1er juillet
Environnement live – La solution existante sera abandonnée d'ici le jeudi 15 septembre

Notre nouveau framework d'idempotence est déjà disponible pour les marchands, aussi bien dans l'environnement test que dans l'environnement live. Vous trouverez ci-dessous les dates correspondant aux deux étapes de la migration :

Jusqu'au 30 juin 2020

1^er juillet 2020

Jusqu'au 14 septembre 2020

15 septembre 2020

Environnement de test

Les marchands mettent à niveau le framework de test et migrent vers la nouvelle solution

Abandon de la solution existante

Environnement de production

Les marchands mettent à niveau le framework live et migrent vers la nouvelle solution

Abandon de la solution existante

Quelles sont les principales différences techniques entre les deux solutions d'idempotence ?

Le tableau ci-dessous vous offre un aperçu des principales différences techniques :

Framework d'idempotence existant

Nouveau framework d'idempotence

En-tête de requête http

Utilise une clé pragma http avec une valeur d'en-tête de directive pragma

L'en-tête n'est inclus que lors des relances
L'utilisation de l'en-tête fait basculer le traitement de synchrone à asynchrone

Utilise une clé d'idempotence http avec un identifiant unique fourni par vous

L'en-tête est envoyé dans toutes les requêtes
L'utilisation de l'en-tête n'affecte pas le traitement synchrone

Traitement des relances

Envoie une notification de code d'événement PROCESS_RETRY en plus de la notification habituelle des requêtes

Envoie la notification habituelle utilisée pour les demandes d'autorisation

Gestion et traitement des erreurs

Non applicable

Fournit des erreurs de réponse pour une meilleure logique de relance

Identifiant unique de la transaction

Utilise le compte et la référence unique du marchand pour identifier une transaction spécifique

Utilise une clé d'idempotence créée par le marchand qui est généralement générée par le biais d'un type d'identifiant unique universel (aléatoire) de version 4*

* Veuillez noter que le service d'idempotence d'Adyen est spécifique à chaque région. Par conséquent, si vous opérez dans plusieurs régions, les clés d'idempotence uniques fournies par le marchand ne doivent pas être utilisées dans d'autres zones géographiques.

Où puis-je trouver plus d'informations sur la dernière solution d'idempotence d'Adyen ?

Pour plus d'informations, veuillez consulter la page suivante : Idempotence de l'API.

Veuillez noter que le service d'idempotence d'Adyen est spécifique à chaque région. Par conséquent, si vous opérez dans plusieurs régions, les clés d'idempotence uniques fournies par le marchand ne doivent pas être utilisées dans d'autres zones géographiques.

Pour plus de détails sur les clés d'idempotence, consultez cette page : Portée et durée de validité des clés.

Quelles sont les prochaines étapes à suivre dans le cadre de ce changement ?

Notre nouveau framework d'idempotence est déjà disponible, aussi bien dans l'environnement test que dans l'environnement live. Votre équipe technique ou votre intégrateur peut déjà commencer à vérifier l'intégration de vos paiements pour identifier les modifications qui doivent être apportées et les tester avec nos points de terminaison.