WL SIPS DOCS

Release 21.4

aller directement au contenu
Rechercher par mots clés

Intégration Lyf Pay

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

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.

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.

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 paiement 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 ».
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

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

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


formulaire-saisie-mobile-fr

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


validation-paiement-fr

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

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.

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 :


ProcessPayment-LyfPay-FR

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


process-paypage-lyf-pay-fr

Les champs suivants 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 La valeur envoyée dans la requête est ignorée.
Le type de paiement est forcé à ONE_SHOT.

Le tableau suivant récapitule les différents cas de réponse à traiter :

État Champs de la réponse Action à réaliser
Paiement accepté acquirerResponseCode = 00
authorisationId = (voir le Dictionnaire des données).
Vous pouvez livrer la commande.
Refus acquéreur acquirerResponseCode = (voir le Dictionnaire des données). L’autorisation est refusée pour un motif non lié à la fraude.
Si vous n’avez pas opté pour l’option « nouvelle tentative de paiement » (pour plus de détails veuillez consulter le Guide de configuration des fonctionnalités), vous pouvez proposer à votre client de payer avec un autre moyen de paiement en générant une nouvelle requête.
Refus nombre max essais atteint responseCode = 75 Le client a fait plusieurs tentatives qui ont toutes échoué.
Refus suite problème technique acquirerResponseCode = 90-98
responseCode = 90, 99
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement.

Pour connaître l'intégralité des codes réponses (responseCode) et codes réponses acquéreur (acquirerResponseCode), veuillez vous référer au Dictionnaire des données.

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

Les opérations suivantes sont disponibles sur les transactions Lyf Pay :

Gestion de caisse
Annulation V
Validation V
Remboursement V
Duplication X
Recyclage V
Crédit X

Le diagramme ci-dessous vous permet de savoir quelle opération de gestion de caisse est disponible lorsqu'une transaction est dans un état donné :


ProcessCashManagement-LyfPay-FR

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.

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
Note: pour les transactions Lyf Pay, le champ paymentMeanBrand est renseigné avec la valeur FIVORY.

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 :


screen-soe-lyf-pay-fr

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.

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 (le client 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.

Ce site utilise des cookies 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 cookies sur votre appareil.

Paramètres