logo Mercanet

Release 24.2

aller directement au contenu

Rechercher par mots clés

Floa Bank CB 3X 4X

Pour rechercher dans la page utiliser Ctrl+F sur votre clavier

Mercanet 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 Floa Bank 3X et/ou 4X dans Mercanet.

Ce document a pour objectif de vous aider à implémenter le moyen de paiement Floa Bank 3X et/ou 4X 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 Mercanet, nous vous conseillons de consulter les documents suivants :

  • Présentation fonctionnelle
  • Guide de configuration des fonctionnalités

Société financière du groupe Floa, Floa Bank propose la solution Floa Bank 3X et/ou 4X, réservée aux personnes physiques majeures titulaires d’une carte bancaire valable au moins 3 mois après la date de conclusion du contrat de paiement échelonné et dont l'utilisation n'est pas soumise à une demande d’autorisation systématique (notamment les cartes Visa Electron et Maestro).

Grâce à cette solution, les clients paient en 3 ou 4 fois leurs achats sur Internet.

Lors d'un paiement Floa Bank 3X et/ou 4X, le client complète ses données personnelles ainsi que ses informations de carte bancaire lors de la souscription. Cette souscription précise le nombre d’échéances de paiement, le montant de chaque échéance et les dates relatives au paiement.

A la fin de sa saisie, il est informé en ligne du résultat de sa demande.

La prise d’empreinte réalisée au cours de la cinématique de paiement peut faire l’objet d’une authentification 3-D Secure.

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 V
Paiement en plusieurs fois X
Paiements par abonnement X
Paiement par fichier X
Paiement OneClick X
Gestion des devises
Acceptation multidevise X EURO uniquement
Règlement en devise X EURO uniquement
Conversion dynamique des devises X EURO uniquement

Le client choisit le moyen de paiement Floa Bank 3X et/ou 4X.

Il est redirigé sur les pages Floa Bank.

Il remplit un formulaire avec ses informations personnelles :



Le client pourra ensuite saisir les informations relatives à sa carte bancaire :



Le ticket de paiement s’affiche, puis le client retourne sur votre site Web. Cette page peut être bypassée.

Tip: pour plus d'information sur le bypass merci de vous référer au paragraphe Affichage du ticket par Mercanet de la documentation Guide de configuration des fonctionnalités.

Afin de proposer le moyen de paiement Floa Bank 3X et/ou 4X sur votre site Web, vous devez souscrire un contrat auprès de Floa Bank. Floa Bank se chargera ensuite de transmettre ces informations, qui seront implémentées sur votre boutique de commerçant Mercanet directement.

Floa Bank souscrira en parallèle, un contrat de Vente A Distance auprès du CIC pour finaliser votre inscription et vous donner accès au moyen de paiement.

Vous pouvez proposer le moyen de paiement Floa Bank 3X et/ou 4X au travers de Paypage qui assure l’interface de paiement directement avec le client via son navigateur Web.

Les modes de remise disponibles pour une transaction Floa Bank 3X et/ou 4X sont les suivants :

  • Mode validation : vous devez valider la transaction pour déclencher la remise. Un délai de capture doit ê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.

Il est à noter que:

  • seul le mode "IMMEDIATE" dans la requête marchand WL Sips est compatible avec la configuration "Automatic" coté contrat d'acquisition FLOA PAY
  • seul le mode "VALIDATION" dans la requête marchand WL Sips est compatible avec la configuration "Manual" coté contrat d'acquisition FLOA PAY.

Le diagramme ci-dessous explique les différents états par lesquels peuvent passer les transactions selon le mode de capture choisi :


Description des status possibles pour une transaction Floa Bank 3X et/ou 4X

En mode validation (captureMode = VALIDATION), si la transaction est acceptéem elle passe en status TO_VALIDATE. En mode immediat (captureMode = IMMEDIATE), si la transaction est acceptée (responseCode égal à 00), elle passe en statut CAPTURED. Quel que soit le mode de capture, si la transaction est refusée (responseCode différent de 00), elle passe en statut REFUSED.

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


Étapes d'un paiement Lyf Pay via Paypage

1) Le client procède au paiement. 2) Il est redirigé vers la page de sélection du moyen de paiement hébergée chez Mercanet, il sélectionne Floa Bank 3X et/ou 4X et saisit son numéro de carte. 3) Il est redirigé vers la page Floa Bank 3X et/ou 4X où il s'authentifie. 4) Il est redirigé sur une page Mercanet. 5) S'il clique sur le bouton de retour à la boutique, il est redirigé vers votre site Web ce qui délenche l'envoi de la réponse manuelle. 6) Mercanet envoie une réponse automatique.

Le champ existant paymentMeanBrandList doit être renseigné avec la liste des moyens de paiement proposés au client et spécifiquement le moyen de paiement Floa Bank proposé.

Les 2 offres sont les suivantes : BCACB_3X et BCACB_4X.

Les champs spécifiques pour la réalisation d’un paiement sont les suivants :

Nom du champ Remarque / Règles
customerLanguage Permet de choisir la langue utilisée sur les pages Mercanet et Floa Bank.
customer.country Pays (=FR)
customerId Obligatoire.
Identification unique qui caractérise le client dans le SI du commerçant.
customerContact.lastName Obligatoire.
Nom du client.
customerContact.firstName Obligatoire.
Prénom du client.
customerContact.phone Numéro de téléphone fixe du client. Obligatoire si le numéro de téléphone portable n'est pas renseigné.
customerContact.mobile Numéro de téléphone portable du client. Obligatoire si le numéro de téléphone fixe n'est pas renseigné.
customerContact.email Obligatoire.
Email du client.
customerAddress.addressAdditional1 Obligatoire.
Adresse principale.
customerAddress.zipCode Obligatoire.
Code postal
customerAddress.city Obligatoire.
Ville
customerAddress.country Obligatoire.
Code ISO Alpha-2 du Pays (=FR)
deliveryData.deliveryMode Obligatoire. Mode de livraison du commerçant :
  • CDS : Colissimo direct
  • CHR : Chronopost
  • COL : Colissimo
  • CRE : Chronopost / Chronorelais
  • KIA : Kiala
  • .IMP : impression et envoi à domicile
  • LSP : livraison service plus
  • MOR : Mory
  • RCD : relais Cdiscount
  • TNT : TNT
  • TRP : transporteur
  • AE1 : Easydis erreur
  • EA1 : Easydis
  • KIB : KIB
  • TNB : TNT Belgique
  • EXP : livraison Express
  • AGE : Agediss
  • EMP : emporté
  • M30 : emporté -30
  • ADX : Adrexo
  • EY1 : emporté -30 Easydis
  • VIR : virtuel
  • REG : recommandé
  • STD : normal
  • TRK : suivi
  • PRM : Premium Easydis
  • RDO : confort (SOGEP) Easydis
  • RCO : relais colis (SOGEP) Cestas
  • SO1 : SoColissimo Zone Outre-Mer 1
  • SO2 : SoColissimo Zone Outre-Mer 2
  • RIM : retrait immédiat en magasin
  • LDR : LDR
  • MAG : livraison en magasin
  • RDE : Eco (SOGEP) Easydis
  • REL : Mondial Relay
  • FDR : fournisseur direct en relais
  • TNX : TNT express Relais
  • EMX : Express
  • CHX : emporté Chronopost relais
  • CSX : emporté Chronopost consigne
deliveryData.deliveryChargeAmount Facultatif.
Montant total des frais de livraisons pour la commande (en centimes).
shoppingCartDetail.shoppingCartTotalQuantity Obligatoire.
Nombres d'articles.
orderId Obligatoire.
Nombres d'articles.
shoppingCartDetail.shoppingCartTotalTaxAmont Facultatif.
Montant total des frais associés à la commande (en centimes).
shoppingCartDetail.discountAmount Facultatif.
Montant total des remises associées à la commande (en centimes). Par défaut valorisé à 0.
shoppingCartDetail.shoppingCartItemList.item0.travelData Facultatif.

A partir de la version IR_WS_2.38 (Paypage SOAP/REST) ou HP_2.38 (Paypage POST).
Données voyage - voir le tableau ci-dessous.

travelData

Note: travelData est un container dédié aux commerçants voyagistes. Un champ marqué "Obligatoire" dans les containers ci-dessous ne l'est que pour les commerçants voyagistes. Pour Floa, les données voyage sont contenues dans le premier item du panier : shoppingCartDetail.shoppingCartItemList.item0.
Nom du champ Remarque/Règles
travelData.numberOfTravelers Obligatoire
Nombre de voyageurs
travelData.travelStartDateTime Obligatoire - Format ISO8601
Date et heure de départ
travelData.travelEndDateTime Obligatoire - Format ISO8601
Date et heure de retour
travelData.travelingPayerIndicator Facultatif - Valeurs autorisées :

true - Le payeur participe au voyage
false - Le payeur ne participe pas au voyage

travelData.passportDataList Facultatif - Liste des données de passeport

Données de passeport des voyageurs, notées travelData.passportDataList.passportDataX où X est l'indice du passeport dans la liste

travelData.passportDataList.passportDataX.passportExpirationDate Facultatif - Format YYYYMMDD
Date d'expiration du passeport
travelData.passportDataList.passportDataX.passportIssueCountry Facultatif - Valeurs autorisées : countryList
Code ISO Alpha-3 du pays d'émission du passeport
travelData.journeyDataList Facultatif - Liste des données de trajet

Seul le premier trajet de la liste est pris en compte pour Floa, par conséquent les champs ci-dessous seront notés travelData.journeyDataList.journeyData0.XXXX

travelData.journeyDataList.journeyData0.departureLocation Facultatif

Code IATA de l'aéroport de départ sur 3 caractères

travelData.journeyDataList.journeyData0.arrivalLocation Facultatif

Code IATA de l'aéroport d'arrivée sur 3 caractères

travelData.journeyDataList.journeyData0.destinationCountry Obligatoire - Valeurs autorisées : countryList
Code ISO Alpha-3 du pays de destination
travelData.journeyDataList.journeyData0.numberOfTickets Facultatif

Nombre de billets

travelData.journeyDataList.journeyData0.journeyModality Facultatif - Valeurs autorisées :

ONEWAY - Aller simple
TWOWAY - Aller-retour
MULTIPLE - Multi-destinations

travelData.journeyDataList.journeyData0.classLevel Facultatif - Valeurs autorisées :

1 - Première classe ou classe business
2 - Seconde classe ou classe économique

travelData.journeyDataList.journeyData0.carrierIdentifier Facultatif

Code IATA de la compagnie aérienne sur 2 caractères

travelData.journeyDataList.journeyData0.fareBasis Facultatif

Tarif du trajet ou code de réduction

travelData.journeyDataList.journeyData0.journeyInsurance Facultatif

Modalité d'assurance du trajet

travelData.journeyDataList.journeyData0.journeyCancellableIndicator Facultatif - Valeurs autorisées :

true - Le trajet est modifiable ou annulable
false - Le trajet est ni modifiable, ni annulable

travelData.journeyDataList.journeyData0.luggageSupplementIndicator Facultatif - Valeurs autorisées :

true - Le trajet dispose d'un supplément bagage
false - Le trajet ne dispose pas d'un supplément bagage

travelData.stayDataList Facultatif - Liste des données d'étape

Seul la première étape de la liste est prise en compte pour Floa, par conséquent les champs ci-dessous seront notés travelData.stayDataList.stayData0.XXXX

travelData.stayDataList.stayData0.stayCompany Facultatif

Opérateur ou compagnie hôtelière

travelData.stayDataList.stayData0.stayLocation Facultatif

Ville de destination

travelData.stayDataList.stayData0.stayNumberOfNights Facultatif

Nombre de nuitées

travelData.stayDataList.stayData0.roomServiceLevel Facultatif

Niveau de service de la chambre

Exemple de travelData sur Paypage POST avec un séjour à Montréal au départ de Paris pour deux voyageurs :

shoppingCartDetail.shoppingCartItemList={travelData.numberOfTravelers=2,travelData.travelStartDateTime=2022-01-01T07:30:00+02:00,travelData.travelEndDateTime=2022-01-05T20:45:00+02:00,travelData.travelingPayerIndicator=true,
travelData.passportDataList={passportExpirationDate=20230401,passportIssueCountry=FRA},{passportExpirationDate=20240607,passportIssueCountry=CAN},
travelData.journeyDataList={departureLocation=CDG,arrivalLocation=YUL,destinationCountry=CAN,numberOfTickets=2,fareBasis=Discount code,carrierIdentifier=AF,classLevel=1,journeyModality=TWOWAY,journeyInsurance=Insurance Plus,journeyCancellableIndicator=true,luggageSupplementIndicator=true},
travelData.stayDataList={stayLocation=Montreal Great Hotel,numberOfNights=4,roomServiceLevel=4,stayCompany=Travel Inc.}}

Le même exemple, sur Paypage JSON :

"shoppingCartDetail": {
    "shoppingCartItemList": [{
        "travelData": {
            "journeyDataList": [{
                "arrivalLocation": "YUL",
                "carrierIdentifier": "AF",
                "classLevel": "1",
                "departureLocation": "CDG",
                "destinationCountry": "CAN",
                "fareBasis": "Discount code",
                "journeyCancellableIndicator": "true",
                "journeyInsurance": "Insurance Plus",
                "journeyModality": "TWOWAY",
                "luggageSupplementIndicator": "true",
                "numberOfTickets": "2"
            }],
            "numberOfTravelers": "2",
            "passportDataList": [{
                "passportExpirationDate": "20230401",
                "passportIssueCountry": "FRA"
            },{
                "passportExpirationDate": "20240607",
                "passportIssueCountry": "CAN"
            }],
            "stayDataList": [{
                "numberOfNights": "4",
                "roomServiceLevel": "4",
                "stayCompany": "Travel Inc.",
                "stayLocation": "Montreal Great Hotel"
            }],
            "travelEndDateTime": "2022-01-05T20:45:00+02:00",
            "travelStartDateTime": "2022-01-01T07:30:00+02:00",
            "travelingPayerIndicator": "true"
        }
    }]
}

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
authorisationId = (voir le Dictionnaire des données).
paymentMeanBrand = BCACB_3X ou BCACB_4X
paymentMeanType = ONLINE_CREDIT
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.

L’acceptation du moyen de paiement Floa Bank 3X et/ou 4X n’est pas disponible au travers de la solution Office (M2M).

Les opérations suivantes sont disponibles sur les transactions Floa Bank 3X et/ou 4X :

Gestion de caisse
Annulation X
Validation V
Validation possible sur le montant total ou partiel de la transaction.
Remboursement V
Remboursement possible sur le montant total ou partiel de la transaction.
Duplication 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é :


Disponibilité des opérations de caisse

En cas de refus, la transaction passe du statut TO_VALIDATE à REFUSED, en cas d'acceptation, le statut devient CAPTURED. Losrque le statut est CAPTURED on peut faire un remboursment total est partiel. En cas de remboursement partiel le statut reste CAPTURED et en cas de remboursement total le statut devient CREDITED.

Les journaux mis à disposition par Mercanet 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.

Attention: le journal des transactions n'est pas un journal comptable. Il contient uniquement les opérations de caisse.

La disponibilité des transactions Floa Bank 3X et/ou 4X 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 Floa Bank 3X, le champ paymentMeanBrand est renseigné avec la valeur BCACB_3X. Pour les transactions Floa Bank 4X, le champ paymentMeanBrand est renseigné avec la valeur BCACB_4X.

Vous pouvez consulter vos transactions Floa Bank 3X et/ou 4X et effectuer différentes opérations de gestion de caisse grâce à Mercanet Back Office.



FLOAPAY met à disposition des données de test pour effectuer vos recettes. Nous vous encourageons à en prendre connaissance et à les utiliser. https://floapay.readme.io/reference/testing-ids/.

Retourner en haut de page Besoin d'aide ?

Besoin d'aide ?

Fermer