Introduction

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 de ce document est d'expliquer la mise en oeuvre de la solution OneClick jusqu'au démarrage en production.

A qui s’adresse ce document

Ce document a pour objectif de vous aider à mettre en place une solution sécurisée permettant à vos clients réguliers de stocker leurs coordonnées de paiement en vue d’achats futurs. Il présente les fonctionnalités liées au paiement OneClick et décrit comment les mettre en œuvre avec la solution Sips .

L’objectif de la solution OneClick est de faciliter l’acte d’achat (et ainsi augmenter le taux de conversion) en améliorant l’expérience utilisateur, notamment pour les paiements effectués via mobiles.

Le principe est de permettre au client de payer en un seul clic sur les pages de paiement Sips . Il n’a pas à ressaisir ses coordonnées de paiement à chaque achat.

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

  • Présentation fonctionnelle
  • Guide de Configuration des fonctionnalités
Note: Sips ne gère pas les données personnelles des clients (nom, prénom, adresse, âge, email, téléphone ….) mais seulement les coordonnées de paiement.

Prérequis

Le paiement OneClick nécessite que les coordonnées de paiement de vos clients soient stockées par Sips pour vous permettre d’effectuer des paiements.

Avant de démarrer, vous devez déclarer auprès de l’instance en charge de la protection des données (la CNIL en France) le stockage des coordonnées de paiement de vos clients.

Contacter l'assistance

Pour toute question technique ou demande d'assistance, nos services sont disponibles :

  • par téléphone au : +33 (0) 811 10 70 33 ;
  • par e-mail : sips@worldline.com.

Pour faciliter le traitement de vos demandes, veuillez communiquer votre identifiant de commerçant : merchantId (numéro à 15 chiffres).

Vue d’ensemble du service OneClick

Le paiement OneClick comporte plusieurs volets :

  • L’enrôlement des coordonnées de paiement du client,
  • Le paiement OneClick ,
  • La gestion des coordonnées de paiement du client,
  • L’authentification du client.

Stockage des coordonnées de paiement du client

Lorsque vous enregistrez un client dans votre système d’information, vous devez lui associer un identifiant de compte unique ( merchantWalletId ) que Sips va utiliser pour stocker ses coordonnées de paiement. Cet identifiant sera utilisé pour les paiements ultérieurs.

Schéma de principe du paiement OneClick avec une carte :

Le schéma ci-dessus s’applique aussi au paiement OneClick avec un mandat SDD, un compte Paypal ou un wallet Paylib.

Le service OneClick se base sur le wallet Sips qui est un portefeuille virtuel sécurisé, conforme PCI, dans lequel sont stockées les coordonnées de paiement du client :

  • Le wallet est multi-moyen de paiement.
  • Identifiant OneClick = merchantWalletId
  • Identifiant du moyen de paiement = paymentMeanSequence

Les moyens de paiement utilisables en OneClick sont :

  • Carte CB, Visa, Mastercard, Amex, Bancontact, Oney
  • Compte Paypal
  • Mandat SDD (SEPA Direct Debit)
  • Wallet Paylib

Sips stocke dans le wallet toutes les informations nécessaires pour vous permettre de débiter votre client à partir de son identifiant :

  • Carte CB, Visa, Mastercard, Amex, Bancontact, Oney
    • Numéro de carte
    • Date d’expiration
    • Marque de la carte
  • Compte Paypal
    • Identifiant du compte Paypal
  • Wallet Paylib
    • Identifiant du wallet Paylib
  • Mandat SDD
    • Identifiant du mandat
Note: Par défaut, chaque boutique a sa propre base clients. Cependant, Sips permet de partager une même base wallet entre plusieurs boutiques d’une même enseigne.

Si vous êtes dans ce cas, veuillez contacter l’assistance technique.

Enrôlement des coordonnées de paiement du client

L’enrôlement du client consiste à enregistrer ses coordonnées de paiement dans le wallet de Sips . L’enrôlement peut être associé ou non à un premier paiement.

4 interfaces permettent d’enrôler un client :

  • Sips Paypage : les données de paiement sont enregistrées, lors d’un acte d’achat, depuis les pages de paiement hébergées par Sips .
  • Sips Office : vous gérez vos propres pages pour la saisie des données de paiement et vous utilisez l’interface web online pour enregistrer le client dans le wallet Sips (Attention : l’enrôlement des moyens de paiement Paypal et Paylib n’est pas disponible avec l’interface Sips Office ).
  • Sips Walletpage : les données de paiement sont enregistrées, en dehors d’un acte d’achat, depuis les pages de gestion de wallet hébergées par Sips .
  • Sips In-App : vous enregistrez les données de paiement du client lors du premier paiement réalisé sur votre application mobile.

Paiement OneClick

Pour les paiements ultérieurs, vous transférez dans les requêtes l’identifiant du client, afin que Sips retrouve ses coordonnées de paiement déjà enregistrées dans le wallet.

Note: Si l'identifiant du client n'est pas transmis dans la requête ou si la valeur transmise n'est pas connue de Sips , le client paiera de manière classique et non pas en mode OneClick .
3 types d’interfaces pour débiter les clients :
  • Sips Paypage : à chaque achat, vous transmettez l’identifiant du client dans la requête de paiement.
  • Sips Office : vous vous connectez à Sips via une interface Web online pour transmettre les demandes de débit.
  • Sips In-App : à chaque achat, vous transmettez l’identifiant du client dans la requête de paiement.

Gestion des coordonnées de paiement du client

Pour compléter l’enrôlement des moyens de paiement et de leur utilisation pour effectuer des achats, il est possible de gérer le contenu des wallets. Plusieurs interfaces permettent d’agir sur le wallet.

5 types d’interfaces sont disponibles pour gérer le contenu des wallet :

  • Sips Paypage : le client peut modifier son wallet lors d’un acte d’achat ;
  • Sips In-App : le client peut modifier son wallet pendant ou en dehors d'un acte d'achat ;
  • Sips Walletpage : le client peut modifier son wallet en dehors d’un acte d’achat ;
  • Sips Office : le commerçant peut modifier le wallet de ses clients ;
  • Sips Office Extranet : le commerçant peut supprimer les moyens de paiement du wallet de ses clients.

Moyen de paiement expiré :

  • si le moyen de paiement est expiré, il n'est pas sélectionable sur la page de paiement OneClick
  • les moyens de paiement, expirés depuis plus de 3 mois, sont supprimés automatiquement de la base wallet

Authentification du client

Dans la cinématique OneClick , vous devez authentifier votre client avant d’accéder à l’identifiant stocké dans votre base client.

Une fois l’authentification faite, vous transmettez à Sips l’identifiant client dans la requête via le champ merchantWalletId .

Votre gestion des identifiants attribués à vos clients doit :

  • Garantir une relation 1-1 entre le client et son identifiant (1 client = 1 identifiant OneClick ),
  • Permettre le stockage permanent des identifiants OneClick .
Note: L’authentification du client est sous votre responsabilité.

Sips gère le stockage sécurisé des coordonnées de paiement du client.

Personnalisation des pages

Afin de conserver la charte graphique de votre site e-commerce, les pages des interfaces Sips Paypage et Sips Walletpage sont personnalisables.

Veuillez consulter le document "Guide de personnalisation des pages de paiement (Paypage)" pour davantage d’informations.

Reporting

Pour plus d’informations, merci de consulter le guide de description des journaux.

Choix des connecteurs pour OneClick

Sips propose plusieurs interfaces pour enrôler les clients et traiter les paiements. Il convient, par conséquent, d’analyser votre besoin métier pour choisir le connecteur les plus adaptées à votre situation.

Le tableau ci-dessous vous aide à faire votre choix.

Interfaces
Cas d’usage
Sips Paypage Sips Office Sips In-App Sips Walletpage Sips Office Extranet Préconisations pour choisir le connecteur
Gestion des pages d’enrôlement
Vous externalisez les pages de saisie des coordonnées de paiement pour vous affranchir des exigences PCI V X X V X Si vous utilisez Sips Paypage pour traiter vos paiements, vous pouvez capitaliser cette intégration existante pour gérer l’enrôlement de vos clients.

Sinon, nous préconisons l’usage de Sips Walletpage .
Vous gérez les pages de saisie des coordonnées de paiement que vous intégrez dans votre processus d’enrôlement des clients X V V X X Sips Office répond à votre besoin pour le e-commerce. Pour le m-commerce, nous préconisons l’usage de Sips In-App .
Enrôlement avec ou sans paiement
Vous permettez à votre client d’enrôler son moyen de paiement lors d’un acte d’achat V V V X X Sips Paypage , Sips Office ou Sips In-App répondent à votre besoin, en fonction de votre décision d’externaliser ou pas les pages de saisie des coordonnés de paiement.
Vous permettez à votre client d’enrôler son moyen de paiement en dehors d’un acte d’achat X V V V X Sips Walletpage , Sips Office ou Sips In-App répondent à votre besoin, en fonction de votre décision d’externaliser ou pas les pages de saisie des coordonnées de paiement.
Paiement OneClick
Vous externalisez les pages de paiement V X X X X Sips Paypage répond à votre besoin.
Vous gérez les pages de paiement sur votre site ou votre application mobile X V V X X Sips Office répond à votre besoin pour le e-commerce. Pour le m-commerce, nous préconisons l’usage de Sips In-App .
Créditer le client
Vous avez besoin de créditer un de vos clients hors contexte de remboursement X V X X X Sips Office répond à votre besoin.
Gérer les coordonnées de paiement de votre client
Le client souhaite modifier l’alias d’un de ses moyens de paiement V V X V X Réutilisez la même interface que celle utilisée pour l’enrôlement. Toutefois, si vous utilisez Sips In-App pour l’enrôlement, nous préconisons d’utiliser Sips Office pour ce cas.
Le client souhaite supprimer un de ses moyens de paiement V V V V V Réutilisez la même interface que celle utilisée pour l’enrôlement. Toutefois, si vous utilisez Sips In-App pour l’enrôlement, nous préconisons d’utiliser Sips Office pour ce cas.

Si vous ne pouvez, ou ne souhaitez pas développer l’accès à la fonction "suppression" pour vos clients, vous pouvez vous-même supprimer le moyen de paiement du wallet de vos clients depuis Sips Office Extranet .
Le client souhaite supprimer son wallet X V X V X Si vous utilisez déjà Sips Walletpage pour traiter d’autres cas d’usage, conservez cette interface pour permettre à votre client de supprimer son wallet.

Mise en œuvre

Afin de mettre en œuvre le service OneClick , vous devez vous munir du guide des connecteurs adéquat pour prendre connaissance des détails techniques d’implémentation.

Enrôler les coordonnées de paiement de votre client avec Sips Paypage

Il s’agit d’une cinématique de paiement Sips Paypage classique dans laquelle les coordonnées de paiement sont enregistrées dans le wallet en cas de transaction acceptée.

Description

Voici un exemple de cinématique valable pour les moyens de paiement CB, VISA et MASTERCARD :

1. Pour enregistrer les coordonnées de paiement du client vous le redirigez vers en communiquant dans la requête les données de la transaction (montant, devise, ..) ainsi que l’identifiant du client (champ merchantWalletId ).

2. Sips affiche la page de paiement, le client fournit ses coordonnées de paiement puis valide.

3. Sips procède à la vérification 3D-Secure.

4. Sips effectue les contrôles anti-fraude.

5. Sips envoie une demande d’autorisation à l’Acquéreur.

6. Sips enregistre la transaction dans le back office.

7. Si la transaction est acceptée, Sips enregistre les coordonnées de paiement du client dans le wallet.

8. Sips affiche la page de ticket de paiement avec un message de confirmation de l’enregistrement du moyen de paiement du client.

9. Sips vous retourne les réponses manuelle et automatique contenant les détails de la transaction y compris le résultat de l’enregistrement du client dans le wallet.

10. Sips envoie la transaction en remise en fonction des modalités que vous avez paramétrées dans la requête de paiement.

La séquence décrite ci-dessus se transpose sur les moyens de paiement Amex, Oney, SDD, Paypal et Paylib.

Paramétrer la requête

Pour enrôler un client au service OneClick via Sips Paypage , vous devez renseigner le champ ci-dessous :

Champ Valorisation
merchantWalletId Identifiant unique du client

Veuillez consulter le guide Sips Paypage correspondant au connecteur choisi (JSON, POST ou SOAP) pour savoir comment renseigner la requête en fonction de votre besoin métier.

Analyser la réponse

Sips retourne une réponse manuelle et automatique classique Sips Paypage .

Les champs relatifs à l’enrôlement du client sont les suivants :

État Champs de la réponse Actions à réaliser
Transaction acceptée

Client enrôlé
responseCode = 00

acquirerResponseCode = 00

paymentMeanId = numéro de séquence du moyen de paiement
merchantWalletId = idem requête

walletType = non renseigné

Stockez dans votre base client les données suivantes du client :
  • merchantWalletId
  • paymentMeanId
  • panExpiryDate
  • maskedPAN
Transaction acceptée

Client non enrôlé
responseCode = 00

acquirerResponseCode = 00

paymentMeanId = non renseigné

merchantWalletId = idem requête

walletType = non renseigné
Transaction acceptée mais le moyen de paiement du client n’a pas été enrôlé pour une des raisons suivantes :
  • Le client n’a pas souhaité enregistrer son moyen de paiement
  • Le client a saisi une carte virtuelle
  • Le nombre maximum de moyen de paiement autorisés dans le wallet a été atteint
  • Un problème technique ponctuel a eu lieu lors de l’enrôlement du moyen de paiement dans le wallet.
Transaction refusée

Client non enrôlé
responseCode = différent de 00 Consultez le guide Sips Paypage correspondant au connecteur choisi (JSON, POST ou SOAP) pour analyser la réponse de Sips .

Enrôler les coordonnées de paiement de votre client avec Sips Office

Avant d’enregistrer le moyen de paiement dans le wallet, vous devez au préalable l’avoir vérifié via une requête d'authentification 3-D Secure et/ou via une requête de paiement standard.

Note: A noter qu’il n’est pas possible d’enrôler un compte PayPal, ni un wallet Paylib dans le wallet avec Sips Office .

Description

Vous gérez la saisie des données du moyen de paiement sur votre site Web.

  1. Etape 1 : Vous faîtes une requête à Sips pour vérifier le moyen de paiement avant d’enrôler Le client .
    • Authentification 3-D Secure pour vérifier que c’est bien le titulaire qui utilise la carte (CB, Visa, Mastercard).
    • Contrôles de lutte contre la fraude que vous avez configurés en fonction de vos règles métier (ex. carte étrangère, carte commerciale, ..)
    • Demande d’autorisation vers l’acquéreur pour vérifier que la carte n’est pas en opposition (carte volée, perdue, ..)
    1. Sips enregistre la transaction.
    2. En fonction des éléments fournis dans la requête, Sips envoie, ou pas, la transaction en remise vers l’acquéreur.
    • Sips vous envoie les résultats de la vérification du moyen de paiement.
  2. Etape 2 : Une fois la vérification du moyen de paiement effectuée, vous sollicitez Sips une seconde fois pour enregistrer le moyen de paiement dans le wallet.
  3. Sips vous retourne la réponse de l’enregistrement du moyen de paiement.

La séquence décrite ci-dessus se transpose sur Amex, Oney et SDD .

Paramétrer les requêtes de vérification du moyen de paiement

Vous utilisez les méthodes ci-dessous en fonction du niveau de vérification du moyen de paiement à enrôler.

Carte CB, Visa, Mastercard, Oney, AMEX

Méthodes du service CheckOut Type de vérification

cardCheckEnrollment

cardValidateAuthentication

Authentification 3-D Secure seule
CardOrder Demande d’autorisation avec contrôles anti-fraude

cardCheckEnrollment

cardValidateAuthenticationAndOrder

Authentification 3DS et demande d’autorisation avec contrôles anti-fraude

Mandat SDD

Méthodes du service CheckOut Type de vérification
directDebitOrder Demande d’autorisation SDD avec contrôle anti-fraude

Veuillez consulter le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) ainsi que les guides des moyens de paiement pour connaître les détails d'implémentation.

Analyser la réponse d’authentification

Méthode cardValidateAuthentication

Etat Champs de la réponse Action à réaliser
Porteur authentifié holderAuthentResponseCode = 00 Vous pouvez enregistrer la carte dans le wallet via la méthode addcard .
Échec d’authentification du porteur holderAuthentResponseCode=01 Indiquez au client que son numéro de carte est invalide et demandez-lui d’enrôler un autre moyen de paiement
Autres refus holderAuthentResponseCode=XX

Si l’authentification 3DS est une obligation pour votre business pour enrôler une carte, demandez au client d’enrôler un autre moyen de paiement.

Si l’authentification 3DS n’est pas une obligation pour votre business pour enrôler une carte, vous pouvez poursuivre la vérification de la carte avec une requête cardOrder.

Analyser la réponse d’autorisation avec contrôles fraude

Méthodes CardOrder, cardValidateAuthenticationAndOrder et directDebitOrder

Etat Champs de la réponse Action à réaliser
Transaction acceptée

responseCode = 00

acquirerResponseCode = 00

Vous pouvez enregistrer la carte dans le wallet via la méthode addcard ou addDirectDebit.
Transaction refusée responseCode = XX Indiquez au client que son numéro de carte est invalide et demandez-lui d’enrôler un autre moyen de paiement.

Paramétrer la requête d’enrôlement des coordonnées de paiement du client

Vous utilisez les méthodes ci-dessous en fonction du moyen de paiement à enrôler. Le champ merchantWalletId contient l’identifiant du client.

Carte CB, Visa, Mastercard, Oney, Amex

Méthodes du service wallet Type d’action
addcard Ajout d’une carte dans le wallet

Mandat SDD

Méthodes du service wallet Type d’action
addDirectDebit Ajout d’un mandat dans le wallet

Veuillez consulter le guide Sips Office adéquat ainsi que les guides des moyens de paiement pour savoir comment renseigner la requête en fonction de votre besoin métier.

Analyser la réponse d’enrôlement

État Champs de la réponse Action à réaliser
Client enrôlé

walletReponseCode = 00

paymentMeanId = numéro de séquence du moyen de paiement

Vous pouvez finaliser l’enregistrement du client dans votre système d’information.

Client non enrôlé

Requête invalide

walletReponseCode = xx

paymentMeanId = non renseigné

Consultez le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) pour analyser la réponse de Sips .

Enrôler les coordonnées de paiement du client avec Sips Walletpage

Avec Sips Walletpage , vous permettez à votre client de s’enrôler en dehors d’un contexte de paiement.

Description

1. Lors du processus d’enrôlement de votre client , vous le redirigez vers Sips Walletpage pour lui permettre d’enregistrer ses coordonnées de paiement. Le client sélectionne un moyen de paiement, fournit ses coordonnées de paiement puis valide.

2. Sips procède à la vérification 3D-Secure.

3. Sips effectue les contrôles anti-fraude

4. Sips envoie une demande d’autorisation à l’Acquéreur (qui ne donne pas lieu à un paiement).

5. Sips enregistre les données du moyen de paiement dans le wallet si les contrôles fraude sont OK et l’autorisation acceptée.

6. Sips affiche la page d’accueil contenant un message de confirmation. Le client peut désormais voir son moyen de paiement sur la page d’accueil.

7. Sips vous retourne les réponses manuelle et automatique détaillant le contenu du wallet.

Paramétrer la requête

Walletpage est l’interface qui permet au client de gérer son wallet. Pour enrôler un client au service OneClick via Sips Walletpage , vous devez renseigner les champs ci-dessous.

Champ Valorisation
merchantWalletId Identifiant unique du client
PaymentMeanBrandList Liste des moyens de paiement que vous souhaitez proposer pour le paiement OneClick

Veuillez consulter le guide Sips Walletpage correspondant au connecteur choisi (POST, SOAP ou JSON) pour savoir comment renseigner la requête en fonction de votre besoin métier.

Analyser la réponse

Sips retourne une réponse manuelle et automatique. Les 2 réponses sont transmises sur 2 urls différentes. La réponse automatique est transmise systématiquement, dès lors que l’url a été renseignée dans la requête de gestion de wallet. Les informations contenues dans les réponses manuelles et automatiques sont strictement identiques.

État Champs de la réponse Action à réaliser
Client enrôlé walletPaymentMeanDataList et walletCreationDateTime renseignés Stockez dans votre base client les données suivantes du client :
  • merchantWalletId
  • paymentMeanId
  • panExpiryDate
  • maskedPAN
Client non enrôlé walletPaymentMeanDataList non renseigné
walletCreationDateTime non renseigné
Ressoumettez une requête d’enrôlement du client

Payer avec OneClick sur Sips Paypage

La phase de paiement en mode OneClick est possible si l’acheteur a préalablement enregistré son moyen de paiement dans le wallet Sips . Pendant la cinématique de paiement OneClick , le client n’a pas à ressaisir ses coordonnées de paiement, il sélectionne un des moyens de paiement préalablement enregistrés dans le wallet et renseigne le cryptogramme visuel.

Description

1. Vous redirigez le client vers Sips Paypage en communiquant dans la requête les données de la transaction (montant, devise, ..) ainsi que l’identifiant unique du client (champ merchantWalletId ).

2. Sips affiche la page de paiement, le client choisit son moyen de paiement, saisit le cryptogramme visuel, puis valide.

3. Sips procède à la vérification 3D-Secure.

4. Sips effectue les contrôles anti-fraude.

5. Sips envoie une demande d’autorisation à l’Acquéreur.

6. Sips enregistre la transaction dans le back office.

7. Sips affiche la page de ticket de paiement avec un message de confirmation de paiement.

8. Sips vous retourne les réponses manuelle et automatique contenant les détails de la transaction, y compris le résultat de l’enregistrement du client dans le wallet.

9. Sips envoie la transaction en remise en fonction des modalités que vous avez paramétrées dans la requête de paiement.

Paramétrer la requête

Pour permettre à votre client de payer en mode OneClick via Sips Paypage , vous devez renseigner le champ ci-dessous :

Champ Valorisation
merchantWalletId Identifiant unique du client
fraudData.bypass3DS

MERCHANTWALLET si souhaitez désactiver l’authentification 3DS lors d’un paiement OneClick

Non renseigné sinon

Veuillez consulter le guide Sips Paypage correspondant au connecteur choisi (JSON, POST ou SOAP) pour savoir comment renseigner la requête en fonction de votre besoin métier.

Analyser la réponse

Sips retourne une réponse manuelle et une réponse automatique classiques Sips Paypage .

Les champs relatifs à un paiement OneClick sont les suivants :

État Champs de la réponse Actions à réaliser

Transaction accepté

Le client utilise un moyen de paiement déjà enrollé dans le wallet

responseCode = 00

acquirerResponseCode = 00

paymentMeanId = numéro de séquence du moyen de paiement

merchantWalletId = idem requête

walletType = non renseigné

panEntryMode = WALLET

Validez votre commande pour expédition

Transaction acceptée

Le client choisit d'utiliser un moyen de paiement non enrollé dans le wallet

responseCode = 00

acquirerResponseCode = 00

paymentMeanId = non renseigné

merchantWalletId = idem requête

walletType = non renseigné

panEntryMode = MANUAL

Validez votre commande pour expédition

Transaction refusée

responseCode = XX

Consultez le guide Sips Paypage correspondant au connecteur choisi (JSON, POST ou SOAP) analyser la réponse de Sips .

En retour de la demande de paiement vers l’établissement financier, les codes réponses assimilés à un risque de fraude ou les codes réponses indiquant que le moyen de paiement est définitivement inutilisable déclenchent la suppression automatique du moyen de paiement du wallet. Cf. ci-dessous la liste des codes concernés (champ acquirerResponseCode ) :

Valeur Description
04 Conserver la carte
07 Conserver la carte, conditions spéciales
14 Numéro du titulaire de la carte invalide
15 Émetteur de carte inconnu
33 Carte expirée
34 Suspicion de fraude
41 Carte perdue
43 Carte volée
54 Carte expirée
57 Transaction non autorisée pour ce titulaire de carte
59 Suspicion de fraude
63 Règles de sécurité non respectées

Payer avec OneClick sur Sips Office

Une fois le moyen de paiement du client enregistré dans la base wallet, vous pouvez lui permettre de payer sans saisie des coordonnées de paiement via la méthode walletOrder .

Paiement non 3-D Secure

Description

1. Le client sélectionne sur votre site le moyen de paiement à utiliser pour payer, parmi ceux déjà enregistrés dans le wallet.

2. Vous transmettez une requête de paiement via la méthode walletOrder , en communiquant dans la requête les données de la transaction (montant, devise, ..) ainsi que l’identifiant unique du client (champs merchantWalletId et paymentMeanId ).

3. Sips récupère les coordonnées de paiement du client stockées dans le wallet et effectue le contrôle 3DS.

4. Sips effectue les contrôles anti-fraude.

5. Sips envoie une demande d’autorisation à l’Acquéreur.

6. Sips enregistre la transaction dans le back office.

7. Sips vous retourne la réponse à la demande de débit.

8. Sips envoie la transaction en remise en fonction des modalités que vous avez paramétrées dans la requête de paiement.

Paramétrer la requête

Pour soumettre un paiement OneClick avec la méthode walletOrder , vous devez renseigner les champs ci-dessous :

Champ Valeur
merchantWalletId Identifiant unique du client
paymentMeanId Identifiant du moyen de paiement

Veuillez consulter le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) pour savoir comment renseigner la requête en fonction de votre besoin métier.

Analyser la réponse

État Champs de la réponse Actions à réaliser
Transaction acceptée responseCode = 00 Validez votre commande pour expédition.
Transaction refusée responseCode = XX Demandez au client de sélectionner un autre moyen de paiement de son wallet ou d’ajouter un nouveau moyen de paiement valide à son wallet.

Créditer le client avec OneClick sur Sips Office

Vous pouvez créditer un client à partir de son identifiant sans faire référence à une transaction initiale de débit.

Note: Seules les cartes CB, Visa et Mastercard supportent cette fonctionnalité.

Description

1. Vous transmettez une requête de crédit via la méthode walletCreditHolder , en communiquant dans la requête les données de la transaction (montant, devise, ..) ainsi que l’identifiant unique du client (champ merchantWalletId et paymentMeanId .)

2. Sips récupère les coordonnées de paiement du client stockées et envoie une demande d’autorisation à l’Acquéreur.

3. Sips enregistre la transaction dans le back office.

4. Sips retourne la réponse à la demande de crédit.

5. Sips envoie la transaction en remise le soir même.

Paramétrer la requête

Pour créditer un client avec la méthode walletCreditHolder , vous renseignez les champs ci-dessous :

Champ Valeur
merchantWalletId Identifiant unique du client
paymentMeanId Identifiant du moyen de paiement

Veuillez consulter le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) pour savoir comment renseigner les autres champs de la requête en fonction de votre besoin métier.

Analyser la réponse

État Champs de la réponse Actions à réaliser
Transaction acceptée responseCode = 00

Vérifiez le lendemain dans le journal des transactions que l’envoi en paiement a bien été effectué.

(transactionStatus = CREDITED)

Transaction refusée responseCode = XX

Consultez le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) pour analyser la réponse de Sips

Gérer les moyens de paiement et le compte d’un client

Avec Sips Paypage

Description

Lors de l’achat sur l’interface Sips Paypage , le client peut interagir directement avec ses moyens de paiement sauvegardés. Les fonctionnalités suivantes sont disponibles :

  • modification du nom du moyen de paiement sauvegardé (non disponible pour les moyens de paiement expirés).
  • suppression d’un moyen de paiement sauvegardé.

Mise en œuvre

Afin que le client ait la possibilité de gérer le contenu de son wallet lors d’un acte d’achat, vous n’avez aucun développement supplémentaire à faire. Cette fonctionnalité est présentée par défaut.

Toutefois, il est possible de ne pas proposer cette fonctionnalité. Dans ce cas, vous devez contacter l’assistance technique.

Avec Sips Walletpage

Description

L’interface Sips Walletpage prévue pour la gestion du compte OneClick permet au client de gérer de manière autonome son wallet. Les fonctionnalités suivantes sont disponibles :
  • consultation du contenu d'un compte OneClick  ;
  • ajout de nouveaux moyens de paiement à un compte OneClick existant ;
  • modifier le nom d'un moyen de paiement déjà enrollé ;
  • suppression d'un moyen de paiement d'un compte OneClick  ;
  • suppression d'un compte OneClick .

Paramétrer la requête

Par défaut, l’ensemble des fonctionnalités de gestion est disponible pour l’utilisateur. Toutefois, il est possible de réduire le périmètre de ces fonctionnalités, en indiquant la liste de fonctionnalités souhaitée dans le champ walletActionNameList .

Pour la gestion de wallet, vous devez renseigner les champs ci-dessous :

Champ Valorisation
merchantWalletId Identifiant du client
walletActionList Liste des fonctionnalités proposées sur Sips Walletpage . Si non renseigné, toutes les fonctionnalités sont disponibles.

Veuillez consulter le guide Sips Walletpage correspondant au connecteur choisi (JSON, POST ou SOAP) pour savoir comment renseigner la requête en fonction de votre besoin métier.

Analyser la réponse

Etat Champs de la réponse Actions à réaliser
client supprimé walletPaymentMeanDataList non renseigné
client non supprimé walletPaymentMeanDataList renseigné

Vous pouvez mettre à jour votre système d’information avec le nouveau contenu du wallet.

Avec Sips Office et Sips Office Batch

Vue d’ensemble

Le service « Wallet » des interfaces Sips Office et Sips Office Batch vous permet de gérer le contenu des wallets de vos clients. Les fonctionnalités suivantes sont disponibles :

  • Obtention du contenu complet d’un compte OneClick  ;
  • Obtention du détail d’un moyen de paiement contenu dans un compte OneClick  ;
  • Création d’un nouveau compte OneClick  ;
  • Suppression d’un compte OneClick  ;
  • Ajout de nouveaux moyens de paiement à un compte OneClick existant ;
  • Mise à jour d'un moyen de paiement d'un compte OneClick existant ;
  • Suppression d’un moyen de paiement d’un compte OneClick .

En utilisant les interfaces Sips Office ou Sips Office Batch , vous devez gérer les pages de gestion du wallet pour permettre à vos clients de gérer leur compte OneClick .

Consulter le contenu d’un compte OneClick avec Sips Office

Sips Office vous permet de consulter les coordonnées d’un client via la requête getWalletData .

  • Paramétrer la requête
    Pour consulter le contenu d’un wallet avec la méthode getWalletData , vous devez renseigner les champs ci-dessous :
    Champ Valorisation
    merchantWalletID Identifiant du client

    Veuillez consulter le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) pour savoir comment renseigner les autres champs de la requête en fonction de votre besoin métier.

  • Analyser la réponse
    Etat Champs de la réponse Action à réaliser
    client trouvé dans la base wallet

    walletReponseCode = 00

    walletPaymentMeanDataList renseigné avec les moyens de paiement enregistrés dans le wallet
    Le client existe dans le wallet.
    Analysez le champ walletPaymentMeanDataList pour accéder aux données du moyen de paiement du client.
    • paymentMeanBrand
    • paymentMeanId
    • maskedPAN
    • PANExpiryDate
    client non trouvé dans la base wallet

    walletReponseCode = 25

    Le compte a été supprimé ou n’a pas été créé.
    Autre refus

    walletReponseCode = xx

    Consultez le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) pour analyser la réponse de Sips .

Modifier un moyen de paiement d’un compte OneClick avec Sips Office

Sips Office vous permet de modifier l’alias d’un moyen de paiement d’un client via la requête updatePaymentMean .

  • Paramétrer la requête
    Pour modifier un moyen de paiement avec la méthode updatePaymentMean , vous devez renseigner les champs ci-dessous :
    Champ Valorisation
    merchantWalletID Identifiant du client
    paymentMeanId Numéro de séquence du moyen de paiement
    paymentMeanAlias Nouvel alias du moyen de paiement

Veuillez consulter le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) pour savoir comment renseigner les autres champs de la requête en fonction de votre besoin métier.

  • Analyser la réponse
Etat Champs de la réponse Action à réaliser
Alias modifié

walletReponseCode = 00

walletActionDateTime renseigné

Client non trouvé dans base wallet

walletReponseCode = 25

Le compte client n’existe pas.
Autre refus

walletReponseCode = xx

Consultez le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) pour analyser la réponse de Sips .

Supprimer un moyen de paiement d’un compte OneClick avec Sips Office

Sips Office vous permet de supprimer un moyen de paiement d’un client via la requête deletePaymentMean .

  • Paramétrer la requête

Pour modifier un moyen de paiement avec la méthode deletePaymentMean , vous devez renseigner les champs ci-dessous :

Champ Valorisation
merchantWalletID Identifiant du client
paymentMeanId Numéro de séquence du moyen de paiement

Veuillez consulter le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) pour savoir comment renseigner les autres champs de la requête en fonction de votre besoin métier.

  • Analyser la réponse
Etat Champs de la réponse Action à réaliser
Moyen de paiement supprimé

walletReponseCode = 00

walletActionDateTime renseigné

Client / moyen de paiement non trouvé dans base wallet

walletReponseCode = 25

Autre refus

walletReponseCode = xx

Consultez le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) pour analyser la réponse de Sips .

Supprimer un client avec Sips Office

Sips Office vous permet de supprimer un client via la requête signOff .

  • Paramétrer la requête

Pour supprimer un wallet avec la méthode signOff , vous devez renseigner les champs ci-dessous :

Champ Valorisation
merchantWalletID Identifiant du client

Veuillez consulter le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) pour savoir comment renseigner les autres champs de la requête en fonction de votre besoin métier.

  • Analyser la réponse
Etat Champs de la réponse Action à réaliser
client supprimé walletReponseCode = 00 Vous pouvez mettre à jour votre système d’information
client non supprimé walletReponseCode = xx Consultez le guide Sips Office correspondant au connecteur choisi (JSON ou SOAP) pour analyser la réponse de Sips .

Avec Sips Office Extranet

Via Sips Office Extranet , vous avez la possibilité de supprimer un moyen de paiement pour le compte de votre client . Cette fonctionnalité est protégée par un droit d’accès qui vous est attribué lors de votre inscription. Si vous avez besoin de cette fonctionnalité, mais que vous n’avez pas le droit d’accès, veuillez contacter l’assistance technique.

Traiter l’expiration des moyens de paiement des clients

Vous recevez mensuellement par mail ou fichier SFTP le journal des cartes échues . Ce journal référence les clients dont le moyen de paiement va expirer dans un délai 3 mois.

A partir du journal des cartes échues , vous pouvez alerter vos clients pour qu'ils renouvellent leur moyen de paiement enregistré dans le wallet.

A noter que vous n’avez pas besoin de ce fichier pour connaître la date d’expiration du moyen de paiement des clients. En effet, lors de l’enrôlement du client , vous recevez en réponse des informations que vous pouvez stocker dans votre système d’information :

  • Identifiant du moyen de paiement dans le wallet (champ paymentMeanId )
  • Marque du moyen de paiement (champ paymentMeanBrand )
  • Date d'expiration (champ panExpiryDate )
  • PAN masqué (champ maskedPAN )

Pour avoir le contenu détaillé du journal des cartes échues , veuillez consulter le document Description des journaux.

Démarrer OneClick en 5 étapes

Étape 1 - Souscrire au service

Votre boutique n’est pas inscrite sur Sips

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

Votre boutique est déjà inscrite sur Sips

Si votre boutique est déjà inscrite sur Sips , vous devez demander à Worldline d’activer le service OneClick .

Données de configuration du service OneClick

Afin de bénéficier du service OneClick , vous devez contacter l’assistance technique et fournir les informations suivantes :

  • Souhaitez-vous recevoir le jounral des cartes échues ;
  • Dans le cas d’une base clients partagée entre plusieurs boutiques d’une même enseigne, indiquer l’identifiant de l’enseigne.
Note: Si votre base client est partagée entre plusieurs boutiques, vous devez l’indiquer dans le formulaire d’inscription ou le dire à l’assistance technique.

Si ce n’est pas précisé, Sips définit une base wallet dédiée à votre boutique.

Étape 2 - Mettre en œuvre le service

Lorsque vous avez choisi les interfaces Sips qui répondent à votre besoin (voir la partie choix des connecteurs ), vous devez intégrer les connecteurs Sips pour connecter votre site à Sips et suivre les indications de la partie mise en oeuvre .

Étape 3 - Tester le service sur l’environnement recette

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

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-atos.com/paymentInit
Paypage JSON https://payment-webinit.test.sips-atos.com/rs-services/v2/paymentInit
Paypage SOAP https://payment-webinit.test.sips-atos.com/services/v2/paymentInit
WalletPage POST https://payment-webinit.test.sips-atos.com/walletManagementInit
WalletPage JSON
WalletPage SOAP https://payment-webinit.test.sips-atos.com/services/v2/walletManagementInit
Note:

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 transactionRefence valorisé dans vos requêtes de test.

Etape 4 - Valider le service en production

Vous êtes à présent en mesure de valider la connexion à Sips de production.

Au préalable, nous conseillons d’isoler votre site Web du public pour éviter que des clients effectuent des transactions pendant cette phase de validation.

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

URL Sips URL du serveur de paiement Sips récupéré par 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é)
Note: 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 ou vos pages de gestion du wallet, veuillez suivre la procédure décrite dans le document Custompages .

Comment valider l’enrôlement du client

Immédiatement

  • Soumettez une requête d’enrôlement selon le scénario d’enrôlement que vous avez choisi ( Sips Paypage , Sips Office , ou Sips Walletpage ).

Comment valider le débit du client

Immédiatement

  • Soumettez une requête de débit selon de scénario de débit que vous avez choisi ( Sips , Sips Paypage ou Sips Office ),
  • Consultez la transaction via Sips Office Extranet à partir du transactionReference ou du S10TransactionId .

Le lendemain

  • Vérifiez la présence de la transaction dans le journal des transactions,
  • Vérifiez sur votre compte commerçant que l’opération a bien été créditée,
  • Vous pouvez, si vous le souhaitez, rembourser la transaction via Sips Office Extranet .

Le surlendemain

  • Vérifiez que l’opération de remboursement apparaît dans le journal des opérations,
  • Vérifiez sur votre compte commerçant le débit, suite au remboursement.

Comment valider la gestion du wallet du client

Immédiatement

  • Soumettez une ou plusieurs requêtes de gestion de wallet selon de scénario de débit que vous avez choisi ( Sips Paypage , Sips Walletpage , Sips Office ou Sips Office Extranet ).

Etape 5 - Démarrer le service en production

Une fois la validation du passage en production effectuée, ouvrez votre site au public pour permettre à vos clients d'utiliser le service OneClick et de s’enregistrer.

L’enrôlement des clients

Dans la journée

  • Surveillez le taux d’acceptation (nombre de responseCode 00 par rapport au nombre total de transactions),
  • Vérifiez la nature des refus non bancaires,
    • Problème technique : responseCode 90, 97, 99,
    • Fraude : responseCode 34, 3D Failure,
    • Nombre max de tentatives de paiement atteint : responseCode 75.

Le lendemain

  • Vérifiez dans le journal des transactions la présence de toutes les transactions traitées (acceptées et refusées),
  • Vérifiez, dans le journal des opérations, la présence des opérations que vous avez effectuées ainsi que les remises (si vous avez choisi cette option du journal).

Le débit des clients

Lorsque vous soumettez vos premiers débits clients via Sips Paypage ou Sips Office :

  • Surveillez le taux d’acceptation (nombre de responseCode 00 par rapport au nombre total de transactions),
  • Vérifiez la nature des refus non bancaires,
    • Problème technique : responseCode 90, 97, 99,
    • Fraude acquéreur : responseCode 34.