logo Sogenactif

Release 22.4

aller directement au contenu

Rechercher par mots clés

Migration Sogenactif Office Serveur JSON

Pour rechercher dans la page utiliser Ctrl+F sur votre clavier

  • Sogenactif

Sogenactif est une solution de paiement de commerce électronique multicanale sécurisée conforme à la norme PCI DSS. Elle vous permet d’accepter et de gérer des transactions de paiement en prenant en compte les règles métiers liées à votre activité (paiement à la livraison, paiement différé, paiement récurrent, paiement échelonné, …).

L’objectif du présent document est d’expliquer comment passer des composants Sogenactif Office Serveur 1.0 au connecteur Sogenactif Office Serveur 2.0 en mode migration simplifiée.

Ce document est à destination des commerçants disposant de l’offre Sogenactif 1.0.

Pour connaître tous les détails de l’utilisation de Sogenactif Office Serveur 2.0, merci de vous référer au document Guide d'intégration Sogenactif Office Serveur JSON.

Sujets non couverts dans le présent document :

  • Ce document ne présente que la migration vers Sogenactif Office Serveur JSON 2.0, connecteur recommandé sur Sogenactif Office Serveur 2.0, si vous souhaitez utiliser la version SOAP, merci de vous référer au document Guide d'intégration Sogenactif Office Serveur SOAP.

Pour toute question technique ou demande d'assistance, nos services sont disponibles du lundi au vendredi, hors jours fériés, de 9 h à 19 h :

  • par téléphone au : +33 (0) 825 090 095  (0,15 € TTC/min + prix d’un appel local – Tarif au 01/11/2021)
  • par e-mail : supportsogenactif@worldline.com

Pour faciliter le traitement de vos demandes, veuillez communiquer votre identifiant de commerçant : merchantId (numéro à 15 chiffres).

Contrairement à Sogenactif Office Serveur 1.0, Sogenactif Office Serveur 2.0 ne vous impose plus de stocker des fichiers sur votre serveur en vue des échanges.

Aussi, avec 2.0, seule une requête en mode JSON sera envoyée vers les serveurs Sogenactif Office Serveur 2.0 pour réaliser les différentes cinématiques (paiement, gestion de caisse, wallet). Plus aucun composant particulier n’est à installer pour pouvoir réaliser certains types d’opérations.

Pour la partie paiement :

  • Nouvelle URL de connexion.
  • Le certificat Sogenactif est remplacé pour une clé secrète.

Vous n’installez plus aucun fichier chez vous, quelle que soit l’interface Sogenactif 2.0 que vous choisissez.

  • Décider du connecteur Sogenactif Office Serveur 2.0 à utiliser (JSON, SOAP).
  • Mettre en place vos requêtes de gestion de Sogenactif Office Serveur en sécurisant votre nouvelle clé secrète.
  • Utiliser l’environnement de recette client pour tester les applications Sogenactif Office Serveur 2.0 avec un identifiant de connexion mis à disposition.
  • Supprimer les références à Sogenactif Office Serveur 1.0 sur votre site (certificat, composants, fichiers paramètres, fichiers exécutables).

Ce document ne présente que le connecteur JSON (requête envoyée au serveur Sogenactif en mode JSON).

Si vous souhaitez que les appels au serveur de paiement soient réalisés en mode « machine à machine » avec la technologie SOAP, merci de vous référer au document Guide d'intégration Sogenactif Office Serveur SOAP pour la mise en place des requêtes dans ce mode.

La migration de Sogenactif Office Serveur 1.0 repose surtout sur la migration des composants installés avec ce dernier. Il faut donc commencer par faire l’inventaire des composants que vous possédez sous le répertoire component/services de votre installation de Sogenactif Office Serveur 1.0.

Note: tous les exemples de code sont présentés en langage PHP et sont à personnaliser pour une utilisation réelle en production. Ils ne sont pas à reproduire tels que et ne sont là que pour présenter rapidement comment se connecter à Sogenactif Office Serveur 2.0.

Avec Sogenactif Office Serveur 1.0, chaque composant contient un répertoire param qui contient le fichier pathfile de paramètres par défaut de la boutique et le certificat de la boutique. Ces fichiers ne sont maintenant plus utilisés.

Le fichier pathfile, contenant les chemins de l’installation de Sogenactif Office Serveur sur le serveur du commerçant n’est plus utilisé, aucune de ces informations n’étant utile à Sogenactif Office Serveur 2.0. Ce fichier sera donc à supprimer lorsque la migration sera terminée.

Contrairement à Sogenactif Office Serveur 1.0 où les composants sont installés en local sur votre serveur, les échanges avec Sogenactif Office Serveur 2.0 se font par requête JSON sur l’URL du service concerné.

Il faudra maintenant calculer un champ nommé Seal contenant l’empreinte du message à envoyer.

Les paramètres de la requête (requête de paiement ou opération de gestion de caisse, de wallet) sont envoyés de machine à machine. Théoriquement, il est possible à un hacker de modifier les paramètres durant la transmission des données vers le serveur de paiement.

Il est par conséquent nécessaire d’ajouter de la sécurité pour assurer l’intégrité des paramètres transmis de la transaction. La solution Sogenactif répond à ce besoin par l’échange de signatures, nommées empreintes du message.

Un contrôle réussi des signatures implique deux choses :

  • L’intégrité des messages requête et réponse, pas d’altération durant l’échange,
  • L’authentification de l’émetteur et du receveur car ils partagent la même clé secrète.

Le calcul de l’empreinte du message est réalisé comme suite :

  • Concaténation des valeurs des champs dans l’ordre alphabétique, sans prise en compte du champ keyVersion et du champ sealAlgorithm.
  • Encodage UTF-8 des données du résultat précédent.
  • HMAC avec cryptage SHA256 des données obtenues avec la clé secrète.

Le calcul de l’empreinte du message, peut être résumé ainsi :

$Seal=hash_hmac('sha256', $Data, $secretkey);

Chaque composant, lorsqu'il est disponible sur Sogenactif Office Serveur 2.0, est remplacé par une URL particulière suivie du service concerné.

Aussi, référez-vous aux chapitres présentés ci-dessous pour pouvoir migrer chaque composant sur Sogenactif Office Serveur 2.0 ainsi qu'au document Guide d'intégration Sogenactif Office Serveur JSON pour connaître le détail des champs possibles sur chaque requête.

Ce composant, pour la partie ordre de paiement, est maintenant disponible sur l’URL : https://office-server.sogenactif.com/rs-services/v2/checkout/

Le tableau ci-dessous montre l’équivalence des services entre le composant Sogenactif Office Serveur 1.0 et sa version Sogenactif Office Serveur 2.0.

Service Sogenactif Office Serveur 1.0 Service Sogenactif Office Serveur 2.0 Commentaire
author cardOrder
elvauthor directDebitOrder paymentMeanBrand=ELV
directdebitorder directDebitOrder

Par exemple, l’URL utilisée pour réaliser l’opération équivalente à author sur Sogenactif Office Serveur 1.0 sera donc : https://office-server.sogenactif.com/rs-services/v2/checkout/cardOrder

Ce composant, pour la partie gestion de caisse, est maintenant disponible sur l’URL : https://office-server.sogenactif.com/rs-services/v2/cashManagement

Service Sogenactif Office Serveur 1.0 Service Sogenactif Office Serveur 2.0 Commentaire
validate validate
cancel cancel
credit refund
advice referral
duplicate duplicate
crediholder creditHolder

Ce composant, pour la partie 3D Secure, est maintenant disponible sur l’URL : https://office-server.sogenactif.com/rs-services/v2/checkout/

Service Sogenactif Office Serveur 1.0 Service Sogenactif Office Serveur 2.0 Commentaire
card3D_CheckEnrollment cardCheckEnrollment
card3D_Order cardValidateAuthenticationAndOrder
card3D_Authenticate cardValidateAuthentication
merchantWallet3D_CheckEnrollment walletCheckEnrollment

Ce composant, pour la partie paiement par wallet, est maintenant disponible sur l’URL : https://office-server.sogenactif.com/rs-services/v2/checkout/

Service Sogenactif Office Serveur 1.0 Service Sogenactif Office Serveur 2.0 Commentaire
merchantWallet_Order walletOrder

Le moyen de paiement Buyster n’existe plus et n’est donc plus utilisable.

Ce composant, pour la partie ordre de paiement, est maintenant disponible sur l’URL : https://office-server.sogenactif.com/rs-services/v2/checkout/

Service Sogenactif Office Serveur 1.0 Service Sogenactif Office Serveur 2.0 Commentaire
merchantwallet_credit walletCreditHolder

Ce composant, pour la partie ordre de paiement, est maintenant disponible sur l’URL : https://office-server.sogenactif.com/rs-services/v2/diagnostic/

Service Sogenactif Office Serveur 1.0 Service Sogenactif Office Serveur 2.0 Commentaire
diagnosis getTransactionData

Ce composant, pour la partie ordre de paiement, est maintenant disponible sur l’URL : https://office-server.sogenactif.com/rs-services/v2/wallet/

Service Sogenactif Office Serveur 1.0 Service Sogenactif Office Serveur 2.0 Commentaire
signInCard * Non disponible * La fonction addCard fait directement le signInCard.
signOff signOff
addCard addCard La fonction addCard fait directement le signInCard.
updatePaymentMean updatePaymentMean
deletePaymentMean deletePaymentMean
getWalletData getWalletData
getPaymentMeanData getPaymentMeanData

Le composant PayID est le prédécesseur du composant MerchantWallet. Merci de vous référer au chapitre concernant le composant MerchantWallet.

Ce composant, pour la partie paiement sur Paypal, est maintenant disponible sur l’URL : https://office-server.sogenactif.com/rs-services/v2/checkout/

Service Sogenactif Office Serveur 1.0 Service Sogenactif Office Serveur 2.0 Commentaire
Setcontext paymentProviderInitialize
Docontext paymentProviderFinalize
Getcontext paymentProviderGetContext

Au préalable, il faut faire la demande de création d’une boutique de test. Lors de cette demande, il faut préciser quels services à tester sont souhaités (paiement, gestion de caisse, wallet). Vous pouvez ensuite tester toutes les opérations mises à disposition. Merci de vous référer au document Guide d'intégration pour la mise en place des requêtes dans ce mode.

Lors de l’installation de Sogenactif Office Serveur 1.0, l’arborescence suivante est créée sur le serveur :


Capture d'écran de l'arborescence créée

Les fichiers de Sogenactif Office Serveur 2.0 n’ayant plus rien à voir avec cette arborescence, vous pouvez complètement supprimer les fichiers présents.

Attention: une fois votre migration terminée, veuillez envoyer le PV de fin de migration à l’adresse sips@worldline.com. Ce PV vous a été adressé par mail en début de migration ; si vous ne l‘avez plus, veuillez contacter notre support au 0811 107 022 (0,05 € / appel + prix appel) ou par mail à sips@worldline.com. Le traitement de ce PV entraînera la coupure des flux transactionnels générés par vos API 1.0.
Retourner en haut de page Besoin d'aide ?

Besoin d'aide ?

Fermer

Ce site utilise des traceurs pour améliorer votre expérience de navigation, effectuer des analyses et des recherches sur votre utilisation du site web de documentation Sogenactif.
En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

Paramètres