Contenu
Présentation
Monext vous propose un plugin pour ajouter le module de paiement à votre plateforme de commerce électronique CommerceTools.
Il ainsi permet une mise en œuvre rapide de la solution Monext Online avec tous vos moyens de paiement dans votre boutique online.
Les fonctions disponibles sont :
- Mode widget avec un affichage de la page de paiement hébergé par Monext avec redirection de l'acheteur.
- Paiement comptant.
- Paiement à la commande et à l'expédition.
- Validation du montant de total.
- Annulation d'une opération d'autorisation non encaissée.
- Remboursement partiel, multiple et total.
- Les moyens de paiement :
- CB, Visa, Mastercard, American Express, ApplePay, GooglePay, PayPal.
- avec l'acquéreur Monext : Bancontact, iDEAL, MB Way.
- Devise Euro.
Le parcours de paiement
1. L'acheteur valide sa commande sur le frontend de CommerceTools et il est redirigé sur la page de paiement Monext.
2. Puis il sélectionne son moyen de paiement et saisie ses informations sur la page de paiement Monext.
Télécharger le module
Vous devez suivre la procédure indiqué sur Github : github/Monext/monext-CommerceTools-commerce-cloud
Après l'installation du module de paiement Monext, vous devez configurer les modes de paiement en sélectionnant le type de module Monext.
Gestion des commandes
Les informations de la commande sont envoyées à Monext dès la validation de la commande :
- Point de vente.
- Numéro de contrat du mode de paiement : paymentMethodIDs (Contract Number).
- Informations de l'acheteur.
- Adresse de facturation et de livraison de l'acheteur.
- Mode de livraison sélectionné.
- Contenu du panier.
- Total de la commande, son détail et la devise.
Traitements sur les commandes CommerceTools
Dans le backoffice CommerceTools, vous pouvez consulter les commandes et le détail de paiement dans l'onglet Paiement :
- le moyen de paiement
- le module de paiement Monext
- La référence commande
- Le token de session
- L'id de paiement CommerceTools : données privées avec la clé commercetoolsPaymentID
Les types de transaction
Type | Description |
---|---|
Authorization | Autorisation simple |
Charge | Validation / Autorisation + Validation |
Refund | Remboursement |
Cancel | Annulation |
Les états de la transaction
Etat | Description |
---|---|
Initial | Initialisation de la demande d'autorisation (état temporaire) |
Failed | Echec |
Successful | Succès |
1. Validation : modifier l'état de la livraison de la commande.
Vous pouvez valider un paiement uniquement avec l'API.
La prochaine version Checkout de CommerceTools propose la gestion depuis le backoffice.
2. Annulation
Vous pouvez annuler une commande uniquement avant qu'elle soit validée et uniquement avec l'API.
La prochaine version Checkout de CommerceTools propose la gestion depuis le backoffice.
3. Remboursement
Vous pouvez rembourser une commande après qu'elle soit validée et uniquement avec l'API.
La prochaine version Checkout de CommerceTools propose la gestion depuis le backoffice.
Configuration du mode de paiement
La configuration est réalisée par la création d'un projet du backoffice CommerceTools puis elle se déroule en 3 étapes :
1. Créer un client API responsable de la gestion des paiements dans un projet.
Les détails du client API sont pris en entrée comme variables d'environnement/configuration pour la connexion telles que CTP_PROJECT_KEY
, CTP_CLIENT_ID
, CTP_CLIENT_SECRET
2. Configurer les URL de CommerceTools
Commercetools doit être configuré pour que l'application de connexion puisse gérer les sessions et le processus d'authentification pour les endPoints.
Leurs valeurs sont prises en entrée comme variables d'environnement/configuration pour la connexion avec les noms de variables CTP_API_URL
, CTP_AUTH_URL
et CTP_SESSION_URL
.
3 Configurer l'identifiants et configurations du compte Monext
Une clé API fournie par Monext doit être configurée pour que les requêtes de l'application connect puissent être authentifiées : MONEXT_API_KEY
.
Vous pouvez suivre les étapes indiquées à titre indicatif, vous devez consulter à la documentation CommerceTools.
1. Créer un client API
Menu Settings > Developper Settings
Sélectionner Create new API client
Sélectionner le Scope : Payment Connector commerceTools Checkout
Sélectionner les options : Checkout payment, Orders, Payments, Customers pour Manage, View ainsi que les Tokens View_api_clients et introspect_oauth_tokens
Les informations Credentiels apparaissent une seule fois : veuillez à les sauvegarder de manière cryptés.
2. Créer un connector pour configurer les URL, ID
Menu Projet > Organizations & teams
puis l'onglet Connect et cliquer sur Manage Connectors
Créer un Connector.
3. Configurer le connector
Dans l'onglet Installations pour retrouver le module de paiement.
- enabler avec checkout prochaine version.
- processor avec la version initiale.
Une fois le module sélectionner, la partie Processor permet de configurer les variables :
- client API :
CTP_PROJECT_KEY
,CTP_CLIENT_ID
,CTP_CLIENT_SECRET.
URL de l'application de connexion :
CTP_API_URL,CTP_AUTH_URL et CTP_SESSION_URL.
- clé API Monext :
MONEXT_API_KEY
.
Vous pouvez déclarer plusieurs Store ici ainsi que le type de capture par Store : veuillez consulter les détails de l'installations sur github.