La personnalisation de Cette section détaille les fonctionnalités liées à la page de paiement se fait avec l'objet template.

Avec les customfields, le marchand peut utiliser les champs personnalisables pouvant stocker des données supplémentaires ou afficher des informations spécifiques sur une page de paiement.

Axepta BNP Paribas Online: type de page, modes d'intégration, options de personnalisation.

Cette section contient : 

Pages de paiement Axepta BNP Paribas Online

La solution Axepta BNP Paribas Online propose 2 pages de paiement :

Choix de l'expérience de paiement

Le marchand peut choisir entre les 2 expériences de paiement suivantes:

Paramètres dynamiques des pages de paiement

Langues de la page de paiement

La page de paiement est disponible en français, anglais et en néerlandais.

Lors de la première visite, si la langue n'est pas précisée dans l'appel à l'API, alors la langue de la page de paiement correspond à la langue du navigateur.

Dans le cas où la langue du navigateur n'est pas disponible dans la page de paiement, alors la page de paiement est affichée en anglais.

L'utilisateur a la possibilité de changer la langue, une fois arrivé sur la page de paiement grâce à un menu déroulant, en haut à droite de celle-ci. S'il le fait c'est cette langue qui sera affichée par défaut lors de la visite suivante.

Appel API

"language": "fr"

Langues disponibles

Affichage des moyens de paiement sur la page

A chaque page de paiement, un template

Il existe 2 types de pages de paiement AXEPTA qui peuvent être personnalisées à l'aide des customfields.

de choix des moyens de paiement (

Hosted Payment Page)

Par défaut, l'ensemble des moyens de paiement disponibles sur le MerchantID sont affichés sur la page de choix des moyens de paiement. 

Le marchand a la possibilité de restreindre et piloter le ou les moyens de paiement affichés à un client via le paramètre 'allowedPaymentMethods'.

 "allowedPaymentMethods" :  [
      "PAYPAL",
      "WERO",
      "CARD"
    ],

Moyens de paiement disponibles

Affichage des moyens de paiement sur le formulaire de paiement par carte (Payssl)

Par défaut, l'ensemble des moyens de paiement disponibles sur le MerchantID sont affichés sur la page de choix des moyens de paiement. 

Le marchand a la possibilité de restreindre et piloter le ou les cartes affichées à un client via le paramètre 'paymentMethods.card.subType '. 

"paymentMethods": {
        "card" : {
			...
            "subType" : ["CARTESBANCAIRES", "VISA","MASTERCARD", "AMEX"],
			...
        },

Cartes disponibles

Champs personnalisables des pages de paiement

Liste des champs personnalisables (customFields)

Lorsque le marchand décide d’utiliser la page standard de BNP Paribas, il peut insérer son propre logo et personnaliser des champs spécifiques appelés champs dynamiques ou personnalisables (customFields). 

Liste des customFields

Formulaire de choix des moyens de paiement (Hosted Hosted Payment Page) contenant des customFields

 Formulaire de paiement par carte (Payssl) contenant des customFields

Mise en place de l'iframe (customField14)

Affichage de la page

de choix des moyens de paiement (Hosted Payment Page) dans le site marchand (iframe)

Lorsque le paramètre customField14 = "iframe" sur la Page de choix des moyens de paiement (Hosted Payment Page), tous les autres champs personnalisés deviennent invisibles.

...	"template": {
        "customFields": {
            "customField1": "20.00 EURO",
			"customField2": "merchantReference",
            "customField3": "https://placehold.co/200x100/png",
			"customField4": "invoiceId",
            "customField5": "+33600000000|john.doe@bnpparibas.com",
			"customField6": "41 Rue de Valmy|93100 Montreuil",
            "customField7": "41 Rue de Valmy|93100 Montreuil",
			"customField8": "Discount",
            "customField9": "FRI_50|SUM_25",
			"customField14": "iframe"
        }
	},
...

 Page de choix des moyens de paiement (Hosted Payment Page) avec un customField14

Affichage du formulaire de paiement par carte (Payssl) dans le site marchand (iframe)

Lorsque le paramètre customField14 = "iframe", tous les autres champs personnalisés deviennent invisibles, à l'exception du customField1. 

...
"paymentMethods": {
        "type": "CARD",
        "card": {
            "template": {
        		 "customFields": {
           		 	"customField1": "20.00 €",
					"customField2": "merchantReference",
            		"customField3": "https://placehold.co/200x100/png",
					"customField4": "invoice29351925733931",
            		"customField5": "+33600000000|john.doe@bnpparibas.com",
					"customField6": "41 Rue de Valmy|93100 Montreuil",
            		"customField7": "41 Rue de Valmy|93100 Montreuil",
					"customField8": "Discount",
            		"customField9": "FRI_50|SUM_25",
					"customField14": "iframe"
            }
       }
    }
...

Formulaire de paiement par carte (Payssl) avec un customField14

Autres paramètres dynamiques (langue, choix des moyens de paiement)

D’autres paramètres sont mis à la disposition du commerçant et peuvent être transmis non chiffrés :

Language

a2 Enum

O

Code pour la langue de la page de paiement du commerçant :

• en : English
• fr : Français
• nl : Nederlands

Si non mentionné, la langue par défaut est le français. 

Si l'utilisateur change de langue à partir du sélecteur de langue, c'est celle choisie qui sera affichée lors de la visite suivante.

allowedPaymentMethods

Enum

O

Ce paramètre permet d'indiquer les moyens de paiement à afficher sur la page de choix des moyens de paiement.

Si ce paramètre n'est pas utilisé, la configuration par défaut du niveau du commerçant est utilisée pour afficher les moyens de paiement autorisés.

Les valeurs possibles peuvent être prises dans la colonne allowedPaymentMethods  du tableau des modes de paiement (Voir la section Définitions des valeurs des paramètres en bas de la page).

subType

Enum

O

Ce paramètre, découlant des objets paymentMethods.​card permet d'indiquer le type de marque de carte à afficher sur le formulaire de paiement par carte.

Definition des valeurs des paramètres

Paramètre « allowedPaymentMethods»

Veuillez trouver ci-dessous les différents moyens de paiement disponibles et les valeurs à renseigner dans le paramètre « allowedPaymentMethods »

Moyen de paiement

Valeur du paramètre « allowedPaymentMethods » lors de l'appel à l'API /payments/sessions uniquement 

Carte

*Voir la liste des marques de cartes ci-dessous

CARD

WERO

WERO

APPLEPAY

APPLEPAY

BANCONTACT

BANCONTACT

INSTANEA

INSTANEA

Paramètre «subType»

Marques de cartes à indiquer dans les objets paymentMethods.​card

Ce tableau liste l'orthographe exacte des différentes marques de cartes à indiquer dans le paramètre subType des objets paymentMethods.​card.

Carte CB

CARTESBANCAIRES

UnionPay International (UPI)

CUP

Diners

DINERS

Discover

DISCOVER

JCB

JCB

Carte MasterCard

MasterCard

Carte VISA

VISA