Paiement FacilyPay

De Documentation Mercanet
Aller à : navigation, rechercher

Introduction

L’objectif du présent document est d’accompagner les commerçants désirant mettre en œuvre le moyen de paiement FacilyPay.

Info.png A noter

Tous les termes, acronymes, expressions spécifiques à la Mercanet et son contexte sont définies dans le document : GLOSSAIRE.
N’hésitez pas à vous y référer chaque fois que nécessaire

Comment ça marche ?

Principes Géneraux

Oney propose une solution de crédit en ligne avec paiement en 3-4 fois par carte bancaire noté Facilypay.

Avec ce moyen de paiement, le marchand peut toucher davantage de clients en proposant des solutions plus adaptées à certains produits ou services vendus sur son site web. Pour les clients, cela permet également de souscrire à des crédits directement en ligne sur le site marchand.

Disponibilité par Offre

Le moyen de paiement FacilyPay est disponible sur les interfaces suivantes :

Interface (mode) Moyen de paiement

Mercanet Essentiel

Mercanet Gestion PLus

Mercanet Batch

Mercanet Walletpage

POST

SOAP

JSON

SOAP

JSON

Batch

POST

SOAP

JSON

FacilyPay

-

-

-

-

-

-

Processus de paiement

Vue de l’utilisateur

Les étapes parcourues par les internautes lors de l’exécution d’un paiement FacilyPay sont décrites ci-dessous :

Facily1.PNG

Cinématique des écrans de paiement dans Mercanet Essentiel

Stage

Description

1

Validation du panier, paiement et redirection vers la solution Mercanet

2

Après la sélection du moyen de paiement FacilyPay (3x ou 4x), l’utilisateur est redirigé vers les pages de paiement FacilyPay.

3

Il renseigne les informations nécessaires au paiement, puis il valide le paiement.

4

Il passe alors par une page temporaire avant d’être redirigé sur une page qui affiche les données de la commande et d’autres informations concernant le montant de son crédit.

5

L’acheteur est automatiquement redirigé au site marchand (en passant par Mercanet).

Mercanet Essentiel

Le processus de paiement dans Mercanet Essentiel est décrit ci-dessous :
Facily2.PNG
 Schéma des flux de Mercanet Essentiel

Stage

Description

1

L’internaute valide la commande sur le site marchand.

2

Le marchand initialise une session de paiement et redirige l’internaute sur la page de sélection du moyen de paiement.

3

L’internaute choisit “FacilyPay” comme moyen de paiement. Il choisit ensuite sa méthode de règlement dans la liste disponible pour ce marchand, il peut afficher le montant final avec la simulation, puis il initie l’ordre de paiement.

4

Une confirmation du paiement est envoyée à l’internaute et au marchand.

5

Mercanet est responsable de la préparation et de l’envoi des fichiers de remise à l’acquéreur dans le but d’achever le transfert des fonds.

Pages de paiement

Facily3.PNG
 Choix du moyen de paiement
Facily6.PNG
Entrée des informations de la carte et des données personnelles
Facily5.PNG
Détails de la commande

Fonctionnalités

Type de fonctionnalité

Disponibilité

Remarque

Canaux de paiement

Internet

Canal par défaut

VPC-MOTO (courrier ou téléphone)

N/A

Méthodes de paiement

Paiement immédiat

Forcé vers un paiement à la fin du jour

Paiement à la fin du jour

Méthode par défaut

Paiement différé

Forcé vers un paiement à la fin du jour

Paiement à l’expédition

Forcé à 30 jours max

Paiement échelonné

N/A

Paiement   par abonnement

N/A

Paiement batch (par lots)

N/A

Paiement "One-click"

N/A

Paiement en devises

  Paiement multi-devises  

N/A

EUR uniquement

  Encaissement en devises  

N/A

EUR uniquement

Gestion de la fraude

  Veuillez-vous référer au guide de contrôle contre la fraude

Reportings commerçant

Journal des transactions

Journal des opérations

Journaux rapprochements bancaires

N/A

Journaux rapprochement des impayés

N/A

Back Office (Extranet)

Opérations

Annulation

Validation

Sur montant total uniquement

Remboursement

Champs spécifiques (voir 6.3 pour les détails)

Mode de capture

Mode envoi automatique (annulation)

Mode de validation

Mode immédiat

N/A

Cycle de vie de la transaction

Cycle de vie Mercanet

Facily7.PNG
Cycle de vie des transactions FacilyPay

Cycle de vie spécifique Oney

Il y a deux niveaux de réponse pour FacilyPay:

Le premier niveau est retourné après la souscription du client

  • Ce premier niveau ne renvoie jamais de réponse définitive. Il s’agit simplement d’une “réponse de principe” donnée par Oney.
  • Le second niveau est retourné après la remise de la transaction

  • La réponse peut être définitive cette fois.


À cause de ce cycle de vie spécial, une demande de remise est enchainée à la suite des appels standards dans deux cas  :

  • Lors de la finalisation de la transaction en cas de mode de capture Envoi automatique (Annulation).
  • Lors de la validation de la transaction en cas de mode de capture Validation. 

Dans tous ces différents cas, le commerçant doit attendre que le statut de la transaction soit à "CAPTURED” avant d’envoyer la commande au client, c’est ce statut qui traduit la réponse définitive de Oney.

Si le commerçant souhaite consulter le statut de la transaction, trois possibilités s’offrent à lui selon son offre:

  • La méthode « GetTransactionData » du service « Diagnostic »
  • Le journal des opérations
  • Le back Office

Intégration avec Mercanet Essentiel

Demande de paiement

Des informations spécifiques sont nécessaires pour réaliser un paiement FacilyPay, et certaines règles spécifiques s’appliquent:

Nom du champ

Remarques/règles

Exemple de valorisation

amount

Le montant doit être supérieur ou égal à 300€

300

captureMode

AUTHOR_CAPTURE ou VALIDATION

AUTHOR_CAPTURE

captureDay

Maximum 99

10

paymentMeanBrandList

ACCORD_3X ou ACCORD_4X

ACCORD_3X

paymentPattern

Le type de paiement est forcé à ONE_SHOT.

ONE_SHOT

orderId

Obligatoire, maximum 8 caractères

OI100010

customerId

Obligatoire, maximum 9 caractères

w01479164

customerContact.email

Obligatoire

paul.dupont@gmail.com

paymentMeanData.facilypay.settlementMode

Obligatoire Code de l’opération commerciale

VTP03 : 3x gratuit
VTP04 : 4x gratuit
W3019 : 3x payant
W4019 : 4x payant

paymentMeanData.facilypay.settlementModeVersion

Obligatoire Version du code de l’opération commerciale

1  

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)

2

billingContact

Pour plus de détail voir chapitre correspondant

billingAddress

Pour plus de détail voir chapitre correspondant

deliveryData

Pour plus de détail voir chapitre correspondant

deliveryContact

Pour plus de détail voir chapitre correspondant

deliveryAddress

Pour plus de détail voir chapitre correspondant

shoppingCartDetails

Pour plus de détail voir chapitre correspondant

L’affichage des pages de paiement en 3X ou en 4X dépend du mode de règlement fourni dans la requête.

Pour FacilyPay :
Si le commerçant choisit un mode de règlement de type paiement 3 fois dans le champ settlementMode, il faut également indiquer dans le champ paiementMeanBrandList le moyen de paiement ACCORD_3X (et pas ACCORD_4X).
Si le commerçant chosit un mode de règlement de type paiement 4 fois dans le champ settlementMode, il faut également indiquer dans le champ paiementMeanBrandList le moyen de paiement ACCORD_4X (et pas ACCORD_3X).
Cette règle n’a pas d’impact sur les autres moyens de paiement qui pourraient exister dans le champ paiementMeanBrandList.

Réponses manuelles et automatiques

Certaines règles spécifiques s’appliquent:

Nom du champ 

Remarques/règles

Exemple de valorisation

paymentMeanType

PROVIDER

paymentMeanBrand

ACCORD_3X ou ACCORD_4X

Intégration avec Mercanet Gestion PLus

Demande de paiement

L’acceptation FacilyPay n’est pas disponible au travers de la solution Mercanet Gestion PLus.

Gestion de caisse : remboursement

En cas de suspicion de fraude, le commerçant doit 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.

Cas spécifiques

Rupture de cinématique

Lorsque la transaction de paiement est en cours, l’acheteur peut fermer la fenêtre de son navigateur avant la page de confirmation du paiement.
Par conséquent, la transaction n’est pas finalisée (car elle n’est pas enregistrée) sur la plateforme Mercanet et le marchand ne recevra pas la réponse de ce paiement.
Pour le marchand, deux méthodes sont disponibles pour connaitre le statut de la transaction:

  • Avec un appel web service au GetTransactionData dix minutes après le début de la transaction de paiement. À ce moment, la réponse contiendra le statut de la transaction si elle a été finalisée.
  • Avec une réponse automatique (serveur à serveur) lorsque le champ “automatic_response_url” est renseigné par le marchand.

Annexes

Codes réponse

Le tableau ci-dessous liste les principaux codes réponse renvoyés par le server d’autorisations Oney pour FacilyPay.

Codes réponse Sips

Codes réponse acquéreur

Description

00

00

Transaction approuvée ou traitée avec succès

05

05

Transaction refusée

57

Transaction refusée (Transaction non autorisée pour ce compte)

12

12

Transaction invalide

17

17

Paiement annulé par l’internaute sur les pages de paiement

30

30

Format de requête invalide

34

34

Suspicion de fraude

60

60

Paiement en cours

90

90

Problème sur le serveur du partenaire (Système momentanément arrêté)

97

Problème sur le serveur du partenaire (Transaction refusée)

99

Problème sur le serveur du partenaire (Incident sur le serveur)
Ou erreur de lecture du flux envoyé par le commerçant

Devises acceptées

Code de devise

Description

978

Euro

Langages acceptés

Code

Langage

fr

Français

ge

Allemand

en

Anglais

es

Espagnol

it

Italien

pt

Portugais

BillingContact

Nom du champ             

Remarques/règles

Exemple de valorisation

billingContact.title

Obligatoire

M

billingContact.lastname

Obligatoire

DUPONT

billingContact.firstname

Facultatif

PAUL

billingContact.phone

Facultatif

0145340000

billingContact.mobile

Facultatif

0645340000

BillingAddress

Nom du champ             

Remarques/règles

Exemple de valorisation

billingAddress.streetNumber

Obligatoire

45

billingAddress.street

Obligatoire

RUE DE LA VALLEE MAILLARD

billingAddress.zipCode

Obligatoire

41000

billingAddress.city

Obligatoire

BLOIS

billingAddress.country

Obligatoire (ISO 3166-1 alpha-3)

FRA (France)

billingAddress.addressAdditional1

Facultatif

billingAddress.addressAdditional2

Facultatif

billingAddress.addressAdditional3

Facultatif

billingAddress.company

Facultatif

DeliveryData

Nom du champ             

Remarques/règles

Exemple de valorisation

deliveryData.estimatedDeliveryDate

Obligatoire

20141128

deliveryData.deliveryMode

Obligatoire 1, 2, 3, 4 or 5

4

deliveryData.deliveryMethod

Obligatoire 1 : Express (moins de 24h) ou 2 : Standard

2

deliveryData.deliveryOperator

Obligatoire

CHRONOPOST

Description du champ deliveryMode:

Code

Description

1

Retrait de la marchandise chez le marchand

2

Utilisation d'un réseau de points-retrait tiers (type kiala, alveol, etc.)

3

Retrait dans un aéroport, une gare ou une agence de voyage

4

Transporteur (La Poste, Colissimo, UPS, DHL... ou tout transporteur privé)

5

Emission d’un billet électronique, téléchargements

DeliveryContact

Nom du champ             

Remarques/règles

Exemple de valorisation

deliveryContact.title

Obligatoire

M

deliveryContact.lastname

Obligatoire

DUPONT

deliveryContact.firstname

Obligatoire

PAUL

deliveryContact.phone

Obligatoire

0145340000

deliveryContact.mobile

Obligatoire

0645340000

deliveryContact.email

Obligatoire

paul.dupont@gmail.com

DeliveryAddress

Nom du champ             

Remarques/règles

Exemple de valorisation

deliveryAddress.streetNumber

Obligatoire

10

deliveryAddress.street

Obligatoire

AVENUE DU MARECHAL MAUNOURY

deliveryAddress.zipCode

Obligatoire

41000

deliveryAddress.city

Obligatoire

BLOIS

deliveryAddress.country

Obligatoire (ISO 3166-1 alpha-3)

FRA

deliveryAddress.addressAdditional1

Facultatif

deliveryAddress.addressAdditional2

Facultatif

deliveryAddress.addressAdditional3

Facultatif

deliveryAddress.company

Facultatif

ShoppingCartDetail

Nom du champ             

Remarques/règles

Exemple de valorisation

shoppingCartDetail.shoppingCartTotalQuantity

Obligatoire

1

shoppingCartDetail.MainProduct

Obligatoire

TELEPHONE

shoppingCartDetail.shoppingCartItemList={ champ1=valeur1, champ2=valeur2, ... } avec les champs suivant :

     productCode

Obligatoire

TELEPHONE

     productDescription

Obligatoire

IPHONE 4S

     productQuantity

Obligatoire

1

     productSKU

Obligatoire

16

Description du champ productSKU:

Code

Description

1

Alimentation & gastronomie

2

Auto & moto

3

Culture & divertissements

4

Maison & jardin

5

Electroménager

6

Enchères et achats groupés

7

Fleurs & cadeaux

8

Informatique & logiciels

9

Santé & beauté

10

Services aux particuliers

11

Services aux professionnels

12

Sport

13

Vêtements & accessoires

14

Voyage & tourisme

15

Hifi, photo & vidéos

16

Téléphonie & communication