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
        {
          "type": "composer",
          "urlcleverage/axepta": "https://nexus-production.tools-services-1.omn.proximis.com/repository/cleverage-axepta/^1"
        }

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

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


Et lancez Et lancez votre script update.bash.

...

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 manuelle


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 paiement

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 Modified



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.

...

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

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

...

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.

...

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

...

(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
    Formulaire d'éligibilité

  • Page de paiement

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

...

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

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èceEUR ; GBP ; CHF ; USD ; AUD ; CAD ; DKK ; JPY ; NOK ; PLN ; SEK

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

CB
CarteFranceFranceEUR

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

Mastercard
CarteInternationalFrance ; 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

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

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.