WL SIPS DOCS

Release 22.3

aller directement au contenu

Rechercher par mots clés

Intégration Samsung 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 Samsung Pay dans WL Sips.

Ce document a pour objectif de vous aider à implémenter le moyen de paiement Samsung 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

Samsung Pay est un moyen de paiement proposé par la société Samsung pour effectuer des paiements de manière simple et sécurisée sur smartphone ou montre Samsung compatible.

Le porteur de carte aura préalablement ajouté sa carte physique au wallet disponible sur les différents appareils du constructeur Samsung. Par la suite, il peut régler ses achats sur un site Web ou sur une application mobile.

Grâce à cette solution, les clients paient leurs achats en ligne sans devoir saisir les coordonnées de leurs cartes à chaque fois. De plus, l’application wallet leur permet de consulter l’historique de leurs transactions.

Canaux de paiement
Internet V Canal de paiement par défaut
MOTO X
Télécopie X
SVI X
Sips In-App X
Typologies de paiement
Paiement immédiat X
Paiement en fin de journée V Méthode par défaut
Paiement différé V Limité à 6 jours.
Paiement à l'expédition V Limité à 6 jours.
Paiement en plusieurs fois X
Paiement par abonnement X
Paiement par fichier X
Paiement OneClick X
Gestion des devises
Acceptation multidevise V
Règlement en devise X
Conversion dynamique en devise X

Voici les règles appliquées au paiement Samsung Pay :

Caractéristique Restriction Restriction
Moyen de paiement
MASTERCARD
MAESTRO
VISA
VPAY
ELECTRON
WL Sips
Navigateur / Appareil Appareil Samsung Samsung
IFrames Non Samsung

Vous devez vous assurer que vos acquéreurs supportent le flux Samsung Pay.

Tous les contrôles anti-fraude sont pris en charge dans le cadre des paiements Samsung Pay (outil fraude).

Samsung impose une charte graphique pour le logo à utiliser sur vos pages de paiement. Les informations liées à cette charte sont disponibles ici : https://pay.samsung.com/developers/resource/brand

Attention: le CVV n’est pas valorisé dans la cinématique Samsung Pay.

Durant la cinématique de paiement, l’authentification du porteur de carte est réalisée par Samsung Pay.

Deux cas se présentent à vous :

  • vous souhaitez vous-même gérer l’authentification du porteur.
    À cette fin, vous devez ouvrir un compte auprès de Samsung Pay et réaliser l’implémentation pour gérer l’authentification Samsung Pay. Le détail concernant l’implémentation de l’authentification auprès de Samsung Pay est référencé ici : https://pay.samsung.com/developers
    Vous êtes amené à utiliser l’interface Sips Office;
  • vous souhaitez déléguer toute la cinématique transactionnelle à la plateforme WL Sips et notamment l’authentification du porteur auprès du serveur Samsung Pay.
    Dans ce cas, vous êtes amené à utiliser l’interface Sips Paypage.

Le délai de capture maximum autorisé pour un paiement Samsung Pay est de 6 jours.

Si vous renseignez un délai de capture supérieur, il sera automatiquement forcé par la plateforme de paiement.

Les paiements sont remis en banque conformément aux modalités de paiement définies par vous-même. En standard, la remise en banque est déclenchée la nuit à partir de 22h00, fuseau horaire CET (heure d’Europe Centrale), via un échange de fichier avec l’acquéreur.

Afin de proposer le moyen de paiement Samsung Pay sur votre site Web, deux cas se présentent à vous :

  • vous souhaitez vous-même gérer l’authentification du porteur et utiliser la plateforme WL Sips pour réaliser la demande d’autorisation et la remise en banque. Vous devez contacter Samsung Pay ;
  • vous souhaitez déléguer toute la cinématique transactionnelle à la plateforme WL Sips à savoir la partie d’authentification du porteur auprès du serveur Samsung Pay, la demande d’autorisation et la remise en banque.
    Dans ce cas, vous n’avez aucune interaction avec Samsung Pay. WL Sips est en charge de votre enrôlement /activation auprès de Samsung Pay.

Pour activer l’acceptation Samsung Pay, vous devez être muni d’un contrat d’acquisition de type carte bancaire chez un acquéreur acceptant un paiement Samsung Pay. En effet, le moyen de paiement est associé à la marque de la carte physique du porteur (VISA, MASTERCARD, etc..) et donc vous devez posséder un contrat d’acquisition pour cette même marque.

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

  • Mode annulation : mode par défaut, il permet de remiser la transaction à une date prédéfinie, appelée délai de capture. Lorsque ce délai de capture est atteint, la remise est automatiquement envoyée. Ce délai est paramétré via le champ captureDay, sa valeur par défaut est 0 (paiement en fin de journée).
  • 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.

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


Description des status possibles pour une transaction Samsung Pay

En mode validation (captureMode = VALIDATION), si la transaction est acceptée, la transaction passe en status TO_VALIDATE. En mode annulation (captureMode = AUTHOR_CAPTURE), si la transaction est acceptée, la transaction passe en statut TO_CAPTURE. Quel que soit le mode de capture, si la transaction est refusée, elle passe en statut REFUSED. Et si la transaction est abandonnée, elle passe en statut ABORTED.

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


Étapes d'un paiement Samsung Pay via Paypage

1) Le client procède au paiement. 2) Il est redirigé vers la page WL Sips où il choisit le moyen de paiement Samsung Pay. 3) Il est ensuite redirigé vers une page d'identification Samsung Pay. 4) Le serveur Samsung Pay traite le chiffrement des données sensibles. 5) Il reçoit les informations sur son appareil mobile et il s'authentifie. 6) Les données chiffrées sont transférées et le client est redirigé vers la page WL Sips. 7) S'il clique sur le bouton de retour à la boutique, il est redirigé vers votre site Web ce qui délenche l'envoi de la réponse manuelle. 8) WL Sips envoie une réponse automatique.

Le champ suivant a un comportement particulier :

Nom du champ Remarques / règles
captureDay La valeur envoyée dans la requête doit être de 6 au maximum.
Une valeur supérieure sera forcée à 6.

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).
paymentMeanBrand = carte utilisée dans le wallet (VISA, MASTERCARD, CB ou autre).
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 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.

Le processus de paiement pour Sips Office est décrit ci-dessous :


Étapes d'un paiement Samsung Pay via Office

1) Le client procède au paiement directement sur votre site Web et choisit Samsung Pay. 2) Une identification du porteur de wallet est initiée. 3) Le serveur Samsung Pay traite le chiffrement des données sensibles. 4) Il reçoit les informations sur son appareil mobile et il s'authentifie. 5) Après le transfert des données chiffrées, une demande d'autorisation (checkout.cardOrder) est envoyée au moteur WL Sips. 6) Vous affichez le résultat du paiement à votre client.

Pour effectuer un paiement avec Sips Office, vous devez utiliser la méthode cardOrder.

La requête de paiement Samsung Pay comprend tous les champs obligatoires du connecteur que vous utilisez.

Les champs suivants ont un comportement particulier :

Nom du champ Remarques / règles
panEntryMode OEMPAY
paymentMeanDataProvider SAMSUNGPAY
authenticationResult.samsungPay.cavv Cryptogramme fourni par Samsung Pay.
authenticationResult.samsungPay.eci ECI indicateur fourni par Samsung Pay.
paymentMeanBrand Doit être valorisé avec la marque de la carte (CB, Visa, Mastercard, …).
cardNumber Fournir le DPAN (= numéro de carte Samsung Pay).
cardExpiryDate Fournir la date d’expiration du DPAN.
orderChannel INTERNET
holderAuthentProgram SAMSUNGPAY
walletType Ne doit pas être renseigné.

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).
paymentMeanBrand = carte utilisée dans le wallet (VISA, MASTERCARD, CB ou autre).
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, vous pouvez proposer à votre client de payer avec un autre moyen de paiement en générant une nouvelle requête.
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.

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

Gestion de caisse
Annulation V Annulation possible sur le montant partiel de la transaction.
Validation V Validation possible sur le montant partiel de la transaction.
Remboursement V Remboursement possible sur le montant partiel de la transaction et sur les montants supérieurs au montant initial (remboursement illimité).
Duplication X
Recyclage 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é :


Schéma trop complexe à décrire, merci de contacter le support sips@worldline.com

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 Samsung Pay pour chaque type de journal est récapitulée 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 V
Note: pour les transactions Samsung Pay, le champ paymentMeanBrand est renseigné avec la marque de la carte (Visa, Mastercard, …).

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

Voici le détail d'une transaction Samsung Pay effectuée avec une carte enrôlée pour les paiements de type OEM :


Capture des détails d'une transaction

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