Environnement API et versioning

Target most up-to-date API base URL

We highly recommend targeting the most up-to-date API base URL when making requests to our platform. Using the latest API version ensures access to the latest features and enhancements.

To allow you a smooth transition, previous API base URLs remain available until further notice.

Environnements et API endpoints

Pour notre environnement de production, nous prenons également en charge des API endpoints spécifiques aux centres de données. Nous avons créé deux clusters répartis sur plusieurs centres de données.

Vous pouvez vous connecter à deux environnements différents, chacun avec ses propres caractéristiques : 

1. Environnement de test 

• But : Tester et finaliser l'intégration. 
• URL :  https://payment.preprod.direct.worldline-solutions.com/v2/ (API endpoint européen générique)
• Caractéristiques :
  • Les transactions n'ont aucun impact financier. 
  • La configuration est personnalisable selon vos préférences. 
  • Accès complet à l'environnement de test. 
  • Support complet. 

2. Environnement de production 

• But : Traiter des transactions en production. 
• URL :  https://payment.direct.worldline-solutions.com/v2/ (API endpoint européen générique)
• Caractéristiques : 
  • Les transactions ont un impact financier. 
  • La configuration est personnalisable selon vos préférences. 
  • Accès complet à l'environnement en production. 
  • Support complet. 

Versionnement de l'API 

Pour faciliter une transition en douceur, les anciennes URL de base de l'API restent disponibles pendant au moins six mois de plus. Notre politique de versionnement de l'API garantit la compatibilité et vous informe des changements majeurs à venir. 

• Les versions majeures de nos APIs sont indiquées dans les URLs (par exemple, v2). Lorsqu'une nouvelle version majeure est publiée, nous continuons à prendre en charge la version précédente pendant au moins six mois, en exécutant les deux APIs en parallèle. 
• Les mises à jour de version mineure sont signalées mais ne nécessitent pas un nouvel indicateur de version dans les URLs de l'API. Toutes les mises à jour mineures sont considérées comme "compatibles rétroactivement". Une nouvelle version majeure est publiée uniquement lorsque les changements ne sont pas "compatibles rétroactivement". 

Qu'est-ce qu'un changement mineur ? 

Nous considérons qu'un changement d'API est "mineur" lorsqu'il s'inscrit dans nos spécifications de compatibilité rétroactive. Votre implémentation serveur ou client développée contre nos APIs devrait pouvoir fonctionner avec ces changements au fil du temps, y compris : 

• Ajout de nouveaux API endpoints avec de nouveaux services (utilisation facultative).
• Ajout de nouveaux paramètres de requête optionnels à des API endpoints existants.
• Ajout de nouveaux champs aux réponses API existantes ou à des objets dans des réponses API existantes. 
• Réorganisation des champs dans les réponses API.
• Les champs marqués comme requis dans la demande peuvent être rendus optionnels.
• Augmentation ou diminution de la taille et du format interne des identifiants (dans les limites spécifiées). 

Prochaines mises à jour majeures de l'API 

Lorsqu'une version majeure de l'API est prévue, nous l'annoncerons dans ce document. Les versions majeures entraîneront un nouvel indicateur de version dans les URL API endpoints.