Sommaire

Contexte

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

Il existe 2 types de pages de paiement AXEPTA

Nom	Endpoints	Rendu	Templates Standard AXEPTA	Templates Personnalisés Marchands (Ex : BNP_DEMO_AXEPTA)
Formulaire de choix des moyens de paiement	paymentpage.aspx		PaymentPageLogos_BNP_v1	BNP_DEMO_AXEPTA_SelectionV1_PaymentPage
			PaymentPageDropDown_BNP_v1	BNP_DEMO_AXEPTA_DropdownV1_PaymentPage
Formulaire de paiement par carte	payssl.aspx		Cards_BNP_V1	BNP_DEMO_AXEPTA_CardsV1_PaySSL

Templates (archives) à destination des marchands

Les Templates peuvent être récupérés via une demande au support.

Contenu de l'archive Template

Composition à la racine

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

Composition du dossier Images

• 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)

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 : {MerchantID}_{TemplateName + version}_{TemplateType}

• 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.

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

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
• Tester le Template
• Utiliser le Template dans les requêtes de paiement

FAQ