Contexte

Un commerçant à la possibilité de modifier le template générique Axepta afin de le dynamiser avec des éléments graphique ou du texte.

Une fois le template dynamisé, il est nécessaire de modifier le MerchandID du template afin que le commerçant puisse l'uploader sur son espace Axepta.

A chaque page de paiement, un template

Il existe 2 types de pages de paiement AXEPTA :

Nom

Endpoint

Endpoints	Rendu	Templates Standard AXEPTA	Templates Personnalisés Marchands (Ex : BNP_DEMO_AXEPTA)
Formulaire de choix des moyens de paiement	paymentpage.aspx	Image Modified	PaymentPageLogos_BNP_v1	To add
		Image Added	PaymentPageDropDown_BNP_v1

Image Removed

	To add
Formulaire de paiement par carte	payssl.aspx	Image Modified	Cards_BNP_V1

To add

Templates (archives) à destination des marchands

Les Templates suivants peuvent être téléchargés et serviront de base de personnalisation pour les marchands.

XXXXXXXXX

Contenu de l'archive Template

Composition à la racine

L'organisation et le nommage des fichiers sont identiques pour PaymentPage et PaySSL.

A la racine du template, nous avons trois éléments :

• Un fichier XML : BNP_TEST_TEMPLATE_ECOM_CardsV1_PaySSL
• Un fichier XSL : BNP_TEST_TEMPLATE_ECOM_CardsV1_PaySSL
• Un dossier : images_CardsV1_BNP_TEST_TEMPLATE_ECOM

Composition du dossier Images

Image Added

Illustration :

Image Removed

• css : Contient le fichier CSS du projet

• data : celui-ci contient les fichiers :

  • Fichier coBadgedCards.json : contient des informations pour le bon fonctionnement du formulaire de paiement par carte.

  • Fichier : translations.json : Contient l'ensemble des traductions

• fonts : Contient les fichiers de police d'écriture

• images : Contient les images

• js : Contient les fichiers JS

Illustration :

Image Removed

Mettre à jour

le MerchandID (MID)

Afin de modifier le  MerchandID  et le  TemplateName, il est nécessaire de renommer les fichiers / dossiers tel que suit :

• XML 

  XML : {MerchantID}_{TemplateName}_{TemplateType}

• XLS 

  XLS : {MerchantID}_{TemplateName}_{TemplateType}

• Image 

  Image : images_{TemplateName}_{MerchantID}

Une fois les noms de fichiers modifiés, il est nécessaire de modifier les liens faisant appel à ces fichiers.

Ils sont présents dans les fichiers :

• XML

• XLS

• Image/js/main.js

La méthode la plus simple afin de mettre à jour les chemins présents dans ces fichiers est de faire un chercher/remplacer dans un éditeur de texte.

Créer une archive du template

Afin de pouvoir procéder à l'upload du template via le Template Manager, il est nécessaire de créer une archive contenant les trois éléments (XML, XLS et dossier image) à la racine.

Attention, il faut archiver les trois éléments en les sélectionnant au moment de créer l'archive et  non  archiver le dossier parent.

Cette archive doit être nommée comme suit : TemplateYYYYMMDD001MerchandID :

• Template : Permet d'indiquer qu'il s'agit d'un template

• YYYYMMDD : La date du jour de l'upload

• 001 : Le numéro de version. Celui-ci doit être incrémenté à chaque nouvel upload pour jour donné

• MerchandID : L'identifiant du commerçant.

Exemple : Template20220624003BNP_DEMO_AXEPTA.zip

Tester le template

Une fois l'archive créée, le marchand peut tester l'affichage du Template :

• Upload de l'archive Template dans le Template Manager du Back-Office Axepta - cf. XXXXX
• Appel du Template dans les requêtes de paiement via paymentpage.aspx ou payssl.aspx
  • Utilisation du paramètre Template : Template={MerchantID}_{TemplateName}

Synthèse : Étapes de personnalisation

La personnalisation s'effectue en plusieurs étapes :

• Création des fichiers complémentaires de personnalisation :
  • Design & Fonctionnalités : CSS & javascript
  • Images, Polices...
• Ajout des fichiers au répertoire 'images'
• Ajout des références (chemins) dans le fichier XML présent dans le dossier du Template
• Mise à jour du MID et du nom du template qui sera utilisé lors de l'appel à la page de paiement
• Création de l'archive du Template