Versions Compared

Key

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

...

Info

Dernière version du connecteur : 1.711.0

#### V1.711.0- Créer une nouvelle transaction lors de la réception d’un IPN réussi pour une transaction déjà échouée
- Vérifier la non-concordance des PayId avant d’envoyer un avis de paiement en double

#### V1.6.0
- Ajouter EtiId sur les enquêtes/reverse/credit operations
- Ajouter une alerte par courriel
- Ajout d’une fonction de capture manuelle
- Mettre à jour l’exigence php de 7.4 à >7.4 pour permettre la compatibilité V6

Couverture fonctionnelle

  • Paiement par carte avec 3DSV2

  • Paiement alternatifs (FLOA, ALI, WEC,UPI, BAN, PAL, APP)
  • Choix d’intégration en page déportée ou via une iframe
  • Gestion des remboursements
  • Personnalisation via template
  • Personnalisation via champs ‘custom’

Prérequis

  • Proximis version 6.0 ou supérieure.
  • PHP version 8.1 ou supérieure.

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 : php bin/change.phar proximis:plugins -v disable module_Project_Axepta

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

Couverture fonctionnelle

  • Paiement par carte avec 3DSV2

  • Paiement alternatifs (FLOA, ALI, WEC,UPI, BAN, PAL, APP)
  • Choix d’intégration en page déportée ou via une iframe
  • Gestion des remboursements
  • Personnalisation via template
  • Personnalisation via champs ‘custom’

Prérequis

  • Proximis version 6.0 ou supérieure.
  • PHP version 8.1 ou supérieure.

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 : php bin/change.phar proximis: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": 
Code Block
        {
          "typecleverage/axepta": "composer^1",
          "url": "https://nexus-production.tools-services-1.omn.proximis.com/repository/cleverage-axepta/"}
}


Et lancez votre script update.bash.

Installer le plugin. php bin/change.phar proximis:plugins -v enable CleverAge_Axepta

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


Code Block
"Logger": {
        }

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

Code Block
{
"require"Writer": {
        "cleverage/axeptafileByService": "^1"true
      }
    }

Et lancez votre script update.bash.

...

,

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 :

Code Block
php bin/change.phar proximis:plugins -v

...

 disable module_Project_Axepta

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

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

Installation

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


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. Si vous avez installé le module via une archive zip, vous devez le désinstaller :

Code Block
php bin/change.phar proximis:plugins -v disableenable module_ProjectCleverAge_Axepta

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

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

Code Block
"Logger": {     
Code Block
{          
	"typeWriter": "composer",         {        
		"urlfileByService": "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 proximis:plugins -v enable CleverAge_Axepta

Dans la configuration de votre projet, activez les logs par service pour pouvoir avoir les logs spécifiques au module dans  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.

Image Removed

Onglet propriétés techniques.

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

  • Template personnalisé

Image Removed

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 les devises autorisées pour ce connecteur.
  • Modes de paiementSélectionnez les modes de paiements autorisés pour ce connecteur.

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

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

Image Removed

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

Suivi des transactions

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

Image Removed

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 Removed

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

...

Image Removed

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

Image Removed

Documentation Développeur

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

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 mode de paiement dans showPaymentModes() dans le fichier App/Modules/Project/Axepta/Assets/Admin/directives.js
  2. 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

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

Ajout du moyen de paiement FLOA Pay

  • Ajout du connecteur

Pour mettre à disposition les moyens de paiement FLOA (Paiement différé/ 3X/ 4X) à vos clients, il faut configurer un nouveau connecteur depuis votre BO à l’adresse /admin.php/Rbs/Commerce/Connector/ et l’ajouter au moyens de paiements disponible dans votre processus de paiement.

Dans la partie clé d’activation utilisez la clé suivante :

...

FLO;EUR;

hkZCG0Jgh+faBBsTCMpG2O4eq3IGuBI7JwsKSxnYbjcmFw0fvS5LQTxyobBXwB3JZJ3rHLCy

8N9p8Ne

/nZwLju8qUE1xkbSXPw6rpYRjmFxsT8sDyMgexiaw7GUK05tK886562Ph4neoZ9kppgbZu8n

6ia5E3509vLKaHkovoqY=

  • Configuration du connecteur

Voici un exemple de configuration avec les valeurs de tests fournies par Floa. https://floapay.readme.io/reference/testing-ids

Image Removed

  • Affichage du connecteur avec les modes compatibles

Une fois configuré le connecteur s’affichera avec les autres. Les boutons FLOA s’afficheront en fonction des seuils min/max configurés.

Image Removed

(info)  Au clic sur un logo Floa, l'utilisateur est redirigé sur une page déportée. Renseigner les informations pour un résultat d'éligibilité (page de fichage) puis dans la seconde étape, les informations de carte n(page de paiement)

  • Page de fichage

Image Removed

  • Page de paiement

Des cartes de tests sont disponibles à cette adresse : https://floapay.readme.io/reference/test-card-numbers

Image Removed

Ajout du moyen de paiement Apple Pay

Configuration Apple Pay

Apple Pay n’est pas supporté par tous les appareils et navigateurs, la liste des supports est disponible ici https://developer.apple.com/documentation/apple_pay_on_the_web/#2978468 ((utilisation de Apple Pay JS). 

Voici ce qui est implémenté pour le connecteur Axepta BNP Paribas- Proximis :

...

Appareil

...

version minimale

...

Navigateurs

...

Configuration du connecteur

Pour intégrer Apple Pay, deux certificats sont nécessaires, le certificat d'identification marchand et le certificat de traitement des paiements.

Côté Apple Pay

Certificat Identifiant marchand

Créez un identifiant marchand Apple Pay en suivant la documentation Apple : https://developer.apple.com/help/account/configure-app-capabilities/configure-apple-pay-on-the-web

Certificat de traitement des paiements

Info

Le support Axepta BNP Paribas démarre la configuration et envoie la CSR (Certificate Signing Request) par mail au contact technique identifié lors de la phase d’intégration. Il est ainsi demandé le Apple developper Merchant Id du client, qui doit être fourni à son chargé d'affaires.

  • Le support Axepta BNP Paribas génère un .csr pour le marchand 
  • A l'aide de ce .csr, générer le fichier apple-developer-merchantid-domain-association.txt ce qui permettra d'identifier le marchand sur le site
  • Transmettez à votre intégrateur le fichier apple-developer-merchantid-domain-association.txt obtenu lors de la génération de votre identifiant marchand afin qu’il le dépose dans le répertoire App/Config/.well-known . Ceci permettra lors de votre prochain déploiement de placer ce fichier à la racine de votre site afin de le faire vérifier par Apple.

 

Certificat d’identification marchand

Warning

Ce certificat est différent des fichiers obtenus lors de l'étape précédente. Pour le second certificat, il ne faut pas reprendre le .csr généré par le support Axepta BNP Paribas, mais en créer un nouveau depuis un MAC, comme indiqué dans la documentation Apple cité précédemment.

  • Générez sur un Mac un fichier .csr
  • Depuis votre compte Apple Développeur Admin générez un certificat .cer à partir du fichier précédent .csr .
  • Récupérez ce certificat .cer sur le Mac et le regrouper avec la clé du fichier .csr dans votre trousseau d’accès.
  • A partir de ce regroupement dans votre trousseau d’accès créez un fichier .p12
  • Utilisez ensuite ce fichier .p12 afin de générer un fichier certificat ApplePay.crt.pem et un second fichier pour la clé associée ApplePay.key.pem (la nomenclature des fichiers doit être respectée).
    • Ouvrez le terminal et exécutez les commandes ci-dessous pour diviser le. p12 en clef et certificat, où ApplePayMerchantID_and_privatekey.p12 est le nom de votre fichier . p12 :
Code Block
openssl pkcs12 -in ApplePayMerchantID_and_privatekey.p12 -out ApplePay.crt.pem -clcerts -nokeys
Code Block
openssl pkcs12 -in ApplePayMerchantIdentity_and_privatekey.p12 -out ApplePay.key.pem -nocerts
  • Déposez ces deux fichiers .pem dans le répertoire App/Config/ApplePay de votre projet.

 Nous recommandons l'utilisation d'une passphrase lors de la génération du couple de fichiers .pem, elle sera à renseigner dans la configuration du connecteur dans le Back-Office Proximis.

Warning

Assurez-vous d’avoir donné les droits d’accès de lecture de ces fichiers au serveur en modifiant leurs permissions

Côté Proximis

Connecteur de paiement

Pour permettre à vos clients de payer via Apple Pay il faut activer le mode de paiement dans la configuration du connecteur dans Proximis : 

Image Removed

Vous pouvez ensuite indiquer les différents paramètres associés à Apple Pay : 

Image Removed

...

Code pays du marchand sous format ISO 3166 (ex:

FR).

Ce code est utiliser pour ouvrir la session de

paiement.

Documentation Apple associée https://developer.apple.com/documentation/apple_pay_on_the_web/applepaypaymentrequest/1916117-countrycode

...

Label affichée dans la feuille de paiement Apple Pay

afin de décrire le paiement de l’utilisateur.

Documentation Apple associée https://developer.apple.com/documentation/apple_pay_on_the_web/applepaypaymentrequest/1916117-countrycode

 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.

Image Added


Onglet propriétés techniques.

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

Image Added


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

Image Added

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

Image Added


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

Image Added


Oneclick

L’option OneClick permet à l’utilisateur d’enregistrer sa carte de paiement sur le site et de la réutiliser pour de futurs paiements sans avoir à renseigner de nouveau ses données.


Info
titleImportant

Les cartes peuvent être enregistrées sur un connecteur utilisant un MID de test mais elles ne peuvent pas par la suite être utilisée pour régler un paiement.

Il faudra obligatoirement passer par un MID de production pour tester cette fonctionnalité.


Capture Manuelle

L’option capture manuelle permet de réaliser des opérations d’autorisation pour valider la commande, la capture (totale, ou partielle) des fonds sera réalisée au moment ou les produits de la commande seront préparés.


Option du connecteur, activation de la capture manuelleImage Added


Warning

Attention : La capture d’une transaction au delà du 7e jour engendre la perte de garantie associée au 3DSecure - le cas échéant, et au delà du 29e jour l’autorisation accordée par l’émetteur ne sera plus valable. Il est donc préférable de capturer les transactions avant ces échéances.

Warning

Dans le cas ou la capture échoue, un email sera envoyé avec les informations techniques du retour d’Axepta si le champ email à notifier est renseigné.

Il faudra s’assurer que l’email envoyé est bien réglé au niveau de la notification:

Connecteur Axepta/Proximis: Echec de capture manuelle


Dans les informations techniques de la transaction, vous pourrez retrouver un nouveau champ captureMode qui donnera l’information du mode utilisé.

Dans le cas d’une capture manuelle, une nouvelle entrée sera alimentée avec les informations de retour de demande de capture dans l’entrée __captures


Notifications


Notification de paiementImage Added

Les notifications de paiement sont envoyées à l’utilisateur.

Les notifications en cas d’appels multiples pour une même transaction sont envoyées aux emails à notifier.

Il faudra s’assurer que l’email envoyé est bien réglé au niveau de la notification: Connecteur Axepta/Proximis: Notification en doublon.


Image Added


Image Added


Warning

Les emails de rapport contiennent des informations techniques, comme le merchantId la référence de paiement etc.. soyez sûr des emails à notifier.


  • Template personnalisé

Image Added


Permet d’utiliser l’option Page personnalisée d’Axepta, voir : Mise en place d'un Template Personnalisé

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

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

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

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


Image Added


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


Suivi des transactions

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

Image 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 Added


La demande est envoyée à 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 Added


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

Image Added

Documentation Développeur


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

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

  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


Ajout du moyen de paiement FLOA Pay

  • Ajout du connecteur spécifique

Pour mettre à disposition les moyens de paiement FLOA (Paiement différé/ 3X/ 4X) à vos clients, il faut configurer un nouveau connecteur depuis votre BO à l’adresse /admin.php/Rbs/Commerce/Connector/ et l’ajouter au moyens de paiements disponible dans votre processus de paiement.

Dans la partie clé d’activation utilisez la clé suivante :

FLO;EUR;

hkZCG0Jgh+faBBsTCMpG2O4eq3IGuBI7JwsKSxnYbjcmFw0fvS5LQTxyobBXwB3JZJ3rHLCy

8N9p8Ne

/nZwLju8qUE1xkbSXPw6rpYRjmFxsT8sDyMgexiaw7GUK05tK886562Ph4neoZ9kppgbZu8n

6ia5E3509vLKaHkovoqY=

  • Configuration du connecteur

Voici un exemple de configuration avec les valeurs de tests fournies par Floa. https://floapay.readme.io/reference/testing-ids

Image Added















  • Affichage du connecteur avec les modes compatibles

Une fois configuré le connecteur s’affichera avec les autres. Les boutons FLOA s’afficheront en fonction des seuils min/max configurés.

Image Added

(info)  Au clic sur un logo Floa, l'utilisateur est redirigé sur une page déportée. Renseigner les informations pour un résultat d'éligibilité (page de fichage) puis dans la seconde étape, les informations de carte n(page de paiement)

  • Formulaire d'éligibilité

Image Added

  • Page de paiement

Des cartes de tests sont disponibles à cette adresse : https://floapay.readme.io/reference/test-card-numbers

Image Added


Ajout du moyen de paiement Apple Pay

Configuration Apple Pay

Apple Pay n’est pas supporté par tous les appareils et navigateurs, la liste des supports est disponible ici https://developer.apple.com/documentation/apple_pay_on_the_web/#2978468 ((utilisation de Apple Pay JS). 

Voici ce qui est implémenté pour le connecteur Axepta BNP Paribas- Proximis :

Appareil

version minimale

Navigateurs

iPhone iOS 10Tous
MacmacOS 10.12 Tous
Configuration du connecteur

Pour intégrer Apple Pay, deux certificats sont nécessaires, le certificat d'identification marchand et le certificat de traitement des paiements.

Côté Apple Pay

Certificat Identifiant marchand

Créez un identifiant marchand Apple Pay en suivant la documentation Apple : https://developer.apple.com/help/account/configure-app-capabilities/configure-apple-pay-on-the-web


Certificat de traitement des paiements

Info

Le support Axepta BNP Paribas démarre la configuration et envoie la CSR (Certificate Signing Request) par mail au contact technique identifié lors de la phase d’intégration. Il est ainsi demandé le Apple developper Merchant Id du client, qui doit être fourni à son chargé d'affaires.

  • Le support Axepta BNP Paribas génère un .csr pour le marchand 
  • A l'aide de ce .csr, générer le fichier apple-developer-merchantid-domain-association.txt ce qui permettra d'identifier le marchand sur le site
  • Transmettez à votre intégrateur le fichier apple-developer-merchantid-domain-association.txt obtenu lors de la génération de votre identifiant marchand afin qu’il le dépose dans le répertoire App/Config/.well-known . Ceci permettra lors de votre prochain déploiement de placer ce fichier à la racine de votre site afin de le faire vérifier par Apple.


 

Certificat d’identification marchand

Warning

Ce certificat est différent des fichiers obtenus lors de l'étape précédente. Pour le second certificat, il ne faut pas reprendre le .csr généré par le support Axepta BNP Paribas, mais en créer un nouveau depuis un MAC, comme indiqué dans la documentation Apple cité précédemment.

  • Générez sur un Mac un fichier .csr
  • Depuis votre compte Apple Développeur Admin générez un certificat .cer à partir du fichier précédent .csr .
  • Récupérez ce certificat .cer sur le Mac et le regrouper avec la clé du fichier .csr dans votre trousseau d’accès.
  • A partir de ce regroupement dans votre trousseau d’accès créez un fichier .p12
  • Utilisez ensuite ce fichier .p12 afin de générer un fichier certificat ApplePay.crt.pem et un second fichier pour la clé associée ApplePay.key.pem (la nomenclature des fichiers doit être respectée).
    • Ouvrez le terminal et exécutez les commandes ci-dessous pour diviser le. p12 en clef et certificat, où ApplePayMerchantID_and_privatekey.p12 est le nom de votre fichier . p12 :
Code Block
openssl pkcs12 -in ApplePayMerchantID_and_privatekey.p12 -out ApplePay.crt.pem -clcerts -nokeys
Code Block
openssl pkcs12 -in ApplePayMerchantIdentity_and_privatekey.p12 -out ApplePay.key.pem -nocerts
  • Déposez ces deux fichiers .pem dans le répertoire App/Config/ApplePay de votre projet.

 Nous recommandons l'utilisation d'une passphrase lors de la génération du couple de fichiers .pem, elle sera à renseigner dans la configuration du connecteur dans le Back-Office Proximis.

Warning

Assurez-vous d’avoir donné les droits d’accès de lecture de ces fichiers au serveur en modifiant leurs permissions


Côté Proximis

Connecteur de paiement

Pour permettre à vos clients de payer via Apple Pay il faut activer le mode de paiement dans la configuration du connecteur dans Proximis : 

Image Added

Vous pouvez ensuite indiquer les différents paramètres associés à Apple Pay : 

Image Added


ParamètresValeur attendue
Merchant ID Apple Votre identifiant marchand Apple Pay
Code pays du marchand

Code pays du marchand sous format ISO 3166 (ex:

FR).

Ce code est utiliser pour ouvrir la session de

paiement.

Documentation Apple associée https://developer.apple.com/documentation/apple_pay_on_the_web/applepaypaymentrequest/1916117-countrycode

Message du paiement 

Label affichée dans la feuille de paiement Apple Pay

afin de décrire le paiement de l’utilisateur.

Documentation Apple associée https://developer.apple.com/documentation/apple_pay_on_the_web/applepaypaymentrequest/1916117-countrycode

Passphrase associée au certificat

Passphrase associée au couple de fichiers .pem du certificat de traitement des paiements. A indiquer si une passphrase a été utilisée lors de la génération de ces fichiers.


Libellé de la ligne dans l’encart de paiement


Déclaration du SDK Apple Pay

Dans le BO Proximis se rendre dans “Réglages > Commun > Code HTML” et cliquez sur le bouton “Ajouter un code HTML” :

                                     Image Added

Déclarez ensuite dans votre document le SDK Apple Pay : https://applepay.cdn-apple.com/jsapi/v1/apple-pay-sdk.js

Image Added


Enregistrer votre document : 


                                                                Image Added


Puis rendez-vous sur la configuration de votre page de paiement dans le BO Proximis et déclarez dedans un nouveau bloc de type “Code HTML” puis renseigner en paramètre le document créé précédemment contenant le SDK.

Image Added


Image Added

Warning

Réalisez bien cette contribution dans toutes les traductions de la page de paiement afin qu’Apple Pay soit disponibles sur chacune d’entre elles.

Paiement front

Le paiement via Apple Pay est ensuite disponible sur votre connecteur en front :

                                          Image Added


Au clic sur le bouton Apple Pay, la feuille de paiement s’ouvrira :


Image 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’ et déclarer vos propres règles CSS.


Image Added



Gestion des traductions.

Le module comprend la locale fr_FR. Il est possible de créer des nouveaux dossiers pour d’autres locales. Prenez exemple sur les fichiers 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

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


Image Added

Tests avec le moyen de paiement PayPal

Si vous souhaitez tester PayPal dans un environnement de test, n'oubliez pas d'activer la sandbox PayPal depuis votre compte PayPal client → Sandbox PayPal  

Description des moyens de paiement disponibles


Table Filter
fixedCols
totalrow,,,,,
hidelabelsfalse
ddSeparator;‚;‚;‚;‚;
sparkNameSparkline
hidePaneFiltration panel
limitHeight
sparklinefalse
default,,,,
isFirstTimeEnterfalse
cell-width250,250,250,250,250
hideColumnsfalse
totalRowName
totalColName
disabledfalse
enabledInEditorfalse
globalFilterfalse
id1712231187231_-1178259475
iconfilter
order0,1,2,3,4
hideControlsfalse
inversefalse,false,false,false,false
numbering
datefilter
columnNom,Catégorie,Région d'émission,Pays,Devises
sortNom ⇧
totalcol
disableSavefalse
rowsPerPage
separatorPoint (.)
labelsNom‚Catégorie‚Région d'émission‚Pays‚Devises
thousandSeparator
ignoreFirstNrows
ddOperatorOR,OR,OR,OR,OR
userfilter
datepatternd M yy
numberfilter
heightValue
updateSelectOptionstrue
worklog365|5|8|y w d h m|y w d h m
isORAND
showNRowsifNotFiltered


LogoNomCatégorieRégion d'émissionPaysDevises

Image Added

American Express

...

Passphrase associée au couple de fichiers .pem du certificat de traitement des paiements. A indiquer si une passphrase a été utilisée lors de la génération de ces fichiers.

...

Déclaration du SDK Apple Pay

Dans le BO Proximis se rendre dans “Réglages > Commun > Code HTML” et cliquez sur le bouton “Ajouter un code HTML” :

                                     Image Removed

Déclarez ensuite dans votre document le SDK Apple Pay : https://applepay.cdn-apple.com/jsapi/v1/apple-pay-sdk.js

Image Removed

Enregistrer votre document : 

                                                                Image Removed

Puis rendez-vous sur la configuration de votre page de paiement dans le BO Proximis et déclarez dedans un nouveau bloc de type “Code HTML” puis renseigner en paramètre le document créé précédemment contenant le SDK.

Image Removed

Image Removed

Warning

Réalisez bien cette contribution dans toutes les traductions de la page de paiement afin qu’Apple Pay soit disponibles sur chacune d’entre elles.

Paiement front

Le paiement via Apple Pay est ensuite disponible sur votre connecteur en front :

                                          Image Removed

Au clic sur le bouton Apple Pay, la feuille de paiement s’ouvrira :

Image Removed

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’ et déclarer vos propres règles CSS.

Image Removed

Gestion des traductions.

Le module comprend la locale fr_FR. Il est possible de créer des nouveaux dossiers pour d’autres locales. Prenez exemple sur les fichiers 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

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

Image Removed

Tests avec le moyen de paiement PayPal

Si vous souhaitez tester PayPal dans un environnement de test, n'oubliez pas d'activer la sandbox PayPal depuis votre compte PayPal client → Sandbox PayPal  

Description des moyens de paiement disponibles

Table Filter
fixedCols
totalrow,,,,,
hidelabelsfalse
ddSeparator;‚;‚;‚;‚;
sparkNameSparkline
hidePaneFiltration panel
limitHeight
sparklinefalse
default,,,,
isFirstTimeEnterfalse
cell-width250,250,250,250,250
hideColumnsfalse
totalRowNametotalColName
disabledfalse
enabledInEditorfalse
globalFilterfalse
id1712231187231_-1178259475
iconfilter
order0,1,2,3,4
hideControlsfalse
inversefalse,false,false,false,false
numberingdatefilter
columnNom,Catégorie,Région d'émission,Pays,Devises
sortNom ⇧
totalcol
disableSavefalse
rowsPerPage
separatorPoint (.)
labelsNom‚Catégorie‚Région d'émission‚Pays‚Devises
thousandSeparatorignoreFirstNrows
ddOperatorOR,OR,OR,OR,OR
userfilter
datepatternd M yy
numberfilterheightValue
updateSelectOptionstrue
worklog365|5|8|y w d h m|y w d h m
isORAND
showNRowsifNotFiltered
EUR ; GBP ; CHF ; USD ; AUD ; CAD ; DKK ; JPY ; NOK ; PLN ; SEK
LogoNomCatégorieRégion d'émissionPaysDevises

Image Removed

American ExpressCarteInternationalFrance ; Italie ; Belgique ; Luxembourg ; Royaume-Uni ; Irlande ; Pays-Bas ; Espagne ; Allemagne ; Portugal ; Suisse ; Autriche ; Slovaquie ; Slovénie ; Suède ; Danemark ; Norvège ; Finlande ; Estonie ; Lituanie ; Lettonie ; Grèce

Image Removed

Apple Pay
WalletInternationalFrance ; Italie ; Belgique ; Luxembourg ; Royaume-Uni ; Irlande ; Pays-Bas ; Espagne ; Allemagne ; Portugal ; Suisse ; Autriche ; Slovaquie ; Slovénie ; Suède ; Danemark ; Norvège ; Finlande ; Estonie ; Lituanie ; Lettonie ; GrèceEUR ; GBP ; CHF ; DKK ; USD ; CAD ; JPY ; NOK ; SEK ; PLN ; AUD

Image Removed

CB
CarteFranceFranceEUR

Image Removed

FLOABNPLEuropeFrance ; Italie ; Belgique ; Espagne ; Allemagne ; Portugal EUR

Image Removed

MastercardCarteInternationalFrance ; Italie ; Belgique ; Luxembourg ; Royaume-Uni ; Irlande ; Pays-Bas ; Espagne ; Allemagne ; Portugal ; Suisse ; Autriche ; Slovaquie ; Slovénie ; Suède ; Danemark ; Norvège ; Finlande ; Estonie ; Lituanie ; Lettonie ; GrèceEUR ; GBP ; CHF ; DKK USD ; USD AUD ; CAD ; DKK ; JPY ; NOK ; SEK ; PLN ; AUDSEK

Image RemovedImage Added

PaypalApple Pay
WalletInternationalFrance ; Italie ; Belgique ; Luxembourg ; Royaume-Uni ; Irlande ; Pays-Bas ; Espagne ; Allemagne ; Portugal ; Suisse ; Autriche ; Slovaquie ; Slovénie ; Suède ; Danemark ; Norvège ; Finlande ; Estonie ; Lituanie ; Lettonie ; GrèceEUR ; GBP ; CHF ; DKK ; USD ; CAD

Image Removed

VisaCarte; JPY ; NOK ; SEK ; PLN ; AUD

Image Added

CB
CarteFranceFranceEUR

Image Added

FLOABNPLEuropeInternationalFrance ; Italie ; Belgique ; Luxembourg Espagne ; Allemagne ; Portugal EUR

Image Added

Mastercard
CarteInternationalFrance ; Italie ; Belgique ; Luxembourg ; Royaume-Uni ; Irlande ; Royaume-Uni ; Irlande ; Pays-Bas ; Espagne ; Allemagne ; Portugal ; Suisse ; Autriche ; Slovaquie ; Slovénie ; Suède ; Danemark ; Norvège ; Finlande ; Estonie ; Lituanie ; Lettonie ; GrèceEUR ; GBP ; CHF ; DKK ; USD ; CAD ; JPY ; NOK ; SEK ; PLN ; AUD

Image Added

PaypalWalletInternationalFrance ; Italie ; Belgique ; Luxembourg ; Royaume-Uni ; Irlande ; Pays-Bas ; Espagne ; Allemagne ; Portugal ; Suisse ; Autriche ; Slovaquie ; Slovénie ; Suède ; Danemark ; Norvège ; Finlande ; Estonie ; Lituanie ; Lettonie ; GrèceEUR ; GBP ; USD ; CAD

Image Added

VisaCarteInternationalFrance ; Italie ; Belgique ; Luxembourg ; Royaume-Uni ; Irlande ; Pays-Bas ; Espagne ; Allemagne ; Portugal ; Suisse ; Autriche ; Slovaquie ; Slovénie ; Suède ; Danemark ; Norvège ; Finlande ; Estonie ; Lituanie ; Lettonie ; GrèceEUR ; GBP ; CHF ; DKK ; USD ; CAD ; JPY ; NOK ; SEK ; PLN ; AUD


Utilisation des CustomFields

Les appels à la page déportée sont enrichis avec les customFields :


1

CustomField1

Dynamique

Devise + montant

2

CustomField2

Dynamique

Numéro de commande

Le numéro de commande n’est pas disponible avant le retour du paiement. Ce champ ne doit donc pas être envoyé

3

CustomField3

Manuel

Logo du commerçant

Champ texte libre

4

CustomField4

Dynamique

Libellé de tous les produits du panier, avec options et axes de variation

5

CustomField5

Dynamique

Détail de l’acheteur :

  • Civ nom prénom

  • adresse email

6

CustomField6

Dynamique

  • Adresse de livraison

7

CustomField7

Dynamique

  • Adresse de facturation

8

CustomField8

Manuel

  • input texte libre (“header” dans l’exemple)

9

CustomField9

Manuel

  • input texte libre (“Custom text” dans l’exemple)


  • un toggle oui/non permet au marchand de choisir si il envoi ou non tel ou tel customField.

  • si un des champs est vide, il n’est pas envoyé

Bloc “Cartes enregistrées de l’utilisateur”

Ce bloc permet à l’utilisateur de gérer les cartes de paiement qu’il a enregistré sur les différents connecteurs de paiement Axepta de votre site via le OneClick.

Vous pouvez configurer ce bloc sur une de vos pages ou sur une page spécifique auquel l’utilisateur pourra accéder.

Contribution du bloc

Ajouter le bloc “Cartes enregistrées de l’utilisateur”

Image Added

 Ce bloc ne nécessite pas la configuration de paramètres particuliers.

Rendu du bloc

Image Added

Ceci est le rendu par défaut du bloc.

Comme un bloc natif Proximis ce bloc est personnalisable (template Cleverage/Axepta/Assets/Theme/Blocks/user-saved-cards.twig).


Checkout V2


Info
 Compatible à partir de la version 2.1.1 du checkout V2.


 Afin d’utiliser le connecteur de paiement Axepta sur le tunnel de paiement V2 de Proximis il faut passer la propriété “Connecteur utilisé sur le checkout V2” à oui dans la configuration du connecteur :


Image Added 


 Ceci permettra d’accéder au connecteur depuis le tunnel de paiement V2.

Warning
titleAttention

Un connecteur qui a la propriété checkout V2 à oui ne pourra pas être utilisé sur le checkout V1 et inversement. Chaque connecteur Axepta configuré ne peut être compatible qu’avec un process de commande.

 Les modes de paiement disponibles sur le checkout V2 sont :

  • Paiement par carte

  • Paypal

  • FloaPay

L’utilisation des cartes enregistrées n’est pas encore disponible sur le checkout V2.

Un manager AxeptaManager et un service AxeptaService ont été mis en place.

Le AxeptaService permet de servir le AxeptaManager qui permet de récupérer le template du formulaire de sélection du mode de paiement et le fichier de script JS associé.

Ces deux fichiers se trouvent dans le répertoire Plugins/Modules/Cleverage/Axepta/Assets/NewCheckout sous le nom form.twig et script.js .

Si vous souhaitez surcharger le template du formulaire de sélection du mode de paiement, vous pouvez vous brancher sur l’event getCheckoutV2Html du AxeptaManager afin d’indiquer votre template spécifique.