Version Française
Prérequis
- Proximis version 4.19 ou supérieur.
- Php version 7.4 ou supérieur.
Installation
Enregistrer le plugin. php
| Code Block |
|---|
php bin/change.phar change:register-plugin --type=module --vendor=Project |
...
Axepta |
Installer le plugin. php
| Code Block |
|---|
php bin/change.phar change:install-plugin --type=module --vendor=Project Axepta |
Dans la configuration de votre du projet, activez activer 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 |
...
} |
...
}, |
Configuration
Créer le connecteur depuis l'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.
Onglet propriétés techniques. :
Sélectionner le type de connecteur : Connecteur de paiement Axepta
Des information sur l'environnement actuel sont affichées. Attention à , utiliser les clés de configuration correspondantes.
- Clés de configuration Ces informations sont fournies par BNP Paribas.
- Options du connecteur Sélectionnez les options pour ce connecteur.
- Devises Sélectionnez les devises autorisées pour ce connecteur.
- Modes Méthodes de paiement Sélectionnez les modes méthodes de paiements autorisés autorisées pour ce connecteur.
Pour avoir ce mode de paiement disponible dans le processus de commande, il faut l'ajouter ./admin.php/Rbs/Commerce/Process/
Vous pouvez créer plusieurs connecteurs avec des configurations différentes. Il est possible, par exemple, d'avoir un connecteur dédié à un mode moyen de paiement.
Documentation Développeur.
Ajout d'un nouveau mode moyen de paiement.
La documentation des moyens de paiements alternatifs est disponible sur la page suivante.
{+}https://docs.axepta.bnpparibas/pages/viewpage.action?pageId=6914326+
Vous pouvez prendre exemple sur les moyens de paiements déjà implémentés.
...
- 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
...
moyen de paiement, il faudra les ajouter à $paymentRequest. (ex
...
$paymentRequest→setAccOwner($accountOwner); )
...
2. Ajouter le trigramme du mode de paiement dans showPaymentModes() dans le fichier App/Modules/Project/Axepta/Assets/Admin/directives.js
3. Ajouter le trigramme du 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
4. Ajouter le logo du 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
Modification du template front.
Vous pouvez modifier le fichier .twig App/Modules/Project/Axepta/Assets/Theme/ng-template/project-axepta-payment.twig pour retirer le style 'inline' et déclarer vos propres règles CSS.
Gestion des traductions.
Le module comprend la locale fr_FR. Il est possible de créer des nouveaux dossier pour d'autres locales. Prenez exemple sur les fichiers présent dans le dossier App/Modules/Project/Axepta/Assets/I18n
Vous pouvez à tout moment modifier les chaines de caractères traduites depuis l'interface de traduction.ua.php/lmsManager/Plugin/m.project.axepta
