Introduction
Worldline Sips 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 en plusieurs fois, …).
L’objectif du présent document est d’expliquer la migration de Worldline Sips 1.0 vers Worldline Sips 2.0.
A qui s’adresse ce document
Ce document est à destination des commerçants disposant de l’offre Worldline Sips 1.0.
Il a pour but de faciliter la migration vers Worldline Sips 2.0.
Principes de migration vers Worldline Sips 2.0
Comparaison Sips Paypage / Sips Office
Le tableau comparatif suivant vous permet de comparer les avantages des différentes interfaces :
| Critère | Interface Sips Paypage | Interface Sips Office |
|---|---|---|
| Equivalence suggérée | Worldline Sips Payment 1.0 Il s'agit de pages en redirection, hébergées chez Worldline. |
Worldline Sips Office Server 1.0 |
| Périmètre fonctionnel | Création de transactions uniquement |
Création de transaction et gestion de caisse. Tip: vous pouvez utiliser Sips Paypage pour
le paiement et Sips Office pour la gestion de
caisse. |
| PCI/DSS | Bénéficie de la certification PCI car la cinématique de paiement est externalisée sur les serveurs Worldline Sips. Vous ne connaissez pas le PAN du client. |
Dans la création de transaction, la gestion des pages de paiement est réalisée par vous. A ce titre, vous devez respecter les exigences du Référentiel Sécuritaire PCI-DSS. |
| 3-D Secure | Processus 3-D Secure réalisé par Worldline Sips et transparent pour vous. | Vous pilotez le processus d’authentification 3-D Secure.A cet effet, Worldline met à votre disposition des méthodes que vous devez appeler. |
| Effort d’intégration | Solution Plug & Play facile à intégrer | Solution nécessitant plus de développement : paiement embarqué côté commerçant avec la gestion des pages de paiement… |
| Ajout d’un moyen de paiement | Sans effort de développement pour vous dans la plupart des cas. Note: vous devez parfois renseigner des champs
spécifiques dans la requête de paiement pour bénéficier des
options du moyen de paiement (exemple PayPal). |
Effort de développement côté commerçant pour intégrer le moyen de paiement (gestion cinématique, gestion des pages, …) |
| Parcours client | Rupture limitée entre votre site Web et le serveur de paiement grâce à la personnalisation des pages de paiement que vous pouvez faire (CSS, URL). | Aucune rupture entre votre site Web et le serveur de paiement |
| Intégration dans votre SI | S’interface avec votre boutique. | S’interface avec votre boutique ou Back Office. |
| Reporting | Reporting homogène | |
Ce qui change en 2.0
| Ce qui change après la migration | |
|---|---|
| Données et formats | Nouveau format des requêtes et des réponses automatiques et
manuelles. Nouvelle URL de paiement. Nouvelle URL de
gestion de caisse via Sips Office. Possibilité
pour vous de conserver le transactionId et de garder les journaux
au format 1.0 |
| Gestion de caisse | Nouveaux accès uniquement pour vos transactions passées avec Worldline Sips 2.0 |
| Reporting | Nouveaux formats de journaux. Tip: Dans le
cas où vous conservez l’identification par le TransactionId, vous
avez la possibilité de conserver vos journaux à l’ancien format
1.0 ou de bénéficier du nouveau format de journaux 2.0 à votre
convenance. Néanmoins, seuls les journaux 2.0 évoluent et
bénéficient des nouveaux champs ajoutés. |
| Accès aux extranets | Accès à l'extranet Merchant Extranet (point d'entrée unique qui vous permet d'accéder à
différents outils de gestion) - back Office de gestions
de transactions - outil de gestion des
utilisateurs - outil d'administration des règles de
lutte contre la fraude - outil Custompages d'aide à la
personnalisation des pages de paiement - outil Sips Download qui permet de télécharger et récupérer la clé
secrète (sécurisant les échanges entre le site internet et le
serveur Worldline Sips) |
| Fraude | Gestion autonome des contrôles de lutte contre la fraude via l'accès à l'extranet Merchant Extranet |
| Connecteurs | Nouveaux connecteurs non intrusifs en remplacement des
API. Nouvelle clé secrète (par boutique) qui remplace le
certificat Worldline Sips 1.0. |
| Moyens de paiement | Nouveaux moyens de paiement
internationaux. Moyens de paiement uniquement en
2.0. |
| URL | Nouvelle URL pour Sips Paypage Nouvelle URL pour Sips Office |
Identification des transactions
Rappel de l’existant Worldline Sips 1.0
Sur Worldline Sips 1.0, le système d’identification des transactions est assuré par l’assemblage des 4 champs suivants :
- merchantId (N15) : valeur fixe donnée par Worldline Sips,
- merchantCountry (A2) : valeur fixe donnée par Worldline Sips,
- transactionDate (YYYYMMDD) : valeur variable donnée par Worldline Sips (en fuseau local français) au moment de l’acceptation du paiement,
- transactionId (N6) : valeur variable attribuée par vous ou par Worldline Sips en votre délégation au moment de la demande de paiement (c'est-à-dire avant la demande d’autorisation). Il doit être unique pour la combinaison des 3 champs précédents.
Les opérations associées à une transaction sont identifiées par un quintuplé, les 4 champs précédents complétés d’un operation_sequence.
Génération de l’identification des transactions sur Worldline Sips 2.0
Sur Worldline Sips 2.0, il existe deux modes de génération de l'identifiant de transaction:
Comme sur Worldline Sips 1.0, le mode par défaut de génération de l’identifiant de la transaction est la génération effectuée par vous-même. Ce mode est préconisé car il vous permet de stocker le contexte et de préparer le rapprochement de votre transaction avant l’envoi de la requête.
Le mode de génération automatique par Worldline Sips est une facilité d’intégration qui n’est pas recommandé si vous générez des flux importants car il présente quelques inconvénients :
- Le contrôle de doublon de transaction est effectué par Worldline Sips sur cet identifiant que vous avez envoyé. Donc dans le cas de l’auto-génération de l’identifiant, ce contrôle ne peut pas être effectué.
- L’absence de transactionId ou transactionReference dans la requête vous oblige à utiliser d’autres données (customer, orderId, amount) pour rapprocher la réponse et la requête.
- Il n’est pas possible d’interroger Worldline Sips avec la méthode Diag en cas de dysfonctionnement (exemple : Réponse non reçue par vous, …)
Le transactionReference
Sur Worldline Sips 2.0, l’identification standard de la transaction se fait grâce à un nouvel identifiant : le transactionReference.
Ce nouvel identifiant présente l’avantage d’être au format ANS35 ce qui permet :
- de garder cet identifiant unique de manière illimitée (sur la période d’existence de la transaction dans Worldline Sips : 15 mois) au lieu d’une journée pour le transactionId,
- d'utiliser des caractères alphanumériques dans la référence, format ouvert facilitant la génération par vous,
- de se rendre indépendant des fuseaux horaires (internationalisation).
La compatibilité du transactionId sur Worldline Sips 2.0
Afin de minimiser les impacts, l’utilisation du transactionId est possible dans Worldline Sips 2.0.
Sur Worldline Sips 2.0, vous devez être dans un des deux modes suivants :
- Mode transactionReference (mode par défaut),
- Mode transactionId.
Si vous souhaitez rester en mode transactionId vous devez en faire la demande à Worldline lors de l’inscription de votre identifiant commerçant à l’offre Worldline Sips 2.0 .
Toutes les transactions sur Worldline Sips 2.0 sont à la fois liées à un TransactionId + TransactionIdDate et à un TransactionReference.
Les transactionId, transactionIdDate et transactionReference sont stockés, restitués et affichés pour toutes les transactions.
Dans les interfaces 2.0, les champs transactionId et transactionIdDate ont été nommés s10TransactionId et s10TransactionIdDate afin de vous permettre d’identifier directement et simplement la référence à Worldline Sips 1.0.
En résumé,
- transactionReference est le moyen par défaut d’identifier une transaction,
- s10TransactionId permet d’identifier une transaction effectuée sur Worldline Sips 2.0 en restant compatible avec Worldline Sips 1.0 (si vous continuez à utiliser le TransactionId),
- le couple s10TransactionId+s10TransactionIdDate assure l’unicité de la transaction.
Cas d’utilisation
Création des transactions
Lors d’une création de transaction, et en fonction du mode choisi, Worldline Sips accepte ou rejette la création et génère des identifiants complémentaires. Le tableau ci-après récapitule les différents cas possibles.
| Création de transaction via | ||||
|---|---|---|---|---|
| Cas d’utilisation | Données | Sips Paypage | Sips Office | Sips Office Extranet |
| Boutique en mode transactionReference | ||||
| Vous vous connectez à Worldline Sips avec un transactionReference que vous avez généré. | transactionReference fourni par vous. | fonctionnement conforme au paramétrage de la boutique | fonctionnement conforme au paramétrage de la boutique | Proposé par Worldline Sips, modifiable et affiché en rouge. |
| transactionId fourni par vous. | Rejet Rejet Code = 12 |
Rejet Code = 12 |
N/A | |
| transactionId absent. | OK | OK | N/A | |
| transactionReference absent. | Rejet Code = 12 |
Rejet Code = 12 |
Rejet Code = 12 |
|
| Référence complémentaire générée par Worldline Sips. | s10TransactionId s10TransactionIdDate |
s10TransactionId s10Transaction Id Date |
s10TransactionId s10TransactionIdDate |
|
| Contenu réponse | s10TransactionId s10TransactionIdDate transactionReference |
s10TransactionId s10TransactionIdDate transaction Reference |
||
| Vous vous connectez à Worldline Sips sans transactionReference (Tref auto). | transactionReference généré par Worldline Sips. | fonctionnement conforme au paramétrage de la boutique | N/A | Généré par Worldline Sips et affiché en rouge. |
| transactionId fourni par vous. | Rejet Code = 12 |
N/A | ||
| transactionId absent. | OK | N/A | ||
| transaction Reference fourni par vous. | Rejet Code = 12 |
N/A | ||
| Référence complémentaire générée par Worldline Sips. | transactionReference s10TransactionId s10TransactionIdDate |
transactionReference s10TransactionId s10TransactionIdDate |
||
| Contenu réponse | s10TransactionId s10TransactionIdDate transactionReference |
|||
| Boutique en mode transactionId | ||||
| Vous vous connectez à Worldline Sips avec un transactionId que vous avez généré. | transactionId fourni par vous. | fonctionnement conforme au paramétrage de la boutique | fonctionnement conforme au paramétrage de la boutique | Proposé par Worldline Sips, modifiable et affiché en rouge. |
| transactionId absent. | Rejet Code = 12 |
Rejet Code = 12 |
Rejet Code = 12 |
|
| transactionReference fourni par vous. | Rejet Code = 12 |
Rejet Code = 12 |
N/A | |
| transactionReference absent. | OK | OK | N/A | |
| Référence complémentaire générée par Worldline Sips. | transactionReference | transactionReference | transactionReference | |
| Contenu réponse | s10TransactionId s10TransactionIdDate transactionReference |
s10TransactionId s10TransactionIdDate transactionReference |
||
| Vous vous connectez à Worldline Sips sans transactionId (Tid auto). | transactionId généré par Worldline Sips. | fonctionnement conforme au paramétrage de la boutique | N/A | Généré par Worldline Sips et affiché en rouge. |
| transactionId fourni par vous. | Rejet Code = 12 |
N/A | ||
| transactionReference fourni par vous. | Rejet Code = 12 |
N/A | ||
| transactionReference absent. | OK | N/A | ||
| Référence complémentaire générée par Worldline Sips. | s10TransactionId s10TransactionIdDate transactionReference |
s10TransactionId s10TransactionIdDate transactionReference |
||
| Contenu réponse | s10TransactionId s10TransactionIdDate transactionReference |
|||
Opérations de caisse
Pour les opérations de caisse, l’identification d’une transaction n’est pas limitée au mode choisi.
Le tableau ci-dessous reprend les différentes possibilités.
| Cas d’utilisation | Données | Gestion de caisse |
|---|---|---|
| Boutique en mode transactionReference | ||
| Transaction d'origine générée avec un transactionReference : | transactionId fourni par vous. | OK |
| transactionReference fourni par vous. | OK | |
| transactionReference et transactionId cohérents fournis par vous. | OK | |
| transactionReference et transactionId ne référençant pas la même transaction fournis par vous. | Rejet Code = 12 |
|
| Nouvelle transaction (duplication et crédit porteur). | Voir Tableau de création des transactions ci-dessus. | |
| Boutique en mode transactionId | ||
| Transaction d'origine générée avec un transactionId. | transactionId fourni par vous. | OK |
| transactionReference fourni par vous. | OK | |
| transactionReference et transactionId cohérents fournis par vous. | OK | |
| transactionReference et transactionId ne référençant pas la même transaction fournis par vous. | Rejet Code = 12 |
|
| Nouvelle transaction (duplication et crédit porteur). | Voir Tableau de création des transactions ci-dessus. | |
Le paiement en N fois (sur Sips Paypage)
- Mode transactionId
Pour effectuer un paiement en plusieurs fois en mode transactionId, vous devez transmettre une liste de transactionId et une liste de transactionIdDate dans la requête de paiement. Worldline Sips génère automatiquement une transactionReference pour chaque transaction.
Si la liste de transactionId n’est pas envoyée, la transaction est rejetée avec un responseCode = 12.
- Mode transactionReference
Pour effectuer un paiement en plusieurs fois en mode transactionReference, vous devez transmettre une liste de transactionReference et la date de chacune des échéances dans la requête de paiement. Worldline Sips génère automatiquement un transactionId pour chaque transaction.
Si la liste de transactionReference n’est pas envoyée, la transaction est rejetée avec un responseCode = 12.
Le paiement en N fois n’est pas compatible avec le mode de génération automatique de la référence de transaction par Worldline Sips.
Reporting
- Journaux
Les champs s10TransactionId, s10TransactionIdDate et transactionReference sont présents dans les journaux de transactions, d'opérations, de rapprochement des transactions et de rapprochement des impayés 2.0, indépendamment du mode d’identification de transaction activé.
Pour l'opération de duplication, la transaction d’origine est identifiable via les champs s10FromTransactionId, s10FromTransactionIdDate et fromTransactionReference du journal des transactions.
- Sips Office Extranet
La recherche d’une transaction dans Sips Office Extranet peut se faire indifféremment avec un transactionId ou un transactionReference.
Si vous avez opté pour le transactionReference, les deux colonnes seront systématiquement présentes dans Sips Office Extranet dans les écrans suivants :
- liste des transactions suite à une recherche,
- détail d’une transaction.
La fraude – Alimentation des listes
L’ajout de PAN sur des listes grises via la référence de la transaction est possible via l’utilisation du transactionId ou du transactionReference.
Fraude
Sur Worldline Sips 1.0, les contrôles sont réalisés sur l’outil de contrôle de fraude 1.0.
Sur Worldline Sips 2.0, vous utilisez le nouveau moteur de fraude 2.0, administrable depuis le Merchant Extranet.
Sur Worldline Sips 1.0, pour ne pas réaliser un ou plusieurs contrôles complémentaires, il faut notifier le mot-clé correspondant au contrôle dans le champ DATA de l’API. Sur Worldline Sips 2.0, il faut renseigner les valeurs des champs bypassCtrlList et bypassInfoList.
La correspondance des mots clé de débrayage est décrite dans le document Guide de correspondance des données 1.0 / 2.0.
Les contrôles non liés au moyen de paiement (ex. encours client, … ) ne sont pas partagés entre Worldline Sips 1.0 et Worldline Sips 2.0.
- La migration des listes grises 1.0 en 2.0 est prise en charge dans le cadre d'une demande spécifique. Nous vous invitons à contacter votre interlocuteur privilégié Worldline
Les principales caractéristiques de la gestion de la fraude 2.0 sont les suivantes :
- Mode Go-No-Go ,
- Mode Go-No-Go + ,
| Mode | Géolocalisation | Encours | Listes noires, grises et blanches | Divers | Contrôles des paniers |
|---|---|---|---|---|---|
Go-No-Go |
Pays de l'IP Pays de la carte Correspondance entre IP et pays de la carte |
Carte IP Identifiants Client |
Numéros de carte PAN |
Oppotota Association cartes/client & Association client / carte Carte commerciale Carte virtuelle Montant Carte à autorisation systématique Date d'expiration du numéro de carte / PAN |
Liste des produits à risque Quantité de produits à risque Ratio produit à risque Quantité produits |
Go-No-Go+ |
Pays de l'IP Pays de la carte Correspondance entre IP et pays de la carte Pays de livraison et de la carte Pays de livraison et de facturation Pays de facturation et pays de la carte Code postal de livraison et de facturation |
Carte IP Identifiants Client |
Adresses IP BIN Identifiants Client Codes postaux Noms Numéros de carte PAN Numéros de téléphone |
Oppotota Association carte /client & Association client / carte Carte commerciale Carte virtuelle Montant Carte à autorisation systématique Date d'expiration du numéro de carte / PANRéseau CB Association numéro de carte et adresse IP Authentification 3D Secure E-mail gratuit Nombre de clients par carte Réputation adresse IP Syntaxe d'adresse e-mail |
Liste des produits à risque Quantité de produits à risque Ratio produit à risque Quantité produits |
- Outils de gestion de la fraude en autonomie (Risk Management System) : visualisation / mise à jour de la configuration.
Étapes de migration
Chronologie
Nous avons identifié une liste d’étapes indispensables à la bonne réalisation de la migration de Worldline Sips 1.0 vers Worldline Sips 2.0. Ces étapes peuvent être schématisées de la manière suivante :
Ce que vous devez faire
Les étapes successives ci-dessous se réfèrent à la partie 'Chronologie'. Vous devrez les suivre afin de réaliser avec succès votre migration vers Worldline Sips 2.0 :
- Choisir les modalités de migration
- Choix des connecteurs JSON, POST ou SOAP pour Sips Paypage et JSON ou SOAP pour Sips Office en fonction de votre mode de fonctionnement (se référer à la documentation correspondante),
- Décision de rester en transactionId ou de passer en transactionReference.
Installer les connecteurs
- Transposition des données 1.0 / 2.0 (journaux, fraude, …).Un guide de correspondance des données est à votre disposition
Personnaliser les pages de paiement si choix du mode Paypage
- Test en local avec l'outil Custompages sur votre accès Merchant Extranet,
- Envoi des CSS à Worldline Sips.
Utiliser l’environnement de simulation client pour tester les applications Sips Paypage (cf. Guide de démarrage rapide) et avec la boutique de recette mise à disposition pour Sips Office
- Récupération des identifiants de simulation ou de test,
- Tests en simulation ou en recette,
- Vérification des tests effectués,
Démarrer en production
- Vérification de la configuration de la boutique en production,
- Intégration des identifiants de la boutique de production,
- Bascule en production des flux de la boutique en Worldline Sips 2.0,
- Surveillance du démarrage de la bascule pour vous assurer du bon traitement des flux en Worldline Sips 2.0.
- Supprimer les références à Worldline Sips 1.0 sur le site commerçant : certificat, fichiers paramètres, fichiers exécutables …
Etat initial
Vous disposez actuellement d’une boutique en Worldline Sips 1.0, vous avez donc un merchantId qui permet de vous identifier. Toutes vos transactions sont réalisées avec ce merchantId et vous bénéficiez de journaux consolidés et d’une visualisation de toutes vos transactions sur Sips Office Extranet, tous moyens de paiement confondus.
Passage des flux en 2.0
Vous pilotez la migration. Un suivi attentif des premiers flux est opéré de votre part et de Worldline pour vous assurer du bon déroulement de la bascule en 2.0.
Vos accès aux outils Worldline Sips 1.0 seront maintenus pour des raisons d'accès à l'historique de transactions et de possibilité de gestion de caisse, jusqu'à ce que vous nous exprimiez votre souhait de cloture définitive de votre boutique Worldline Sips 1.0.
Procédure de retour
Dans le cas où vous détectez une anomalie (problème non identifié lors de la phase de test de vos développements internes), il est possible de rebasculer les flux sur Worldline Sips 1.0 via les API.
Cette solution reste possible tant que vous et Worldline Sips maintenez les identifiants de connexion 1.0 valides. La suppression des accès 1.0 est réalisée lors de la dernière étape. Vos accès aux outils Worldline Sips 1.0 seront maintenus pour des raisons d'accès à l'historique de transactions et de possibilité de gestion de caisse, jusqu'à ce que vous nous exprimiez votre souhait de cloture définitive de votre boutique Worldline Sips 1.0.
Annexes
Annexe 1 : FAQ migration
Pourquoi migrer sur Worldline Sips 2.0 ?
Worldline s’est dotée d’une nouvelle plateforme Worldline Sips, vous permettant :
- de simplifier l’intégration de Worldline Sips et standardiser les méthodes de connexion : nouveaux connecteurs Worldline Sips à l’état de l’art.
- d'optimiser le parcours client : nouvelles fonctionnalités et nouvelle ergonomie des interfaces client (application InApp, webresponsive, …).
- d'avoir plus d’autonomie dans la gestion de vos transactions et de vos paramètres commerçant: nouvelle interface Merchant Extranet.
- de faciliter votre déploiement sur le marché international : nouveaux moyens de paiement
- de bénéficier de fonctionnalités avancées : enrichissement des outils de lutte contre la fraude, optimisation de l'authentification forte liée à la DSP2 (3DSV2)...
Peut-on garder sur Worldline Sips 2.0 le même merchantId 1.0 ?
Si vous avez créé une nouvelle boutique en 2.0 vous aurez deux merchantId distincts.
Peut-on visualiser sur Worldline Sips 2.0 les transactions créées en 1.0 ?
Depuis les interfaces 2.0, vous ne pouvez pas accéder et manipuler les transactions créées en Worldline Sips 1.0 (validation, annulation, remboursement, duplication) puisque vous utilisez un nouvel accès à Sips Office Extranet pour votre nouvelle boutique 2.0. Tant que vous conservez vos accès en Worldline Sips 1.0, vous pourrez accéder à vos transactions sur le back office 1.0.
Peut-on sur Worldline Sips 2.0 valider une transaction 1.0 ?
Depuis les interfaces 2.0, vous ne pouvez pas accéder et manipuler les transactions créées en Worldline Sips 1.0 (validation, annulation, remboursement, duplication) puisque vous utilisez un nouvel accès à Sips Office Extranet pour votre nouvelle boutique 2.0. Tant que vous conservez vos accès en Worldline Sips 1.0, vous pourrez accéder à vos transactions sur le back office 1.0.
Peut-on sur Worldline Sips 2.0 annuler une transaction 1.0 ?
Depuis les interfaces 2.0, vous ne pouvez pas accéder et manipuler les transactions créées en Worldline Sips 1.0 (validation, annulation, remboursement, duplication) puisque vous utilisez un nouvel accès à Sips Office Extranet pour votre nouvelle boutique 2.0. Tant que vous conservez vos accès en Worldline Sips 1.0, vous pourrez accéder à vos transactions sur le back office 1.0.
Peut-on sur Worldline Sips 2.0 rembourser une transaction 1.0 ?
Depuis les interfaces 2.0, vous ne pouvez pas accéder et manipuler les transactions créées en Worldline Sips 1.0 (validation, annulation, remboursement, duplication) puisque vous utilisez un nouvel accès à Sips Office Extranet pour votre nouvelle boutique 2.0. Tant que vous conservez vos accès en Worldline Sips 1.0, vous pourrez accéder à vos transactions sur le back office 1.0.
Peut-on en Worldline Sips 2.0 dupliquer une transaction 1.0 ?
Depuis les interfaces 2.0, vous ne pouvez pas accéder et manipuler les transactions créées en Worldline Sips 1.0 (validation, annulation, remboursement, duplication) puisque vous utilisez un nouvel accès à Sips Office Extranet pour votre nouvelle boutique 2.0. Tant que vous conservez vos accès en Worldline Sips 1.0, vous pourrez accéder à vos transactions sur le back office 1.0.
Peut-on continuer de recevoir les journaux au format 1.0 ?
Dans le cas où vous conservez l’identification par le transactionId, vous avez la possibilité de conserver vos journaux à l’ancien format 1.0 ou de bénéficier du nouveau format de journaux 2.0 à votre convenance.
Néanmoins, seuls les journaux 2.0 évoluent et bénéficient des nouveaux champs ajoutés. Si vous restez sur le format 1.0, vous ne bénéficierez pas des mises à jour (ex. ajout dans les journaux de données additionnelles liées à un moyen de paiement).
Peut-on visualiser le transactionId sur les journaux au format 2.0 ?
Les champs s10TransactionId et s10TransactionIdDate ont été ajoutés dans les journaux de transactions, d’opérations, de rapprochements bancaires et de rapprochements des impayés 2.0.
Quels sont les apports du transactionReference par rapport au transactionId ?
Ce nouvel identifiant présente l’avantage d’être au format ANS35 ce qui permet :
- de garder cet identifiant unique de manière illimitée (sur la période d’existence de la transaction dans Worldline Sips : 15 mois) au lieu d’une journée pour le transactionId,
- d'utiliser des caractères alphanumériques dans la référence, format ouvert facilitant la génération par vous,
- se rendre indépendant des fuseaux horaires (internationalisation).
Peut-on basculer du mode transactionId au mode transactionReference ?
Vous pouvez opter pour le mode transactionReference à tout moment. Vous avez par exemple la possibilité de migrer sur Worldline Sips 2.0 en gardant le mode transactionId pour faciliter votre migration et opter ensuite pour le transactionReference afin de bénéficier des avantages liés à ce nouveau format.
Peut-on basculer du mode transactionReference au mode transactionId ?
Si vous avez opté pour le mode transactionReference vous ne pouvez plus basculer sur le mode transactionId. En effet, si vous êtes en mode TransactionId, l’affichage de l’extranet est inchangé, et le transactionReference n’est pas visible, ce qui empêcherait de manipuler les transactions générées avec le mode transactionReference.
Peut-on migrer en 2.0 sans personnaliser ses pages de paiement ?
La personnalisation des pages de paiement reste une étape facultative pour démarrer en 2.0. Worldline Sips propose une personnalisation par défaut.
Peut-on garder la même personnalisation des pages de paiement ?
Il n’y a pas d’outil de migration qui reproduit la personnalisation des pages de paiement 1.0. Nous déconseillons les tentatives de reproduire exactement le visuel des pages de paiement 1.0 sur les pages de paiement 2.0. En effet, il est dommage de se priver des nouvelles possibilités qu'offrent les pages de paiement 2.0, notamment sur l’aspect adaptabilité à la taille des écrans.
Peut-on changer la personnalisation des pages de paiement ?
Il est conseillé de changer la personnalisation des pages de paiement afin de bénéficier des atouts des pages de paiement 2.0.
Un guide de personnalisation des pages est mis à votre disposition.
Peut-on utiliser la base wallet existante 1.0 ?
La base Wallet est partagée entre Worldline Sips 1.0 et 2.0.
La base des abonnés SUBSCRIPTION est déjà migrée dans la base Wallet.
Quels sont les contrôles de fraude disponibles sur Worldline Sips 2.0 ?
Les contrôles de fraude disponibles sur Worldline Sips 2.0 sont détaillés dans le guide « Gestion de la lutte contre la fraude ».
Quelles sont les devises acceptées en 2.0 ?
Les devises acceptées dépendent du contrat acquéreur. Les devises prévues pour le schème Visa / Mastercard, Amex sont les suivantes :
EUR,USD,CHF,GBP,CAD,JPY,MXN,TRY,AUD,NZD,NOK,BRL,ARS,KHR,TWD,SEK,DKK,KRW,SGD,XPF,XOF.
Quels sont les acquéreurs français disponibles en 2.0 ?
- La Banque Postale
- Banque Populaire
- BNP Paribas
- Caisse d’Epargne
- Crédit Agricole
- Crédit Du Nord
- Crédit Mutuel Centre Est Europe
- CIC
- Crédit Mutuel de Bretagne
- HSBC
- Le Crédit Lyonnais
- Société Générale
Comment valider que ma migration est OK ?
Worldline met à votre disposition une boutique de simulation (pour Sips Paypage) ou de test (pour Sips Office) qui vous permet de valider vos développements internes.
Suite à cette migration, nous vous recommandons de suivre attentivement le bon traitement de vos premiers flux sur Worldline Sips 2.0.
Annexe 2 : commerçant 1.0 qui ouvre une nouvelle boutique en 2.0
Le premier scénario décrit ici consiste à ouvrir une nouvelle boutique en 2.0.
Ce scénario peut convenir au cas où vous souhaitez pouvoir rapidement mettre en œuvre un nouveau moyen de paiement pour une boutique sans avoir à migrer tous vos flux, ou vous utilisez des moyens de paiement non encore disponibles en 2.0.
Vous disposerez donc de deux boutiques, une Worldline Sips 1.0 pour vos moyens de paiement actuels, et une seconde Worldline Sips 2.0 pour un ou plusieurs nouveaux moyens de paiement.
Les 2 boutiques sont rattachées au même client, mais vous aurez 2 merchantId.
Enregistrement commerçant
Il convient d’utiliser la procédure classique d’enregistrement d’une nouvelle boutique 2.0.
Gestion de caisse
Vous accédez et manipulez les transactions dans les environnements/interfaces 1.0 ou 2.0 dans lesquels vous les avez créées.
La duplication étendue vous permet de créer une transaction à partir d’une transaction existante initialisée par une autre boutique. Vous pouvez donc utiliser cette fonctionnalité pour dupliquer une transaction de votre boutique 1.0 à partir de votre nouvelle boutique 2.0.
Pour ce faire, les deux boutiques doivent partager le même clientId.
Vous devez notamment renseigner dans votre requête de paiement les identifiants de la boutique d’origine et de la transaction d’origine :
- fromMerchantId,
- fromMerchantId,
- s10FromTransactionIdDate.
Les coordonnées du moyen de paiement sont récupérées de la transaction initiale par Sips. Toutefois, vous pouvez modifier les données métier (numéro de commande, modalité d’envoi en banque, …).
Les transactions dupliquées sont traitées comme une nouvelle transaction en mode récurrent (champ paymentPattern est fixé à RECURRING_N).
Les contrôles effectués sont les suivants :
- Vous n'avez pas le droit de duplication étendue (code refus 03).
- La boutique d’origine n’est pas rattachée à vous (code refus 40).
- La transaction à dupliquer n’existe pas (code refus 25).
- La transaction initiale ne peut pas être dupliquée car le moyen paiement ne le permet pas (code refus 24).
- La date d’expiration du moyen de paiement a été dépassée (code refus 24).
- Demande d’autorisation refusée par l’acquéreur.
La transaction créée moyennant la duplication est reprise dans le Journal sur les transactions et affichée dans l’Extranet.
Reporting
Journaux : Vous recevez vos journaux par boutique, les journaux 1.0 et 2.0 ne sont pas consolidés. Les journaux 2.0 isolent les flux relatifs aux transactions effectuées sur Worldline Sips 2.0.
Ce scénario vous permet de bénéficier du nouveau format de journaux 2.0 pour votre nouvelle boutique. Néanmoins, cette option n’est pas obligatoire, vous pouvez garder le format 1.0 si vous voulez garder le traitement existant des journaux dans votre Back Office. Ceci est valable pour les types de journaux : journal des transactions, journal des opérations, journal de rapprochement des transactions et journal de rapprochement des impayés.
Alerte : Si vous souhaitez conserver les journaux au format 1.0, vous ne récupérez pas les données purement 2.0. Les impacts sont à mesurer en fonction des fonctionnalités et moyens de paiement que vous avez retenus.
Merchant Extranet : Vous pouvez garder la même URL et vos login/mot de passe existants grâce à l’utilisation de la fonctionnalité de super-user.
Néanmoins, vous n’avez pas accès à un historique consolidé de vos transactions 1.0 et 2.0 puisque vous gardez votre identifiant existant pour votre boutique 1.0, et utilisez un nouvel identifiant pour votre nouvelle boutique 2.0.
Fraude
En 1.0 les contrôles sont réalisés sur l’outil de contrôle de fraude 1.0.
En 2.0, vous utilisez le moteur de fraude 2.0, accessible depuis le Merchant Extranet.
Les contrôles non liés au moyen de paiement (ex. encours client, encours panier …) ne sont pas partagés entre 1.0 et 2.0.
La migration des listes grises 1.0 en 2.0 est prise en charge dans le cadre d'une demande spécifique. Nous vous invitons à contacter votre interlocuteur privilégié Worldline
Facturation
Les deux boutiques sont rattachées au même client facturé avec le même modèle de facturation.
Limites
- Etanchéité entre la fraude 1.0 et la fraude 2.0.
- Ne pas utiliser un même moyen de paiement en 1.0 ET en 2.0 avec un seul et même contrat VAD car la réconciliation ne fonctionne pas correctement quand plusieurs boutiques d’un même commerçant ont un même contrat d’acquisition.
Annexe 3 : Arborescence documentaire
Dans cette annexe vous trouverez un tableau récapitulatif des documents de référence pour accompagner votre migration:
| Besoin | Document de référence |
|---|---|
| Connecteurs | Documentation Sips Paypage |
| Documentation Sips Office | |
| Documentation Sips Office Batch | |
| Personnalisation des pages | Personnalisation des pages |
| Journaux | Correspondance des journaux 1.0 2.0 |
| Champs | Correspondance des données 1.0 2.0 |
| Dictionnaire des données | Dictionnaire des données |
| Documentation en ligne | Site de documentation |
| Sips Office Extranet | Sips Office Extranet |
| Sips Download | Sips Download |
| CustomPages | CustomPages |
