Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Prérequis

  • Proximis version 45.19 0 ou supérieursupérieure.
  • Php version 7.4 ou supérieursupérieure.

Installation

Le module est désormais sur un repository composer third-party Plugin.

Si vous avez installé le module via une archive zip, vous devez le désinstaller :Enregistrer le plugin. 

Code Block
php bin/change.phar changeproximis:register-plugin --type=module --vendor=Project Axepta plugins -v disable module_Project_Axepta


Ajouter le repository third-party Clever Age en ajoutant cette partie dans votre composer.json

Code Block
{          
	"type": "composer",          
	"url": "https://nexus-production.tools-services-1.omn.proximis.com/repository/cleverage-axepta/"        
}


Déclarer le module dans le require du composer.json

Code Block
{
"require": {        
"cleverage/axepta": "^1"    
}
}

Et lancez votre update.bash script.

Installer le plugin. 

Code Block
php bin/change.phar changeproximis:install-pluginplugins --type=module --vendor=Project v enable CleverAge_Axepta

Dans la configuration du de votre projet, activer activez les logs par service pour pouvoir avoir les logs spécifiques au module dans : log log/proximis.axepta.log

Code Block
"Logger": {      
	"Writer": {        
		"fileByService": true      true
	}    
},

Configuration

Créer le connecteur depuis l'interface d'administrationl’interface d’administration/admin.php/Rbs/Commerce/Connector/

Onglet propriétés générales :.

Le champ titre sur le site sera visible par le client, le libellé seulement dans

...

l’interface d’administration.

Le champ code permet

...

d’identifier le connecteur dans le code.

Le champ description peut contenir du texte formaté, des images et des liens.

Le champ visuel permet

...

d’afficher une image à coté du titre sur le site.

Le champ critère

...

d’application permet de définir des règles pour conditionner

...

l’affichage du connecteur.

Le champ instruction de paiement peut contenir du texte formaté, des images et des liens.

  Image RemovedImage Added


Onglet propriétés techniques :.

Sélectionner le type de connecteur : Connecteur  Connecteur de paiement Axepta 

...

Image Added


Des information informations sur l'environnement l’environnement actuel sont affichées. Attention , à utiliser les clés de configuration correspondantes.

...

Image Added

  • Clés de configuration  Ces Ces informations sont fournies par BNP Paribas.

Image RemovedImage Added


  • Options du connecteur  Sélectionnez Sélectionnez les options pour ce connecteur.

Image Removed

Image Added


  • Template personnalisé

Image Added


Permet d’utiliser l’option Page personnalisée d’Axepta, voir : https://docs.axepta.bnpparibas/pages/viewpage.action?pageId=6914816#Pagedepaiement-Pagedepaiementducommer%C3%A7ant

Les paramètres “Template”, “CCTemplate” et SDDTemplate” sont utilisables.

  • DevisesSélectionnez Devises Sélectionnez les devises autorisées pour ce connecteur.
  • Méthodes Modes de paiement Sélectionnez Sélectionnez les méthodes modes de paiements autorisées autorisés pour ce connecteur.

Pour avoir ce mode de paiement disponible dans le processus de commande, il faut l'ajouter .l’ajouter.

Code Block
/admin.php/Rbs/Commerce/Process/


 Image RemovedImage Added


Vous pouvez créer plusieurs connecteurs avec des configurations différentes. Il est possible , par exemple , d'avoir d’avoir un connecteur dédié à un moyen mode de paiement.


Suivi des transactions

Depuis l’url admin.php/Rbs/Order/Transaction/ sélectionnez une transaction pour voir les détails details techniques.

Image RemovedImage Added


Gestion des remboursements

...

Quand une commande est annulée, elle est éligible à un remboursement.

Depuis l’url ua.php/financial/ dans le détail d’un remboursement, sélectionner l’action ‘traiter’ puis confirmer.


Image RemovedImage Added


La demande est envoyée à AXEPTA Axepta et le résultat de l’opération se retrouve dans la partie chronologie.


Dans le cas d’une erreur, le message sera affiché.

Image RemovedImage Added


Si le remboursement est bien validé, vous pouvez valider le remboursement en sélectionnant ‘traitement manuel’

Image RemovedImage Added

Modification du template front

Vous pouvez modifier le fichier .twig

Code Block
 App/Modules/Project/Axepta/Assets/Theme/ng-template/project-axepta-payment.twig

pour retirer le style 'inline' ‘inline’ et déclarer vos propres règles CSS. 


Image Added

Image Removed



Gestion des traductions.

Le module comprend la langue locale fr_FR. Il est possible de créer de des nouveaux dossiers pour d'autres languesd’autres locales. Prenez exemple sur les fichiers présents présent dans le dossier


Code Block
App/Modules/Project/Axepta/Assets/I18n


Vous pouvez à tout moment modifier les chaines de caractères traduites depuis l'interface de l’interface de

Code Block
traduction.ua.php/lmsManager/Plugin/m.project.axepta

...



Moyens de paiement disponibles via le module

...

Documentation Développeur : Si ajout d'un nouveau moyen de paiement qui n'est pas disponible via ce module


Ajout d’un nouveau mode de paiement.

La documentation des moyens de paiements alternatifs est disponible sur la page suivante .

https://docs.axepta.bnpparibas/pages/viewpage.action?pageId=6914326+Image Removed

Vous pouvez prendre exemple sur les moyens de paiements déjà implémentés.

  1. Ajouter une nouvelle classe pour chaque moyen de paiement que vous voulez ajouter dans App/Modules/Project/Axepta/PaymentModes.

Cette classe doit étendre PaymentModeBase et déclarer la méthode buildDeportedPageQuery.

Code Block
public static function buildDeportedPageQuery(\Rbs\Payment\Documents\Transaction $transaction, $connectorId, \Rbs\Website\Documents\Website $website, \Project\Axepta\Events\Documents\AxeptaEngine $engine): string {
    $paymentRequest = parent::prepareDefaultPaymentRequest($transaction, $connectorId, $website, $engine);     
// PAYMENT_URL is specific to the payment mode and available in the documentation.    
$paymentRequest->setUrl(self::PAYMENT_URL);     
return parent::validateAndBuildQueryString($paymentRequest, $engine, $transaction, $website);  
}

En fonction des paramètres requis par le

...

mode de paiement, il faudra les ajouter à $paymentRequest. (ex

...

$paymentRequest->setAccOwner($accountOwner);)

...

  1. Ajouter le trigramme du

...

  1. mode de paiement dans showPaymentModes() dans le fichier App/Modules/Project/Axepta/Assets/Admin/directives.js

...

  1. Ajouter le trigramme du

...

  1. mode de paiement dans getEnabledPaymentModes() dans le fichierApp/Modules/Project/Axepta/Events/Documents/AxeptaEngine.php

et dans getDeportedPageQuery() dans le fichier App/Modules/Project/Axepta/Http/Ajax/DeportedPageQuery.php

...

  1. Ajouter le logo du

...

  1. mode de paiement dans le dossier App/Modules/Project/Axepta/Assets/Theme/img/logos

Le logo doit être nommé selon le trigramme et

...

l’extension doit être .png