Summary

Context

AXEPTA met à disposition des marchands les Templates des pages de paiement. Ceux-ci peuvent être personnalisés via l'ajout d'éléments graphiques ou de textes.

Une fois le Template personnalisé créé, il doit être uploadé via le Back-Office dans l'onglet Template Manager.

A l'issue de cette étape, le marchand peut préciser, dans la requête de paiement (Paramètre "Template'), le Template personnalisé qu'il souhaite afficher à son client.

A chaque page de paiement, un template

provides merchants with the payment templates pages . These can be customized by adding graphic elements or texts.

Once the custom Template is created, it must be uploaded via the Back-Office in the Template Manager tab.

At the end of this step, the merchant can specify, in the payment request ("Template" parameter), the custom Template he wants to display.

On each payment page, a template

There are 2 types of AXEPTA payment pages

Il existe 2 types de pages de paiement AXEPTA

NomEndpointsRenduTemplates Standard AXEPTATemplates Personnalisés Marchands (Ex :

BNP_DEMO_AXEPTA)

Formulaire de choix des moyens de paiement

Form for choosing payment methods

paymentpage.aspx

Image Modified

PaymentPageLogos_BNP_v1

A venir

BNP_DEMO_AXEPTA_SelectionV1_PaymentPage
Image Modified	PaymentPageDropDown_BNP_v1

A venir
Formulaire de paiement par carte

	BNP_DEMO_AXEPTA_DropdownV1_PaymentPage
Card payment form	payssl.aspx	Image Modified	Cards_BNP_V1

A venir

BNP_DEMO_AXEPTA_CardsV1_PaySSL

Templates for merchants (

archive)

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

A venir

Contenu de l'archive Template

Composition à la racine

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

The download link can be provided by the support (on demand).

Contents Template archive

Composition from the beginning

File organization and naming are the same for PaymentPage and PaySSL.

Composing the Pictures folder

• 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

Mettre à jour le MerchandID (MID)

The image folder must contain the following directories & files:

• css: Contains the project's CSS file
• data: this contains the files:
• coBadgedCards.json file: contains information for the proper functioning of the card payment form.
• File: translations.json: Contains all translations
• fonts: Contains font files
• images: Contains images
• js: Contains JS files

Update MerchandID (MID)

In order to modify the MerchandID and TemplateName, it is necessary to rename the files/folders as follows:

• XML 

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

• XML : {MerchantID}_{TemplateName + version}_{TemplateType}
• XLS XLS : {MerchantID}_{TemplateName + version}_{TemplateType}
• Image Image : images_{TemplateName + version}_{MerchantID}

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

Once the file names have been changed, it is necessary to modify the links using these files.

They are present in the files 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 texteThe easiest way to update the paths present in these files is to search/replace in a text editor.

Créer une archive du Template

Create a Template Archive

In order to upload the template via Template Manager, you need to create an archive containing this three elements 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 and image ) à la racinefolder) at the root.Attention, il faut archiver les trois éléments en les sélectionnant au moment de créer l'archive et  nonarchiver le dossier parent.

Be careful, you must archive the three elements by selecting them when creating the archive and not the parent folder archive.

This archive should be named as followsCette archive doit être nommée comme suit : TemplateYYYYMMDD001MerchandID:

• Template: Permet d'indiquer qu'il s'agit d'un Allows you to indicate that it is a template

• YYYYMMDD: La date du jour de l'The date of the day of upload

• 001: Le numéro de The version . Celui-ci doit être incrémenté à chaque nouvel upload pour jour donnénumber. This must be incremented with each new upload for a given day

• MerchandID: L'identifiant du commerçantThe merchant's ID.

Exemple : Template20220624003BNP_DEMO_AXEPTA.zip

Testing template

Once the archive is created, the merchant can test the template display.

• Upload of the Template archive in the Template Manager of the Axepta Back-Office

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. Template Manager.
• Appel du Template dans les requêtes de paiement Calling the Template in payment requests via paymentpage.aspx ou or payssl.aspx
  • Utilisation du paramètre Using the Template parameter:  Template = {MerchantID}_{TemplateName + version}

Synthèse : Étapes de personnalisation

Customization steps

Customization is done by several steps:

• customize  add-on files

La personnalisation s'effectue en plusieurs étapes :

• :
  • Design &

• • Features: CSS & javascript
  • Images,

• • fonts...

• Adding files to the 'images' directory

FAQ

• Adding references (paths) to the XML file in the Template folder
• Update of the MID and the name of the template that will be used when calling the payment page
• Creating the Template archive
• Test the Template
• Use the Template in payment requests

Questions