WL SIPS DOCS

Release 21.6

aller directement au contenu
Rechercher par mots clés

Paiement multiple à l'expédition

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

Avant de lire ce document nous vous conseillons

  • Conseillé

    Chainage MIT/CIT

    Documentation fonctionnelle, technique et guides utilisateurs pour vous aider à intégrer la solution de paiement en ligne WL Sips.

    Ouvrir ce document dans un nouvel onglet

WL 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 de la solution de paiement en plusieurs fois jusqu'au démarrage en production.

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 WL Sips.

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

  • Présentation fonctionnelle
  • Guide de Configuration des fonctionnalités

Pour vous permettre d'effectuer des paiements multiples à l'expédition, WL 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 WL 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.

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.

Comme WL 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

En fonction de la manière dont vous traiter 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)
Sips Office via walletOrder

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)

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.

enroler-via-paypage

  1. 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.
  2. WL 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.
  3. WL Sips procède à la vérification 3-D Secure.
  4. WL Sips effectue les contrôles anti-fraude.
  5. WL Sips envoie une demande d’autorisation à l’acquéreur.
  6. WL Sips enregistre la transaction et ses informations dans le back office.
  7. WL Sips vous retourne les réponses manuelles et automatiques contenant les détails de la transaction.
  8. WL Sips envoie la transaction en remise en fonction des modalités que vous avez paramétré dans la requête de paiement.

enroler-via-office

  1. 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.
  2. WL Sips procède à la vérification 3-D Secure.
  3. WL Sips effectue les contrôles anti-fraude.
  4. WL Sips envoie une demande d’autorisation à l’acquéreur.
  5. WL Sips enregistre la transaction dans le back office.
  6. WL Sips vous retourne le résultat du paiement dans la réponse.
  7. WL Sips envoie la transaction en remise (si applicable) en fonction des modalités que vous avez paramétré dans la requête de paiement.

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.

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;
authenticationData.challengeMode3DS Indiquez votre souhait d'exemption

En fonction de la réponse retournée par WL 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

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 WL Sips

Au moment de l'envoi d'une marchandise, vous voudrez facturer votre client. Pour cela, il vous faudra réaliser une nouvelle transaction sur WL 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'offre à vous :

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

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, WL Sips chaine automatique 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

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

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

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


frise-chrono-premiere-expedition-moins-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

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


frise-chrono-premiere-expedition-plus-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

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

Votre boutique doit être configurée sur WL 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.

Une fois la mise en œuvre des connecteurs WL 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.

Votre boutique n’est pas inscrite sur WL 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 WL Sips.

Si votre boutique est déjà inscrite sur WL 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.

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

URL WL Sips URL du serveur de paiement WL 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.

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 WL Sips.
En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

Paramètres