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é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 Worldline 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 Worldline Sips, nous vous conseillons de consulter les documents suivants :
- Présentation fonctionnelle
- Guide de configuration des fonctionnalités
Comprendre les paiements Lyf Pay avec Worldline 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.
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 :
Paramétrer la requête de paiement
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. |
Analyser la réponse
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 =
00authorisationId = (voir le
Dictionnaire des données).paymentMeanBrand =
FIVORYpaymentMeanType =
WALLETresponseCode =
00 |
Vous pouvez livrer la commande. |
| Refus acquéreur | acquirerResponseCode = (voir
le Dictionnaire des données).responseCode =
05 |
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.
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
Opérations de caisse disponibles
Les opérations suivantes sont disponibles sur les transactions Lyf Pay :
| Gestion de caisse | ||
|---|---|---|
| Annulation | V | |
| Validation | V | |
| Remboursement | V | |
| Duplication | X | |
| 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é :
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.
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 ;
| Nom du champ | Remarques / règles | Exemple de valorisation |
|---|---|---|
| lastRecoveryIndicator | Facultatif : est défini à FALSE par défaut. Permet de demander à Lyf Pay de débloquer les fonds restants en cas de recyclage partiel. Dans le cas d'un recyclage défini à 0, le champ est obligatoire et doit être défini à "VRAI". | 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.
Consulter vos transactions Lyf Pay
Journaux
Les journaux mis à disposition par Worldline 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.
Annexes
Codes réponse
Création de paiement
Pour le moyen de paiement Lyf Pay, Worldline Sips peut retourner l’ensemble des codes ci-dessous :
| Code réponse Acquéreur | Code réponse Worldline Sips | Signification |
|---|---|---|
| 00 | 00 | Transaction acceptée |
| 05 | 05 | Transaction refusée |
| 17 | 17 | Transaction annulée |
| - | 17 | Transaction annulée sur Worldline Sips |
| 60 | 60 | Transaction en attente |
| 90 | 90 | Problème technique |
| 97 | 97 | Session expirée |
| - | 99 | Problème technique |
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ù Worldline 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 Worldline 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.
