WL SIPS DOCS

Release 22.3

aller directement au contenu

Rechercher par mots clés

Intégration Carte Oney

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 carte Oney dans WL Sips.

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

Oney Bank est un organisme financier français spécialisé dans les solutions de paiement et le crédit à la consommation.

Les cartes Oney permettent de réaliser des paiements comptants ou à crédit.

Pour payer avec une carte Oney, le titulaire de carte doit fournir les renseignements détaillés sur sa carte, à savoir :

  • Le numéro de carte ;
  • La date d’expiration ;
  • L'option de financement de son choix.
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
Paiement en fin de journée V Méthode par défaut
Paiement différé V
Paiement à l'expédition V
Paiement en plusieurs fois X
Paiement par abonnement X
Paiement par fichier V
Paiement OneClick V
Gestion des devises
Acceptation multidevise X EUR uniquement
Règlement en devise X EUR uniquement

La fonctionnalité OneClick est disponible sur les pages de paiement carte Oney :



Page permettant de saisir son numéro de carte, sa date d'expiration et l'option de financement à choisir parmi 3 choix: 1. Comptant, 2. Crédit renouvelable ou 3. Report 3 mois à 10 mois au taux de 14,90%, et de préciser si la carte doit être enregistrée pour un futur achat.

Par défaut, l’option est présélectionnée à « non ».

Si le client souhaite enregistrer sa carte pour un futur paiement, il sélectionne l’option « oui » et peut s’il le souhaite choisir un nom pour cette carte :


Image de saisie du nom d'une carte si le client souhaite l'enregistrer

Lors des futurs paiements avec les cartes pré-enregistrées dans le wallet, le client ne ressaisit pas les informations de sa carte. Il choisit néanmoins son option de financement.

Le client sélectionne le moyen de paiement carte Oney.

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


Page de la saisie des informations requises

Après avoir fourni les informations requises, le client peut choisir son option de financement. En fonction de ce choix, une simulation s'affiche. Une fois, les informations saisies, il valide :



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


Le ticket de paiement

Afin d'utiliser le moyen de paiement Carte Oney sur votre site Web, vous devez souscrire un contrat ONUS auprès d'Oney. Vous nous transmettez par la suite le numéro de contrat afin de l’enregistrer dans notre système d’information. Avec ce contrat, vous accepterez deux types de cartes différents :

  • cartes privatives (cartes exclusivement Oney, cartes enseigne et carte cadeau Oney),
  • cartes bancaires (cartes cobadgées CB, Visa, Mastercard).

WL Sips vous offre trois solutions pour intégrer le moyen de paiement carte Oney :

  • Sips Paypage qui assure l’interface de paiement directement avec le client via son navigateur Web.
  • Sips Office qui vous laisse la possibilité d’afficher vous-même vos pages de paiement et qui fonctionne par un dialogue de serveur à serveur.
  • Sips Office Batch qui vous permet de traiter des paiements par échange de fichiers.

Les modes de remise disponibles pour une transaction carte Oney 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.
  • 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 :


diagramme montrant les différents états d'une transaction

Si le commerçant choisit le mode validation, la transaction passera soit à l'état To validate si elle a été acceptée (response code 00), soit à l'état refused si elle a été refusée (response code différent de 00). Si le commerçant choisit le mode annulation, la transaction passera soit à l'état To capture si elle a été acceptée (response code 00), soit à l'état refused si elle a été refusée (response code différent de 00). Si le commerçant choisit le mode immédiat, la transaction passera soit à l'état Captured si elle a été acceptée (response code 00), soit à l'état refused si elle a été refusée (response code différent de 00).

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


diagramme montrant la cinématique de paiement via paypage

Après avoir finalisé sa commande sur le site web commerçant, le client procède au paiement. Pour ce faire, il est redirigé vers les pages de paiement hébergées côté WL Sips. Le client sélectionne le moyen de paiement Oney puis saisit son numéro de carte et son option de financement. Le ticket avec le résultat du paiement s'affiche. Deux réponses sont envoyées; une réponse manuelle qui redirige le client vers le site web commerçant et une réponse automatique envoyée vers le site web commerçant par le serveur Sips.

Les champs suivants ont un comportement particulier :

Nom du champ Remarques / règles
paymentPattern La valeur envoyée dans la requête est ignorée.
Le type de paiement est forcé à ONE_SHOT.
paymentMeanData.accord.​settlementMode

Non obligatoire, la méthode de règlement peut être forcée dans la requête.

Se rapprocher d’Oney pour obtenir la liste exhaustive de ces modalités de paiement.

paypageData.bypassReceiptPage

Y ou N

Non obligatoire, la valorisation de ce champ à Y permet de ne pas afficher le ticket de confirmation de paiement carte Oney.

templateName Non obligatoire, permet de piloter le modèle de personnalisation des pages Oney (voir guide de personnalisation Oney).
orderId Obligatoire : longueur maximale autorisée par Oney de 9 caractères.
customerId Longueur maximale autorisée par Oney de 8 caractères.
customerLanguage Permet de choisir la langue utilisée sur les pages WL Sips et Oney.

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
acquirerResponseIdentifier = Identifiant d'Oney
acquirerResponseMessage = ticket d'Oney
authorisationId = (voir le Dictionnaire des données).
paymentMeanData.accord.​additionalAuthorisationNumber = numéro d’autorisation additionnel.
paymentMeanTradingName = nom de la carte avec mention de l’enseigne.
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.

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


diagramme montrant la cinématique de paiement via office

Le client procède à la finalisation et au paiement de sa commande directement sur le site web commerçant. Le commerçant collecte les coordonnées de paiement et transmet la requête de paiement vers WL Sips via un cardOrder. Le commerçant affiche le résultat du paiement au client via son site web.

Il est possible de créer un paiement carte Oney en utilisant la méthode CardOrder du service CheckOut.

Nom du champ Remarques / règles
cardExpiryDate Obligatoire (format : AAAAMM)
cardNumber Obligatoire
currencyCode Obligatoire : Euro uniquement (978)
orderChannel Obligatoire (INTERNET)
paymentPattern La valeur envoyée dans la requête est ignorée.
Le type de paiement est forcé à ONE_SHOT.
paymentMeanBrand Doit être valorisé avec ACCORD.
paymentMeanData.accord.settlementMode

Obligatoire

Se rapprocher d'Oney pour obtenir la liste exhaustive de ces modalités de paiement.

orderId

Obligatoire

Longueur maximale autorisée par Oney de 9 caractères

customerId Longueur maximale autorisée par Oney de 8 caractères.
customerLanguage Permet de choisir la langue utilisée sur les pages WL Sips et carte Oney.
holderData.birthDate Obligatoire pour le walletOrder format : AAAAMMJJ

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
acquirerResponseIdentifier = Identifiant d'Oney
acquirerResponseMessage = ticket d'Oney
authorisationId = (voir le Dictionnaire des données).
cardScheme = ACCORD
paymentMeanData.accord.​additionalAuthorisationNumber = numéro d’autorisation additionnel.
paymentMeanTradingName = nom de la carte avec mention de l’enseigne.
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 carte Oney :

Gestion de caisse
Annulation V Annulation partielle autorisée seulement pour les méthodes de règlement « comptant » et « crédit renouvelable ».
Validation V Validation partielle autorisée seulement pour les méthodes de règlement « comptant » et « crédit renouvelable ».
Remboursement V Remboursement partiel autorisé seulement pour les méthodes de règlement « comptant » et « crédit renouvelable ».
Duplication V L’option de paiement de la transaction d’origine sera utilisée.
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é :


image trop complexe pour être décrite, merci de prendre contact avec le support WL Sips

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 carte Oney 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 X
Note: pour les transactions carte Oney, le champ paymentMeanBrand est renseigné avec la valeur ACCORD.

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



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