Introduction

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étier 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 l'intégration du moyen de paiement Lyf Pay dans WL Sips .

À qui s’adresse ce document ?

Ce document a pour objectif de vous aider à implémenter le moyen de paiement Lyf Pay sur votre site de commerce électronique.

Il comprend :

  • des informations fonctionnelles à votre attention ;
  • des instructions d'implémentation à destination de votre équipe technique.

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 .

Comprendre les paiements Lyf Pay avec WL Sips

Principes généraux

Lyf Pay est une initiative européenne regroupant BNP Paribas, Carrefour, Crédit Mutuel, Auchan, Mastercard, Oney et Total. C'est un nouveau moyen de paiement permettant d’effectuer des achats en ligne avec votre Smartphone.

Le client est redirigé vers une page de saisie de son numéro de téléphone mobile, avant de valider son paiement via l’application Lyf Pay de son smartphone.

Note: le moyen de paiemnet Lyf Pay se nommait Fivory jusqu’en septembre 2017. Par conséquent, vous observerez dans cette documentation que le nom technique utilisé est resté « FIVORY ».

Règles d’acceptation

Fonctionnalités disponibles

Canaux de paiement
Internet V Canal de paiement par défaut
MOTO X
Télécopie X
SVI X
Typologies de paiement
Paiement immédiat V Méthode par défaut
Paiement en fin de journée X
Paiement différé X
Paiement à l'expédition V
Paiement en plusieurs fois X
Paiement par abonnement X
Paiement par fichier X
Paiement OneClick X
Gestion des devises
Acceptation multidevise X EUR uniquement
Règlement en devise X EUR uniquement

Pages de paiement

Le client sélectionne le moyen de paiement Lyf Pay.

Il est ensuite redirigé vers la page de la saisie des informations requises :

Après avoir fourni les informations requises, le client est redirigé vers la page de vérification pour un paiement Lyf Pay :

Le ticket de paiement s’affiche, puis le client retourne sur votre site Web.

Ouvrir votre contrat d’acceptation Lyf Pay

Afin de proposer le moyen de paiement Lyf Pay sur votre site Web, vous devez souscrire un contrat d'acceptation auprès de votre banque acquéreur. Vous nous transmettez par la suite le numéro de contrat afin de l’enregistrer dans notre système d’information.

Effectuer un paiement Lyf Pay

Vous pouvez proposer le moyen de paiement Lyf Pay au travers de l’interface Sips Paypage qui assure l’interface de paiement directement avec le client via son navigateur Web.

Les modes de remise disponibles pour une transaction Lyf Pay sont les suivants :

  • Mode validation : vous devez valider la transaction pour déclencher la remise. Un délai de capture doit aussi être défini. Lorsque ce délai de capture est atteint ou dépassé, vous ne pourrez plus valider la transaction, celle-ci expirera donc automatiquement.
  • Mode immédiat : l'autorisation et la remise sont exécutées en ligne simultanément.

Le diagramme ci-dessous explique les différents états par lesquels peuvent passer les transactions selon le mode de capture choisi :

Effectuer un paiement Lyf Pay avec Sips Paypage

La cinématique de paiement pour Sips Paypage est décrite ci-dessous :

Insérer le diagramme

Paramétrer la requête de paiement

Cette partie présente l’ensemble des données échangées entre les différents acteurs (commerçant, WL Sips , Lyf Pay) lors d’une requête de paiement Lyf Pay.

Aucune information spécifique n'est requise pour soumettre une requête de paiement Lyf Pay, cependant, les champs ci-dessous ont un comportement particulier :

Nom du champ Remarques / règles
captureDay La valeur envoyée dans la requête doit être de 30 au maximum.
Une valeur supérieure sera forcée à 30.
paymentPattern Forcé à ONE_SHOT
amount Formaté en centimes
paypageData.byPassReceiptPage Facultatif :
permet de ne pas afficher le ticket WL Sips à la fin de la cinématique de paiement.

Analyser la réponse

Les champs spécifiques suivants sont valorisés dans le cas d’un paiement Lyf Pay.

Nom du champ Remarques / règles
paymentMeanType Toujours valorisé à WALLET.
paymentMeanBrand Toujours valorisé à FIVORY.

Effectuer un paiement Lyf Pay avec Sips Office

L’acceptation du moyen de paiement Lyf Pay n’est pas disponible au travers de la solution Sips Office .

Gérer vos transactions Lyf Pay

Réservation/libération des fonds

Lors d’un paiement Lyf Pay, la demande d’autorisation entraîne la réservation des fonds. Cette particularité a plusieurs conséquences sur le cycle de vie des transactions en mode validation.

Validation partielle :

  • par défaut, une validation partielle entraîne la libération des fonds non validés ;
  • si vous libérez les fonds lors d’une validation partielle, le montant non validé restera réservé par Lyf Pay. Il devient alors possible d’utiliser les fonds restants via un recyclage, ou de les libérer via un recyclage à 0 €.

Un champ supplémentaire détaillé ci-dessous peut être utilisé dans la requête de validation.

Nom du champ Remarques / règles Exemple de valorisation
lastRecoveryIndicator Facultatif : par défaut, vaut TRUE.
Permet de demander la libération des fonds restants chez Lyf Pay en cas de validation partielle.
TRUE ou FALSE

Annulation :

  • l’annulation totale est autorisée, entraînant la libération des fonds ;
  • suite à l’annulation totale, le recyclage n’est plus possible.

Recyclage :

  • par défaut, un recyclage partiel n’entraîne pas la libération des fonds restants ;
  • si vous activez la libération des fonds lors d’un recyclage partiel, le montant restant non recyclé sera libéré par Lyf Pay ;
    • cas particulier : un recyclage avec un montant égal à 0 entraîne la libération de la totalité des fonds restants chez Lyf Pay. La nouvelle transaction créée est immédiatement mise dans un statut définitif « annulé ».

Un champ supplémentaire détaillé ci-dessous peut être utilisé dans la requête de recyclage.

Nom du champ Remarques / règles Exemple de valorisation
lastRecoveryIndicator Facultatif : par défaut, vaut FALSE.
Permet de demander la libération des fonds restants chez Lyf Pay en cas de recyclage partiel.
Dans le cas d’un recyclage à 0, le champ est obligatoire et doit être valorisé à « TRUE ».
TRUE ou FALSE

Expiration (i.e. si la transaction n’est ni validée ni annulée dans le délai imparti) :

  • les fonds ne sont pas automatiquement libérés à l’expiration de la transaction. Suite à cette expiration, 2 choix sont possibles :
    • vous libérez les fonds via un recyclage à 0 ;
    • vous recyclez partiellement ou totalement la transaction.

Consulter vos transactions Lyf Pay

Journaux

Les journaux mis à disposition par WL Sips vous permettent d’avoir une vision exhaustive et consolidée de vos transactions, opérations de caisse, situation comptable et impayés. Vous pouvez utiliser ces informations pour enrichir votre système d’information.

La disponibilité des transactions Lyf Pay pour chaque type de journal est récapitulé dans le tableau ci-dessous :

Disponibilité des journaux
Journal des transactions V
Journal des opérations V
Journal de rapprochement des transactions V
Journal de rapprochement des impayés X

Sips Office Extranet

Vous pouvez consulter le détail de vos transactions Lyf Pay et effectuer différentes opérations de gestion de caisse grâce à Sips Office Extranet .

Voici le détail d'une transaction Lyf Pay :

Annexes

Codes réponse

Création de paiement

Pour le moyen de paiement Lyf Pay, WL Sips peut retourner l’ensemble des codes ci-dessous :

Code réponse Acquéreur Code réponse WL Sips Signification
00 00 Transaction acceptée
05 05 Transaction refusée
17 17 Transaction annulée
- 17 Transaction annulée sur WL Sips
60 60 Transaction en attente
90 90 Problème technique
97 97 Session expirée
- 99 Problème technique
Attention: tout autre code réponse que ceux recensés dans le tableau ci-dessus, doit être interprété comme un refus.

Interruption de paiement

Dans le cas d’une interruption de paiement, vous recevrez un code réponse 60. Ces cas sont :

  • cas n°1 : une erreur technique où WL Sips n’a pas reçu la réponse de Lyf Pay ;
  • cas n°2 : une interruption brusque de cinématique (utilisateur qui ferme son navigateur au cours du paiement, coupure réseau…).

Ce sont des cas exceptionnels où le résultat final du paiement n’est pas immédiatement connu.

Dans les deux cas, au bout de 20 minutes vous recevrez de la part de WL Sips une réponse automatique qui contiendra le code final de la transaction :

  • code réponse 00 : la transaction est acceptée ;
  • code réponse 90 : la transaction est refusée.

Vous pouvez traiter ces cas d’interruptions comme suit :

  • cas n°1 : le client est redirigé vers votre site Web et vous recevez une réponse manuelle et automatique contenant un code 60. Vous pouvez alors afficher un message générique à votre client et attendre la seconde réponse automatique (après 20 minutes) pour statuer de l’état final du paiement ;
  • cas n°2 : le client n'est pas redirigé vers votre site Web et il n’y a pas de réponse immédiate. Vous recevrez après 20 minutes la réponse automatique contenant le résultat final.