Paiement multiple à l'expédition

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 mise en œuvre du paiement multiple à l'expédition jusqu'au démarrage en production.

A qui s’adresse ce document

Ce document a pour objectif de vous aider à mettre en place le paiement .

L’objectif est de présenter les fonctionnalités liées au paiements multiples à l'expédition et d’expliquer comment les mettre en œuvre avec la solution Worldline Sips.

Pour avoir une vue d’ensemble de la solution Worldline Sips, nous vous conseillons de consulter les documents suivants :

Présentation fonctionnelle
Guide de Configuration des fonctionnalités

Prérequis

Pour vous permettre d'effectuer des paiements multiples à l'expédition, Worldline Sips doit stocker les coordonnées de paiement de vos clients.

Vous avez quelques points à traiter avant de démarrer :

Pour être en conformité avec le RGPD, vous devez compléter votre registre interne de traitement des données personnelles, en précisant que les données bancaires sont conservées par Worldline Sips. Pour davantage d'informations sur le RGPD, veuillez vous référer à notre documentation sur la sécurité des systèmes d'information,
Informer vos clients du stockage de leurs coordonnées et des modalités des paiements multiples à l'expédition (montants, nombre d'échéances, …),
Vérifier auprès de votre acquéreur que votre contrat supporte les paiements récurrents.

Vue d'ensemble

Le paiement multiple à l'expédition comporte plusieurs volets :

la prise de commande et la mise en place de la première expédition (CIT);
le traitement des expéditions suivantes (MIT);
la gestion de l'expiration du moyen de paiement de l'acheteur ou le refus d'une des expéditions

Les moyens de paiement permettant d’effectuer ce type de paiement sont les moyens de paiement des réseaux CB, Visa, Mastercard et American Express.

Choix des connecteurs

Comme Worldline Sips offre plusieurs interfaces pour traiter le paiements multiples à l'expédition , il convient d’analyser votre besoin métier pour choisir les connecteurs les plus adaptés à votre situation.

le paiement multiple à l'expédition se décline en deux types de transactions :

Prise de commande / première expédition : pour cette transaction votre client est présent. Il peut choisir son moyen de paiement, s'authentifier (conformément à la réglementation DSP2) et valider le paiement de sa commande. Ce type de transaction est nommé CIT ou "Client Initiated Transaction".
Les expéditions suivantes : pour ces transactions, votre client n'est pas présent. Ces transactions seront à votre initiative et réalisées chaque nouvelle expédition. Elles sont appelées MIT ou "Merchant Initiated Transaction".

Le tableau ci-dessous récapitule les interfaces disponibles en fonction du type de transaction.

Cas d'usage	Sips Paypage	Sips Office	Sips Office Batch	Sips In-App	Sips Office Extranet
Première expédition (CIT)	V	V	X	V	X
Nième expédition (MIT)	X	V	V	X	V

Données à conserver

En fonction de la manière dont vous traitez les différentes expéditions, les données à conserver varient :

Connecteur	Données à conserver pour traiter les MIT
Sips Office via duplication	référence de la CIT (champ `transactionReference` ou `s10TransactionId`/`s10TransactionDate`)
Sips Office via cardOrder (avec token)	référence de la CIT (champ `transactionReference` ou `s10TransactionId`/`s10TransactionDate`) référence unique de transaction de l'émetteur servant au chaînage (champ `schemeTransactionIdentifier`) token de la carte utilisée lors de la CIT (champ `tokenPan`) Brand de la carte utilisée lors de la CIT (champ `paymentMeanBrand`) date d'expiration de la carte utilisée lors de la CIT (champ `cardExpiryDate`) holderAuthentProgram utilisé lors de la CIT (champ `initialHolderAuthentProgram`) date d'authentification utilisée lors de la CIT (champ `initialAuthentDateTime`) holderAuthentType utilisé lors de la CIT (champ `initialHolderAuthentType`) challengeMode3DS utilisé lors de la CIT (champ `initialChallengeMode3DS`)
Sips Office via walletOrder	référence de la CIT (champ `transactionReference` ou `s10TransactionId`/`s10TransactionDate`) référence unique de transaction de l'émetteur servant au chaînage (champ `schemeTransactionIdentifier`) identifiant du wallet utilisé pour la CIT (champ `merchantWalletId`) identifiant au sein du wallet Worldline Sips de la carte utilisée lors de la CIT (champ `paymentMeanId`) holderAuthentProgram utilisé lors de la CIT (champ `initialHolderAuthentProgram`) date d'authentification utilisée lors de la CIT (champ `initialAuthentDateTime`) holderAuthentType utilisé lors de la CIT (champ `initialHolderAuthentType`) challengeMode3DS utilisé lors de la CIT (champ `initialChallengeMode3DS`)

Mise en oeuvre

Le paiement multiple à l'expédition est un cas de paiement vous permettant d'authentifier votre client lors de la prise de commande et par la suite, de facturer celui-ci au fil des expéditions des marchandises composant sa commande. Ce cas de paiement se décompose donc en 2 phases :

La prise de commande (avec présence du client)
Les différents envois des marchandises (sans présence du client)

Traitement de la commande et de la première expédition : CIT

Lors de la phase de prise de commande votre client devra s'authentifier grâce au 3-D Secure. Une fois authentifié, une demande d'autorisation sur le montant de la première expédition doit être réalisée. Nous assumons ici que la première expédition de marchandise aura lieu avant la fin du délai de l'autorisation (6 jours). Si la première expédition a lieu plus de 6 jour après la prise de commande, vous pouvez vous reporter au contenu du paragraphe "Cas particulier de la première expédition distante avec la prise de commande"

Note: Si le paiement est réalisé avec un carte CB, la garantie de paiement est éligible jusqu'à 30 jours. Pour plus d'informations, reportez-vous au guide d'intégration du moyen de paiement carte Bancaire.

Description

Prise de commande et première expédition sur Sips Paypage

Diagramme décrivant la prise de commande et 1ère expédition via Paypage

Pour la prise de commande, vous redirigez l'acheteur vers Sips Paypage en communiquant dans la requête les informations permettant la mise en place du paiement multiple à l'expédition.
Worldline Sips affiche la page de paiement (seuls les moyens de paiements supportant le paiement multiple à l'expédition sont disponibles), l’acheteur sélectionne le moyen de paiement, fournit ses coordonnées de paiement puis valide.
Worldline Sips procède à la vérification 3-D Secure.
Worldline Sips effectue les contrôles anti-fraude.
Worldline Sips envoie une demande d’autorisation à l’acquéreur.
Worldline Sips enregistre la transaction et ses informations dans le back office.
Worldline Sips vous retourne les réponses manuelles et automatiques contenant les détails de la transaction.
Worldline Sips envoie la transaction en remise en fonction des modalités que vous avez paramétré dans la requête de paiement.

Le montant de la transaction et le fait qu'il s'agisse d'un paiement à l'expédition est indiqué sur les pages de paiement.

Prise de commande et première expédition sur Sips Office

Diagramme décrivant la prise de commande et 1ère expédition via Office

Vous effectuez une requête vers Sips Office en communiquant dans la requête les informations détaillées permettant la mise en place du paiement multiple à l'expédition.
Worldline Sips procède à la vérification 3-D Secure.
Worldline Sips effectue les contrôles anti-fraude.
Worldline Sips envoie une demande d’autorisation à l’acquéreur.
Worldline Sips enregistre la transaction dans le back office.
Worldline Sips vous retourne le résultat du paiement dans la réponse.
Worldline Sips envoie la transaction en remise (si applicable) en fonction des modalités que vous avez paramétré dans la requête de paiement.

Cas particulier de la première expédition distante avec la prise de commande

Dans certain cas, vous pouvez ne pas connaitre la date de première expédition de la commande de votre client. Pour les expéditions à une date supérieure à la validité de l'autorisation (en général 6 jours) ou pour les expéditions à une date inconnue, un comportement particulier est à mettre en place.

Pour ce type de prise de commande, le montant de la première expédition devra être à 0. Une demande de renseignement sera alors réalisée à la place d'une autorisation sur le montant de la première expédition. Votre client ne sera donc pas facturé à la prise de commande, mais au moment de la première expédition.

Une fois la prise de commande avec un montant renseignée à 0, vous obtenez une transaction pivot pouvant être réutilisée par la suite pour toutes les expéditions de la commande. Dans le cas d'un paiement avec le moyen de paiement CB, ce comportement est compatible avec la garantie de paiement éligible jusqu'a 30 jours.

Sur Sips Paypage, le montant global de la commande est indiqué ainsi que le montant de la première transaction qui est de 0.

Paramétrer la requête

Pour Sips Office, les méthodes cardCheckEnrollment et walletCheckEnrollment vous permettent d'initialiser un paiement multiple à l'expédition . Dans ces requêtes, vous devrez renseigner les paramètres comme indiqués dans le tableau ci-contre.

Pour Sips Paypage, les paramètres de la requête sont identiques à ceux utilisés sur Sips Office.

Champ	Règle de valorisation
`captureMode`	Doit être positionné à AUTHOR_CAPTURE ou VALIDATION en fonction de votre besoin
`captureDay`	Doit être inférieur à la durée de validité de l'autorisation dans le cas d'une première expédition connue Doit être positionné à 0 dans le cas particulier d'une première expédition inconnue
`paymentPattern`	MULTIPLE_1
`amount`	Doit être valorisé avec le montant de la première expédition. Dans le cas particulier de la première expédition supérieure à la durée de validitié de l'authentification ou une première expédition à une date inconnue, ce champ doit être valorisé à 0
`authenticationData.authentAmount`	Doit être valorisé avec le montant global de la commande;
`fraudData.challengeMode3DS`	Indiquez votre souhait d'exemption

Analyser la réponse

En fonction de la réponse retournée par Worldline Sips sur Sips Paypage ou sur Sips Office), vous déterminez la statut de la transaction

Les champs relatifs à la prise de commande sont les suivants :

Etat Champs de la réponse

Etat	Champs de la réponse
Transaction acceptée (premier paiement effectué avec succès)	`responseCode` = 00 `acquirerResponseCode` = 00
Transaction refusée (premier paiement refusé)	`responseCode` = XX (différent de 00) Consultez le guide connecteur Sips Paypage pour analyser la réponse de Worldline Sips

Transaction acceptée (premier paiement effectué avec succès)

responseCode = 00

acquirerResponseCode = 00

Transaction refusée (premier paiement refusé)

responseCode = XX (différent de 00)

Consultez le guide connecteur Sips Paypage pour analyser la réponse de Worldline Sips

Traitement des expéditions suivantes : MIT

Au moment de l'envoi d'une marchandise, vous voudrez facturer votre client. Pour cela, il vous faudra réaliser une nouvelle transaction sur Worldline Sips. Pour cette transaction, votre client n'aura pas besoin d'être présent (MIT).

Pour facturer votre client sur une nouvelle expédition de marchandise, plusieurs options s'offrent à vous :

L'opération de gestion de caisse de duplication
La création d'une nouvelle transaction

Nouvelle expédition facturée à partir d'une duplication

L'appel à la fonction de duplication vous permet de procéder au paiement de chaque expédition suivante (MIT) à partir de la transaction de prise de commande.

Via la méthode duplicate, Worldline Sips chaine automatiquement chaque expédition (MIT) avec la transaction créée lors de la prise de commande (CIT)

Consultez le guide connecteur Sips Office pour mettre en place l'appel à la fonction duplicate

Nouvelle expédition à partir d'une nouvelle transaction

L'appel à la méthode cardOrder et walletOrder vous permettront de réaliser une nouvelle transaction correspondant à une nième expédition de la commande de votre client.

Pour ces transactions, vous devrez positionner les paramètres suivants :

Champ	Règle de valorisation
`initialSchemeTransactionIdentifier`	valeur du champ `schemeTransactionIdentifier` retourné lors de la prise de commande (CIT)
`paymentPattern`	doit être valorisé à MULTIPLE_N
`initialHolderAuthentProgram`	valeur du champ `holderAuthentProgram` retourné lors de la prise de commande (CIT)
`initialAuthentDateTime`	valeur du champ `authentDateTime` retourné lors de la prise de commande (CIT)
`initialHolderAuthentType`	valeur du champ `holderAuthentType` retourné lors de la prise de commande (CIT)
`initialChallengeMode3DS`	valeur du champ `challengeMode3DS` retourné lors de la prise de commande (CIT)

Consultez le guide connecteur Sips Office pour mettre en place l'appel à la méthode cardOrder et walletOrder

Synthèse

Paiement multiple à l’expédition dont 1ère expédition à moins de 6 jours

Voici un exemple de paiement multiple à l'expédition avec une 1ère expédition à moins de 6 jours :

Connecteurs :

	CIT	MIT
Connecteur	Sips Paypage Sips Office Sips In-App	Sips Office Sips Office Batch

Paramètres de la requête :

champ	CIT	MIT via duplicate	MIT via cardOrder ou walletOrder
paymentPattern	MULTIPLE_1	X	MULTIPLE_N
ChallengeMode3DS	NO_CHALLENGE CHALLENGE NO_PREFERENCE NO_CHALLENGE_TRA_ACQ	X	X
captureDay	[ 0 , 6 ]	[ 0 , 99 ]	[ 0 , 99 ]
captureMode	AUTHOR_CAPTURE VALIDATION	AUTHOR_CAPTURE VALIDATION	AUTHOR_CAPTURE VALIDATION
amount	montant 1ère expédition	montant nème expédition	montant nème expédition
authentAmount	montant total de la commande	X	X
initialSchemeTransactionIdentifier	X	X	valeur du champ schemeTransactionIdentifier reçu en réponse de la CIT
initialHolderAuthentProgram	X	X	valeur du champ holderAuthentProgram reçu en réponse de la CIT
initialAuthentDateTime	X	X	valeur du champ authentDateTime reçu en réponse de la CIT
initialHolderAuthentType	X	X	valeur du champ holderAuthentType reçu en réponse de la CIT
initialChallengeMode3DS	X	X	valeur du champ challengeMode3DS reçu en réponse de la CIT

Paiement multiple à l’expédition dont 1ère expédition à plus de 6 jours

Voici un exemple de paiement multiple à l'expédition avec une 1ère expédition à plus de 6 jours :

Connecteurs :

	CIT	MIT
Connecteur	Sips Paypage Sips Office Sips In-App	Sips Office Sips Office Batch

Paramètres de la requête :

champ	CIT	MIT via duplicate	MIT via cardOrder ou walletOrder
paymentPattern	MULTIPLE_1	X	MULTIPLE_N
ChallengeMode3DS	NO_CHALLENGE CHALLENGE NO_PREFERENCE NO_CHALLENGE_TRA_ACQ	X	X
captureDay	0	[ 0 , 99 ]	[ 0 , 99 ]
captureMode	X	AUTHOR_CAPTURE VALIDATION	AUTHOR_CAPTURE VALIDATION
amount	0	montant nème expédition	montant nème expédition
authentAmount	montant total de la commande	X	X
initialSchemeTransactionIdentifier	X	X	valeur du champ schemeTransactionIdentifier reçu en réponse de la CIT
initialHolderAuthentProgram	X	X	valeur du champ holderAuthentProgram reçu en réponse de la CIT
initialAuthentDateTime	X	X	valeur du champ authentDateTime reçu en réponse de la CIT
initialHolderAuthentType	X	X	valeur du champ holderAuthentType reçu en réponse de la CIT
initialChallengeMode3DS	X	X	valeur du champ challengeMode3DS reçu en réponse de la CIT

Démarrer le paiement multiple à l'expédition en 4 étapes

Etape 1 - Mettre en œuvre le service

Lorsque vous avez choisi les interfaces Worldline Sips qui répondent à votre besoin (cf. chap. Choix des connecteurs Worldline Sips), vous devez intégrer les connecteurs pour connecter votre site Web à Worldline Sips et suivre les indications de la partie mise en œuvre.

Votre boutique doit être configurée sur Worldline Sips pour accepter le paiement en plusieurs fois. Vous devez demander à Worldline d’activer ce service sur votre boutique si ce n'est pas déjà le cas.

Etape 2 - Tester le service sur l'environnement de recette

Une fois la mise en œuvre des connecteurs Worldline Sips réalisée, vous pouvez effectuer des tests pour valider votre intégration.

Données de test
merchantId	201000076690001
clé secrète	p64ifeYBVIaRcjaWoahCiw9L8wokNLqG2_YOj_POD4g
version de la clé	1
cartes de test	cf page "Cartes de test"

Serveur	URL de test
Paypage POST	https://payment-webinit.test.sips-services.com/paymentInit
Paypage JSON	https://payment-webinit.test.sips-services.com/rs-services/v2/paymentInit
Paypage SOAP	https://payment-webinit.test.sips-services.com/services/v2/paymentInit
Office	https://office-server.test.sips-services.com

IMPORTANT: la boutique de test est configurée en mode transactionReference, sans génération automatique du transactionReference. Par conséquent, il est nécessaire que vous transmettiez le champ transactionReference valorisé dans vos requêtes de test.

Etape 3 - Souscrire au service en production

Votre boutique n’est pas inscrite sur Worldline Sips.

Si votre boutique n’a pas encore été inscrite, vous devez remplir le formulaire d’inscription et le retourner à Worldline.

Votre boutique est déjà inscrite sur Worldline Sips.

Si votre boutique est déjà inscrite sur Worldline Sips, vous devez vous assurer auprès de Worldline que vous avez bien accès à Sips Paypage ou à Sips Office en fonction du connecteur choisi.

Etape 4 - Démarrer et valider le service en production

Vous devez changer l’URL pour vous connecter au serveur Worldline Sips de production en utilisant les identifiants reçus à l'issue de l’inscription merchantId, secretKey et keyVersion.

URL Worldline Sips	URL du serveur de paiement Worldline Sips récupéré par e-mail.
MerchantId	Identifiant de la boutique reçu par mail.
SecretKey	Clé secrète que vous récupérez via l’extranet Sips Download.
KeyVersion	Version clé secrète récupérée sur Sips Download (logiquement 1 pour la 1ère clé).

Tip: une erreur fréquente est d’oublier un de ces quatre paramètres, ce qui conduit systématiquement à une erreur.

Si vous souhaitez personnaliser vos pages de paiement, veuillez suivre la procédure décrite dans la documentation Custompages.

WL SIPS DOCS