Introduction

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

Attention: FacilyPay est déprécié, merci de vous référer au guide du nouveau moyen de paiement Oney 3X 4X.

À qui s’adresse ce document ?

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

Comprendre les paiements FacilyPay avec WL 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.

Oney propose une solution de crédit en ligne avec un paiement en 3 ou 4 fois par carte bancaire nommée FacilyPay.

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 X Forcé vers un paiement à la fin de la journée.
Paiement en fin de journée V Méthode par défaut
Paiement différé V
Paiement à l'expédition V Forcé à 30 jours maximum.
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

Caractéristiques du moyen de paiement FacilyPay

  • Pour distinguer les 2 facilités de paiements, vous utiliserez l’un des deux moyens de paiement ci-dessous :
    • ACCORD_3X pour le paiement FacilyPay en 3 fois ;
    • ACCORD_4X pour le paiement FacilyPay en 4 fois.
  • Pour chacune des offres, des seuils spécifiques (montants minimum et maximum) sont paramétrés chez Oney.
    Si vous n'en avez pas connaissance, vous devez vous rapprocher d’Oney pour les connaître.
  • Le moyen de paiement Facilipay n'est disponible que pour les résidents de France métropolitaine possédant une carte bancaire Visa et Mastercard française.
  • La devise doit être l'Euro (=978).
  • L'annulation (partielle ou totale) n'est possible qu'au-delà des 48 heures suivant le paiement en ligne.
  • Les cartes à autorisation systématique de type Electron ou Maestro, les cartes électroniques, les cartes Indigo et American Express ne sont pas acceptées.
  • Le paiement en mode IMMEDIATE n'est pas accepté.
  • Le paiement par abonnement n’est pas possible.
  • Le formulaire de saisie des données bancaires est chez Oney.
  • La demande d'autorisation est effectuée par Oney.
  • Le protocole 3-D Secure ne fait pas partie du périmètre d’acceptation WL Sips . Les interfaces d'enrôlement étant traitées par Oney, le déclenchement du 3-D Secure est piloté par le formulaire Oney en fonction de la politique risque et fraude interne d'Oney.
  • Le ticket de caisse est géré et affiché par Oney.

Les contrôles effectués par le serveur de paiement sont :

  • Le champ orderId qui doit être obligatoirement renseigné et ne doit pas dépasser 9 caractères. Il correspond à la référence de la commande chez Oney. Vous devrez garantir l’unicité de ce champ.
  • Les champs customerEmail et customerId qui doivent être obligatoirement renseignés. Le champ customerId ne doit pas dépasser 8 caractères.

Livraison du panier

La réponse retournée lors du paiement en ligne n’est pas définitive, ce n’est qu'une réponse de principe. Oney doit de son côté valider définitivement l’ouverture du crédit en ligne. La réponse définitive est connue lors de l’opération de remise (passage au statut CAPTURED). Afin de connaître le résultat définitif du paiement, vous devez consulter les opérations de remise détaillées quotidiennement dans le journal des opérations.

Par conséquent, vous devez attendre que la transaction passe à l’état CAPTURED pour livrer le colis à vos clients.

Pages de paiement

Le client sélectionne le moyen de paiement FacilyPay.

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

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

Ouvrir votre contrat d’acceptation FacilyPay

Afin de proposer le moyen de paiement FacilyPay sur votre site Web, vous devez souscrire un contrat d’acceptation 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.

Effectuer un paiement FacilyPay

Vous pouvez proposer le moyen de paiement Facilipay au travers de Sips Paypage qui assure l’interface de paiement directement avec le client via son navigateur Web.

Les modes de remise disponibles pour une transaction FacilyPay 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 :

Effectuer un paiement FacilyPay 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.
orderId Obligatoire : maximum 9 caractères.
customerId Obligatoire : maximum 8 caractères.
customerContact.email Obligatoire
paymentMeanData.facilypay.settlementMode Obligatoire : Code de l’opération commerciale ; Se rapprocher d’Oney pour obtenir la liste exhaustive de ces modalités de paiement.
paymentMeanData.facilypay.settlementModeVersion Obligatoire : Version du code de l’opération commerciale.
paymentMeanData.facilypay.​receiverType Obligatoire : 1 pour entreprise ou 2 pour personne (Seul le "2" est éligible car ce moyen de paiement est mis à disposition des particuliers uniquement).
billingContact Pour plus de détails, voir les tableaux ci-dessous.
billingAddress Pour plus de détails, voir les tableaux ci-dessous.
deliveryData Pour plus de détails, voir les tableaux ci-dessous.
deliveryContact Pour plus de détails, voir les tableaux ci-dessous.
deliveryAddress Pour plus de détails, voir les tableaux ci-dessous.
shoppingCartDetail Pour plus de détails, voir les tableaux ci-dessous.

Il est important d’avoir une cohérence entre les champs settlementMode et paymentMeanBrandList .

Si vous choisissez un mode de règlement de type paiement 3 fois dans le champ settlementMode , il faut également indiquer dans le champ paymentMeanBrandList le moyen de paiement ACCORD_3X (et pas ACCORD_4X).

Si vous choisissez un mode de règlement de type paiement 4 fois dans le champ settlementMode , il faut également indiquer dans le champ paymentMeanBrandList le moyen de paiement ACCORD_4X (et pas ACCORD_3X).

billingContact

Nom du champ Remarques / règles
billingContact.title Obligatoire
billingContact.lastname Obligatoire
billingContact.firstname Facultatif
billingContact.phone Facultatif
billingContact.mobile Facultatif

billingAddress

Nom du champ Remarques / règles
billingAddress.streetNumber Obligatoire
billingAddress.street Obligatoire
billingAddress.zipCode Obligatoire
billingAddress.city Obligatoire
billingAddress.country Obligatoire (ISO 3166-1 alpha-3)
billingAddress.addressAdditional1 Facultatif
billingAddress.addressAdditional2 Facultatif
billingAddress.addressAdditional3 Facultatif
billingAddress.company Facultatif

deliveryData

Nom du champ Remarques / règles
deliveryData.estimatedDeliveryDate Obligatoire
deliveryData.deliveryMode Obligatoire 1, 2, 3, 4 or 5
deliveryData.deliveryMethod Obligatoire 1 : Express (moins de 24h) ou 2 : Standard
deliveryData.deliveryOperator Obligatoire

deliveryContact

Nom du champ Remarques / règles
deliveryContact.title Obligatoire
deliveryContact.lastname Obligatoire
deliveryContact.firstname Obligatoire
deliveryContact.phone Obligatoire
deliveryContact.mobile Obligatoire
deliveryContact.email Obligatoire

deliveryAddress

Nom du champ Remarques / règles
deliveryAddress.streetNumber Obligatoire
deliveryAddress.street Obligatoire
deliveryAddress.zipCode Obligatoire
deliveryAddress.city Obligatoire
deliveryAddress.country Obligatoire (ISO 3166-1 alpha-3)
eliveryAddress.addressAdditional1 Facultatif
deliveryAddress.addressAdditional2 Facultatif
deliveryAddress.addressAdditional3 Facultatif
deliveryAddress.company Facultatif

shoppingCartDetail

Nom du champ Remarques / règles
shoppingCartDetail.shoppingCartTotalQuantity Obligatoire
shoppingCartDetail.MainProduct Obligatoire
Avec N items … (au minimum 1 item)
shoppingCartDetail.shoppingCartItemList.itemX.productCode Obligatoire
shoppingCartDetail.shoppingCartItemList.itemX.productDescription Obligatoire
shoppingCartDetail.shoppingCartItemList.itemX.productQuantity Obligatoire
shoppingCartDetail.shoppingCartItemList.itemX.productSKU Obligatoire

Analyser la réponse

Les champs spécifiques suivants sont valorisés dans le cas d’un paiement FacilyPay.

Nom du champ Remarques / règles
paymentMeanType Toujours valorisé à ONLINE_CREDIT.
paymentMeanBrand Toujours valorisé à ACCORD_3X ou ACCORD_4X.

Effectuer un paiement FacilyPay avec Sips Office

L’acceptation FacilyPay n’est pas disponible au travers de la solution Sips Office .

Gérer vos transactions FacilyPay

Opérations de caisse disponibles

Les opérations suivantes sont disponibles sur les transactions FacilyPay :

Gestion de caisse
Annulation V
Validation V Validation possible uniquement sur le montant total de la transaction.
Remboursement V
En cas de suspicion de fraude, vous devez renseigner le champ depositRefundIndicator aux valeurs suivantes :
  • « Y » s’il y a suspicion de fraude et que l’apport du client doit être remboursé.
  • « N » s’il y a suspicion de fraude mais que l’apport du client ne doit pas être remboursé.
  • « » s’il n’y a pas de suspicion de fraude.
Duplication X
Recyclage X
Crédit X
Attention: Vous devez attendre 48 h après la création de la transaction pour effectuer des opérations de gestion de caisse. Vous devez également respecter un délai de 48 h entre 2 opérations.

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 FacilyPay

Journaux

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 FacilyPay 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 X
Journal de rapprochement des impayés X
Note: pour les transactions FacilyPay, le champ paymentMeanBrand est renseigné avec les valeurs ACCORD_4X ou ACCORD_3X.

Sips Office Extranet

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

Voici le détail d'une transaction FacilyPay :