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 carte cadeau Oney dans Worldline Sips.
À qui s’adresse ce document ?
Ce document a pour objectif de vous aider à implémenter le moyen de paiement carte cadeau 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 Worldline Sips, nous vous conseillons de consulter les documents suivants :
- Présentation fonctionnelle
- Guide de configuration des fonctionnalités
Comprendre les paiements carte cadeau Oney avec Worldline Sips
Principes généraux
Oney Bank est un organisme financier français spécialisé dans les solutions de paiement et le crédit à la consommation.
La carte cadeau Oney est une carte prépayée qui permet au client de payer tout ou une partie du montant de son panier. Lors du paiement, le solde de sa carte prépayée est directement déduit.
En cas de paiement partiel avec la carte cadeau Oney, la gestion du paiement du complément reste à votre charge. Merci de vous adresser à votre contact Oney afin de connaître la solution à mettre en œuvre.
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 | X | |
| Paiement en plusieurs fois | X | |
| Paiement par abonnement | X | |
| Paiement par fichier | X | |
| Paiement OneClick | X | |
| Gestion des devises | ||
|---|---|---|
| Acceptation multidevise | X | |
| Règlement en devise | X | |
Pages de paiement
Le client sélectionne le moyen de paiement carte cadeau Oney.
Il est ensuite redirigé vers la page de la saisie des informations requises avec ou sans choix de montant.
Vous pouvez permettre ou non à votre client de choisir le montant qu'il souhaite régler avec sa carte cadeau (Merci de vous référer au paragraphe Paramétrer la requête de paiement).
Le ticket de paiement s’affiche, puis le client retourne sur votre site Web :
Ouvrir votre contrat d’acceptation carte cadeau Oney
Afin de proposer le moyen de paiement Carte Cadeau Oney sur votre site Web, vous devez souscrire un contrat OFFUS 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 n’accepterez que les cartes privatives (cartes exclusivement Oney, cartes enseigne et Carte Cadeau Oney).
Effectuer un paiement carte cadeau Oney
Worldline Sips vous offre deux solutions pour intégrer le moyen de paiement carte cadeau 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.
Le seul mode de remise disponible pour une transaction carte cadeau Oney est le mode immédiat (la remise de la transaction est réalisée au moment de l’acceptation du paiement en ligne).
Le diagramme ci-dessous explique les différents états par lesquels peuvent passer les transactions selon le mode de capture choisi :
Effectuer un paiement carte cadeau Oney 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 |
|---|---|
| captureMode | La valeur envoyée dans la requête est ignorée. Le mode
de capture est forcé à IMMEDIATE. |
| captureDay | La valeur envoyée dans la requête est ignorée. Le délai
de capture est forcé à 0. |
| currencyCode | Obligatoire : Euro uniquement (978) |
| paymentPattern | La valeur envoyée dans la requête est ignorée. Le type
de paiement est forcé à ONE_SHOT. |
| paypageData.bypassReceiptPage | Y ou N Non obligatoire, la valorisation de ce champ à Y permet de ne pas afficher le ticket de confirmation de paiement Oney. |
| templateName | Non obligatoire, permet de piloter le modèle de personnalisation des pages Oney (cf. guide de personnalisation Oney) |
| paymentMeanData.accordkdo.blockAmountModification | Y ou N Non obligatoire, la valorisation de ce champ à Y permet de désactiver la modification du montant et l’affichage du champ de modification sur la page d’entrée des informations de carte. |
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 = 00
acquirerResponseIdentifier =
Identifiant d'OneyacquirerResponseMessage =
ticket d'OneyauthorisationId = (voir le
Dictionnaire des données).paymentMeanData.acccordkdo.additionalAuthorisationNumber
= numéro d'autorisation supplémentaire
d'Oney.paymentMeanBrand =
ACCORD_KDOpaymentMeanType =
CARDpaymentMeanTradingName = nom
de la carte avec mention de l’enseigne.responseCode =
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 carte cadeau Oney avec Sips Office
Le processus de paiement pour Sips Office est décrit ci-dessous :
Paramétrer la requête de paiement
Il est possible de créer un paiement carte cadeau Oney en utilisant la fonction CardOrder du service CheckOut.
| Nom du champ | Remarques / règles |
|---|---|
| captureDay | Obligatoire (0) |
| captureMode | La valeur envoyée dans la requête est ignorée. Le mode
de capture est forcé à IMMEDIATE. |
| cardExpiryDate | Obligatoire (format : AAAAMM) |
| cardNumber | Obligatoire |
| currencyCode | Obligatoire : Euro uniquement (978) |
| orderChannel | Obligatoire (INTERNET) |
| paymentMeanBrand | Doit être valorisé avec ACCORD_KDO. |
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 = 00
acquirerResponseIdentifier =
Identifiant d'OneyacquirerResponseMessage =
ticket d'OneyauthorisationId = (voir le
Dictionnaire des données).cardScheme =
ACCORDpaymentMeanData.acccordkdo.additionnalAuthorisationNumber
= numéro d’autorisation additionnel.paymentMeanBrand =
ACCORD_KDOpaymentMeanTradingName = nom
de la carte avec mention de l’enseigne.responseCode =
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, 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.
Gérer vos transactions carte cadeau Oney
Opérations de caisse disponibles
Les opérations suivantes sont disponibles sur les transactions carte cadeau Oney :
| Gestion de caisse | ||
|---|---|---|
| Annulation | X | |
| Validation | X | |
| Remboursement | V | |
| Duplication | 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é :
Consulter vos transactions carte cadeau Oney
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 carte cadeau 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 |
Sips Office Extranet
Vous pouvez consulter vos transactions carte cadeau Oney et effectuer différentes opérations de gestion de caisse grâce à Sips Office Extranet.
Voici le détail d'une transaction carte cadeau Oney :
