Contenu

Sommaire

maxLevel	2
style	none

Plus d'information informations

Intégration du moyen de paiement

Extrait

hidden	true

Paiement Casino 3xCB, 4xCB, 3xCB 3DS, 4xCB 3DS

Comment configurer votre compte ?

Vous devez vous rapprocher de votre responsable de compte ou d'un commercial pour la création de ce moyen de paiement.
Monext Online réalise toute la configuration.

Inclusion d'extrait

	Contactez le support Monext Online
	Contactez le support Monext Online
nopanel	true

Une fois votre le nom de l’alias du numéro de contrat créé alors le moyen de paiement est disponible.
Vous devez réaliser des transactions 'pilote' FLOA pour obtenir les informations nécessaires permettant de configurer votre compte sur Payline (Identifiants du compte et mot de passe).
Vous pouvez procéder au paramétrage dans votre compte marchand Payline en indiquant l’ID Marchand et le nom de l’alias du contrat partenaire à créer.
Vous devez réaliser des transactions tests pour valider le bon fonctionnement en production.

Afin de créer un moyen de paiement FLOA 3x4x sur Payline, en homologation et en production, rendez-vous sur le centre d’administration dans l’onglet « Configuration » puis « Vos moyens de paiement ».
Un écran de recherche s’affiche, cliquez sur le bouton « Nouveau moyen de paiement ».

Écran de création de moyen de paiement 1/2

Sélectionnez votre point de vente puis le type de moyen de paiement "Casino".
Cliquez ensuite sur le bouton « Suivant ».

Écran de création de moyen de paiement 2/2

Renseigner un libellé de votre choix par exemple "Floa_", un numéro de contrat et un numéro de banque transmis par FLOA puis sélectionner votre devise.
Cliquez sur le statut « Actif » et n'activez pas le rejeu de la transaction ni la collecte du titulaire de la carte bancaire sans demande de l'équipe Support Payline.
Renseignez ensuite vos informations bancaires.

Pour ces deux moyens de paiement, il est indispensable de renseigner 4 informations :

Identifiant STS
Mot de passe STS
Identifiant commerçant
Identifiant site commerçant
Si le contrat souscrit est un contrat 3DS ou non

Le code (card_code) du moyen de paiement est : CASINO_3XCB ou CASINO_4XCB

Image Removed

Ces données sont fournies aux commerçants par Banque FLOA.

Le code (card_code) du moyen de paiement est : CASINO_3XCB ou CASINO_4XCB

Image Added

Pour ces deux moyens de paiement, il est indispensable de renseigner 4 informations :

Identifiant STS
Mot de passe STS
Identifiant commerçant
Identifiant site commerçant
Si le contrat souscrit est un contrat 3DS ou non

Comment proposer le paiement FLOA 3x / 4x à vos clients ?

Le mode d'intégration est disponible avec l'API WebPayment : services doWebPayment et getWebPaymentDetail.
Le mode d'intégration en API direct avec la fonction 3DS est disponible.

Les principes d’utilisation

Au moment du doWebPayment, Payline réalise une demande d'éligibilité de paiement avant de proposer le moyen de paiement 3x ou 4x.

Payline affiche les conditions de crédit : échéancier et CGV.
Payline peut remplir les champs la date de naissance, département et nom de jeune fille s'ils sont fournis par le commerçant.
Le moyen de paiement ne s'affiche pas si le score n'a pu être réalisé. L'échéancier s'affiche même en cas de données personnelles manquantes.

Les paiements FLOA 3x/4x sont éligibles au traitement par le module anti-fraude Payline, au même titre que les autres transactions.
Si une authentification 3DSecure est nécessaire, Payline gère l’affichage de la page ACS. Seul un refus banque (FICP ou acquéreur) peut conduire à un refus du paiement.
La fonction getWebPaymentDetail renvoie l’échéancier sélectionné par l'acheteur.
Le marchand a la possibilité de modifier le montant de la commande après que le paiement ait été accepté. Le montant doit être inférieur ou égal à celui de la commande initiale .

La référence commande doit être différente a chaque paiement : balise order.ref

Extrait

hidden	true

Script JavaScript : En mode widget et mode redirection, le marchand doit intégrer un .JS theatmetrix sur sa page de paiement.

Il faut également vérifier : Le domaine.
Lors de l'exécution du JavaScript, il soit bien redirigé vers CB4X, l'enregistrement CNAME suivant devra être mis en place afin de relier le domaine cb4x.payline.com vers payline.threatmetrix.cb4x.fr : "cb4x.payline.com CNAME threatmetrix.cb4x.fr"
Sinon le script ne se chargera pas.

---

Comment proposer le paiement FLOA 3x / 4x à vos clients ?

Le mode d'intégration est disponible avec l'API WebPayment : services doWebPayment et getWebPaymentDetail.
Le mode d'intégration en API direct avec la fonction 3DS est disponible.

Les principes d’utilisation

Au moment du doWebPayment, Payline réalise une demande d'éligibilité de paiement avant de proposer le moyen de paiement 3x ou 4x.

Payline affiche les conditions de crédit : échéancier et CGV.
Payline peut remplir les champs la date de naissance, département et nom de jeune fille s'ils sont fournis par le commerçant.
Le moyen de paiement ne s'affiche pas si le score n'a pu être réalisé. L'échéancier s'affiche même en cas de données personnelles manquantes.

Les paiements FLOA 3x/4x sont éligibles au traitement par le module anti-fraude Payline, au même titre que les autres transactions.
Si une authentification 3DSecure est nécessaire, Payline gère l’affichage de la page ACS. Seul un refus banque (FICP ou acquéreur) peut conduire à un refus du paiement.
La fonction getWebPaymentDetail renvoie l’échéancier sélectionné par l'acheteur.
Le marchand a la possibilité de modifier le montant de la commande après que le paiement ait été accepté. Le montant doit être inférieur ou égal à celui de la commande initiale .

La référence commande doit être différente a chaque paiement : balise order.ref

Extrait

hidden	true

Script JavaScript : En mode widget et mode redirection, le marchand doit intégrer un .JS theatmetrix sur sa page de paiement.

Il faut également vérifier : Le domaine.
Lors de l'exécution du JavaScript, il soit bien redirigé vers CB4X, l'enregistrement CNAME suivant devra être mis en place afin de relier le domaine cb4x.payline.com vers payline.threatmetrix.cb4x.fr : "cb4x.payline.com CNAME threatmetrix.cb4x.fr"
Sinon le script ne se chargera pas.

----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Bonjour,

Suite à la PAYSUP 12879 et à la PAYLANO-4450, il y aurait quelques modifications et précisions à apporter à la documentation Casino 3/4xCB.

En effet, cette partie est erronée et à modifier :

Script JavaScript : En mode widget et mode redirection, le marchand doit intégrer un .JS theatmetrix sur sa page de paiement

Pour ThreatMetrix, les équipes technique m'ont confirmé, que c'est le WIDGET qui se charge d'insérer le script dans la page.

Cette partie sur les certificats SSL est à supprimer après validation avec les équipes Floa :
Les certificats SSL: pour que l'envoi de données à ThreatMetrix soit transparent, la génération d'un certificat SSL à partir du CSR fourni par CB4X devra être effectué par Payline. Une fois obtenu, il sera communiqué au processeur pour intégration sur leur loadBalancer.

Merci pour vos actions,

Cordialement,

Marine Matteï
Prestataire pour le compte de Monext [Support Payline]
T. +33 4 42 25 16 21
marine.mattei3@monext.net - www.monext.fr

Penser à l'environnement avant d'imprimer.
Consider the environment before printing.

---

Script JavaScript

En mode widget et mode redirection, le marchand doit intégrer un .JS theatmetrix sur sa page de paiement
Il faut insérer l’appel à ce JavaScript dans la page de paiement au moment de son chargement « OnLoad » ou dans son template en redirection.

</noscript>

A verifier : Les certificats SSL : pour que l'envoi de données à ThreatMetrix soit transparent, la génération d'un certificat SSL à partir du CSR fourni par CB4X devra être effectué par Payline. Une fois obtenu, il sera communiqué au processeur pour intégration sur leur loadBalancer.

Les web services en mode Web

Les

Initier le paiement

Les services doWebPayment et getWebPaymentDetail sont disponibles.

L'object Payment sera transmis par le commerçant avec les valeurs Action = 101 et Mode = CPT.

Récupérer le résultat

Le

service

service getWebPaymentDetail retourne l'échéancier : champ transaction.partnerAdditionalData avec paymentSchedule. Cette fonction implique l'utilisation d'une balise version avec une valeur >= 16.

Voletexpand

codelanguagexmlConfluencetheme

Remboursement

Le

service

service doRefund permet de rembourser la commande.

Extrait

Annulation

La

fonction

fonction doReset de l’API Payline permet au marchand de demander l’annulation totale ou partielle de la commande.

Les web services en mode Direct

Le mode d'intégration en API direct est disponible en utilisant le webservice webservice isRegistered. Ce service vous permet de récupérer le scoring data nécessaire pour appeler le moyen de paiement Floa.

Vous récupérez un registrationToken à renvoyer dans la demande de 3D Secure verifyEnrollment puis dans la demande de paiement doAuthorization.

En entrée le commerçant indique le contrat, le montant, commande et les données personnelles.
En retour, il reçoit un l'échéancier de paiement dont les frais de dossier et le registrationToken qui le registrationToken qui permettra de réaliser le paiement.

Les étapes

:

Sur le site marchand, le consommateur valide son panier, puis le marchand appelle Payline
avec le service isRegistered,
avec le service isRegistered.

Payline retourne un code 02500 - Accepter pour valider la demande et renvoie
le registrationToken ainsi
le registrationToken ainsi qu'une balise data contenant un objet JSON avec l'
échéancier paymentSchedules et le montant totalAmount ;
échéancier paymentSchedules et le montant totalAmount.

Puis il renvoie le jeton registrationToken dans la balise payment en appelant le verifyEnrollment pour réaliser le 3D Secure
;
.

Le consommateur saisie son mot de passe reçu par mobile
;
.

Le marchand réalise la demande de
paiement
paiement doAuthorization
avec registrationToken dans
avec registrationToken dans la balise
payment et les données 3DS ;
Payline réalise la requête et la réponse du l'autorisation et renvoie une notification.
Lorsque un doAuthorization ou un verifyEnrollment est réalisé avec la balise registrationToken demandé qui est absente, vide ou incorrectement valorisée.
L'erreur suivante est remontée par le service : code 02999, short_message ERROR, long_message 'Invalid registration token'.

Exemples de web services

1. Branchement de la demande de scoring : isRegistered

2. Branchement du 3DS : verifyEnrollment

3. Branchement de la demande d'autorisation : doAuthorization

payment et les données 3DS.
Payline réalise la requête et la réponse du l'autorisation et renvoie une notification.

Lorsque un doAuthorization ou un verifyEnrollment est réalisé avec la balise registrationToken demandé qui est absente, vide ou incorrectement valorisée.

L'erreur suivante est remontée par le service : code 02999, short_message ERROR, long_message 'Invalid registration token'.

Exemples de web services

1. Branchement de la demande de scoring : isRegistered

2. Branchement du 3DS : verifyEnrollment

3. Branchement de la demande d'autorisation : doAuthorization

Authentification 3D Secure

Les paiements sont éligibles au traitement par le module anti-fraude Payline, au même titre que les autres transactions.
Si une authentification 3DSecure est nécessaire, Payline gère l’affichage de la page ACS. Seul un refus banque (FICP ou acquéreur) peut conduire à un refus du paiement.

Les champs obligatoires

Les champs obligatoires doivent être renseignés lors de la demande de paiement, dans le cas contraire la demande sera refusée.

En complément des données obligatoires pour obtenir un paiement, vous devez transmettre les données obligatoires dans le tableau ci-dessous.

Les prérequis sont définis par leurs types d'utilisation :

Mode web
- doWebPayment : fonctionnement éligibilité (mode automatiquement réalisé par Monext).
Mode direct
- doAuthorization : fonctionnement éligibilité.
- isRegistered : fonctionnement pré-éligibilité.

Authentification 3D Secure

Les paiements sont éligibles au traitement par le module anti-fraude Payline, au même titre que les autres transactions.
Si une authentification 3DSecure est nécessaire, Payline gère l’affichage de la page ACS. Seul un refus banque (FICP ou acquéreur) peut conduire à un refus du paiement.

Les champs obligatoires

Les champs obligatoires doivent être renseignés lors de la demande de paiement, dans le cas contraire la demande sera refusée.

En complément des données obligatoires pour obtenir un paiement, vous devez transmettre les données obligatoires suivantes :

Order.country : FR (= FRANCE)

Order.deliveryMode : voir valeurs possibles entre 1 et 5

Order.reference

Order.date

Order.Amount et Payment.Amount : l'order amount est le montant global de la commande. Le champs order.amount doit être égal au payment.amount.

Order.amount
Order.currency = 978
Payment.amount
Payment.currency = 978

Buyer.title : voir valeurs possibles

Buyer.lastname

Buyer.firstname

Buyer.email

Buyer.birthDate

Buyer.phoneType : voir valeurs possibles.

Buyer.phone

Buyer.billingAdress.title : voir valeurs possibles

Buyer.billingAdress.lastname

Buyer.billingAdress.firstname

Buyer.billingAdress.street1

Buyer.billingAdress.city

Buyer.billingAdress.zipcode

Buyer.billingAdress.country

Buyer.ip : doit être vide.

PrivateData

Object	Balise	Description
Order	Order.country	Valeur FR (= FRANCE)
	Order.deliveryMode	Voir valeurs possibles entre 1 et 5.
	Order.reference	Format à respecter Uniquement des lettre et des chiffres et le caractères underscore sont acceptés. Limite de 30 caractères.
	Order.date	Format : dd/mm/yyyy HH24:MI
	Order.Amount	L'order amount est le montant global de la commande. Le champs order.amount doit être égal au payment.amount.
	Order.currency	Valeur = 978
Payment	Payment.amount	Montant de l'oération.
Payment	Payment.currency	Valeur = 978
Buyer	Buyer.title	Voir valeurs possibles.
	Buyer.lastname	Information de l'acheteur.
	Buyer.firstname	Information de l'acheteur.
	Buyer.email	Information de l'acheteur.
	Buyer.birthDate	Information de l'acheteur.
	Buyer.phoneType	Information de l'acheteur. Voir valeurs possibles.
	Buyer.phone	Information de l'acheteur.
	Buyer.billingAdress.title	Information de l'acheteur. Voir valeurs possibles.
	Buyer.billingAdress.lastname	Information de l'acheteur.
	Buyer.billingAdress.firstname	Information de l'acheteur.
	Buyer.billingAdress.street1	Information de l'acheteur.
	Buyer.billingAdress.city	Information de l'acheteur.
	Buyer.billingAdress.zipcode	Information de l'acheteur.
	Buyer.billingAdress.country	Information de l'acheteur.
	Buyer.ip	Doit être vide.
	PrivateData

Développer

title	Liste des PrivateData

Key	Value	Valeurs possibles
OrderSaleChannel	Canal de vente Obligatoire.	DESKTOP TABLET TABLET_IPAD SMARTPHONE SMARTPHONE_ANDROID SMARTPHONE_IPHONE
CustomerBirthZipCode	Code postal de la ville de naissance (1 ou 4 caractères refusés). Facultatif : si non renseigné, Payline collectera cette information dans le formulaire.	`99` : si étranger `972` : pour la Martinique `06000` pour Nice et non `6000`
CustomerMaidenName	Nom de jeune fille Facultatif : si non renseigné, Payline collectera cette information dans le formulaire.
OrderTag	Valeur du Tag de la commande (champ libre). Facultatif.

excerpt

Transmission des données

clients

acheteurs

Pour transmettre les données 3DS, OTA, champs libre et historique, vous devez utiliser la balise <miscData> du doWebPayment en version 18 ou supérieure.

Cette balise prend en compte un object JSON formaté qui sera retransmis à Floa.
Les données OTA doivent être référencées par le numéro de contrat auquel elles font référence. Ces données sont facultatives.
Les balises <![CDATA[ ... ]]> ne sont pas obligatoires.

Le numéro de contrat contenu dans le JSON doit être un numéro de contrat présent dans les balises selectedContractList ou secondSelectedContractList du service doWebPayment appelé.
S'ils ne sont pas non présent une erreur 'Invalid contractNumber' est levée avec le code retour 02303.

Le JSON doit être bien formaté de la manière suivante :

{ "ContractNUMBER" : "Contenu JSON ..." }

avec { "CASINO_3XCB" : "{'optionalTravelDetails':{...}" , 'additionalNumericFieldList':{...}" , 'additionalTextFieldList':{...}" , 'MerchantCustomerHistory':{...}" , }

Exemple

miscData

de code :

excerpt

12345678910
11
12
13
14
15
16
17
18
19
20
21
22
23<impl:miscData>
<

miscData>

Données de scoring Floa

Les données contenues dans le JSON correspondent aux données du service Score de Floa:

```
optionalTravelDetails
```
```
additionalNumericFieldList
```
```
additionalTextFieldList
```
```
MerchantCustomerHistory :
```

Champs	Description	Format
CanceledOrderAmount	Montant total en centimes des commandes annulées durant les 2 dernières années	Integer
CanceledOrderCount	Nombre de commandes effectuées puis annulées par le client durant les 2 dernières années	Integer
FirstOrderDate	Date de la première commande du client Format AAAA-MM-JJ	DateTime
FraudAlertCount	Nombre d’alertes de fraude concernant les commandes du client durant les 2 dernières années	Integer
LastOrderDate	Date de la dernière commande du client Format AAAA-MM-JJ	DateTime
PaymentIncidentCount	Nombre d’incidents de paiement concernant les commandes du client durant les 2 dernières années	Integer
RefusedManyTimesOrderCount	Nombre de commandes dont le paiement en plusieurs fois a été refusé au cours des 2 dernières années	Integer
UnvalidatedOrderCount	Nombre de commandes refusées dans la phase de validation au cours des 2 dernières années	Integer
ValidatedOneTimeOrderCount	Nombre de commandes ayant été réglées en 1 fois au cours des 2 dernières années	Integer
ValidatedOrderCount	Nombre de commandes validées ces 2 dernières années.	Integer

Volet Développer

title	Balise miscData

Bloc de code

language	xml
theme	Confluence
title	Balise miscData
linenumbers	true
collapse	true

<impl:miscData>
    <![CDATA[
        { "CASINO_3XCB": "{'optionalTravelDetails':
                                {'class':'First',
                                 'departureDate':'2019-10-05T08:43:00',
                                 'destinationCountry':'GN',
                                 'insurance':'SIMPLE',
                                 'mainDepartureCompany':'Luftansa',
                                 'ownTicket':false,
                                 'ticketCount':1,
                                 'travellerCount':2,
                                 'travellerPassportList':[{'expirationDate':'2018-12-31T08:45:00','issuanceCountry':'FR'},
                                                          {'expirationDate':'2019-01-01T08:45:00','issuanceCountry':'DE'}],
                                 'type':'TwoWay'
                                },
                            'additionalNumericFieldList':[{'index':'1', 'value':'10'},
                                                          {'index':'2', 'value':'20'}],
                            'additionalTextFieldList':[{'index':'11', 'value':'val11'},
                                                       {'index':'22', 'value':'val22'}],
                            'MerchantCustomerHistory':{'CanceledOrderAmount':'1000', 
                                                       'CanceledOrderCount':'900', 
                                                       'FirstOrderDate':'2016-12-31T08:45:00', 
                                                       'FraudAlertCount':'0', 
                                                       'LastOrderDate':'2017-12-29T11:14:00'}
                          }"
        }
      ]]>
</impl:miscData>

Comment réaliser des tests ?

Vous devez demander un compte de test ainsi que des cartes de test à Banque FLOA.

Pour pouvoir faire des tests sur l'API, vous pouvez utiliser la carte de test ci-dessous :

Numéro	5017670000001800
CVV	000
Date d'expiration	> à la dernière échéance

Les codes de retour

Inclusion d'extrait

	Les codes retour
	Les codes retour
nopanel	true

Développer

title	Les codes spécifiques au moyen de paiement

État de la transaction	Code partenaire	Statut – code - Motif
autorisation réussi	0	ACCEPTED – 00000 – Transaction accepted
Refus - requête invalide	1	REFUSED – 02020 - Transaction refused by partner
Refus - autorisation refusée par la banque	2	REFUSED – 02020 - Transaction refused by partner
Échec technique	3	ERROR – 02106 - Payment partner error
En attente	4	ONHOLD_PARTNER – 02005 - Transaction in progress, please wait for payment status
État indéterminé	5	ERROR – 02106 - Payment partner error
Annulé	6	CANCELLED – 02319 - Transaction cancelled by user

Exemples de trame

Pages associées

Contenu par étiquette

showLabels	false
max	10
spaces	com.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@9a3
showSpace	false
sort	title
type	page
cql	label = "integration" and label = "fr" and label = "widget" and type = "page" and space = "DT"
labels	bancontact belgique choixdelamarque

...

Arborescence des pages

Comparaison des versions

Ancienne version 35

Nouvelle version Actuel

Légende

Comment configurer votre compte ?

Comment proposer le paiement FLOA 3x / 4x à vos clients ?

Les principes d’utilisation

Comment proposer le paiement FLOA 3x / 4x à vos clients ?

Les principes d’utilisation

Les web services en mode Web

Initier le paiement

Récupérer le résultat

Remboursement

Annulation

Les web services en mode Direct

Les étapes

Exemples de web services

1. Branchement de la demande de scoring : isRegistered

2. Branchement du 3DS : verifyEnrollment

3. Branchement de la demande d'autorisation : doAuthorization

Exemples de web services

1. Branchement de la demande de scoring : isRegistered

2. Branchement du 3DS : verifyEnrollment

3. Branchement de la demande d'autorisation : doAuthorization

Authentification 3D Secure

Les champs obligatoires

Authentification 3D Secure

Les champs obligatoires

Transmission des données

acheteurs

Données de voyage

Comment réaliser des tests ?

Les codes de retour

Exemples de trame

Pages associées

Arborescence des pages

Historique de la page

Comparaison des versions

Ancienne version 35

Nouvelle version Actuel

Légende

Comment configurer votre compte ?

Comment proposer le paiement FLOA 3x / 4x à vos clients ?

Les principes d’utilisation

Comment proposer le paiement FLOA 3x / 4x à vos clients ?

Les principes d’utilisation

Les web services en mode Web

Initier le paiement

Récupérer le résultat

Remboursement

Annulation

Les web services en mode Direct

Les étapes

Exemples de web services

1. Branchement de la demande de scoring : isRegistered

2. Branchement du 3DS : verifyEnrollment

3. Branchement de la demande d'autorisation : doAuthorization

Exemples de web services

1. Branchement de la demande de scoring : isRegistered

2. Branchement du 3DS : verifyEnrollment

3. Branchement de la demande d'autorisation : doAuthorization

Authentification 3D Secure

Les champs obligatoires

Authentification 3D Secure

Les champs obligatoires

Transmission des données

acheteurs

Données de voyage

Comment réaliser des tests ?

Les codes de retour

Exemples de trame

Pages associées