Content




Presentation

Monext offers a plugin to add the payment module to your CommerceTools e-commerce platform.  
This allows for quick implementation of the Monext Online solution with all your payment methods in your online store.


The available functions are:

  • Widget mode with a display of the payment page hosted by Monext with buyer redirection.
  • Cash payment.
  • Payment upon order and shipment.
  • Validation of the total amount.
  • Cancellation of an uncashed authorization transaction.
  • Refund partial, multiple and total.
  • Payment methods :
    • CB, Visa, Mastercard, American Express, ApplePay, GooglePay, PayPal​.
    • with the acquirer Monext: Bancontact, iDEAL, MB Way​.
  • Currency Euro.




The payment process 


1. The buyer validates his order  on the CommerceTools frontend and is redirected to the Monext payment page.

2. Then he selects his payment method and enters his information on the Monext payment page .




Download the module

You must follow the procedure indicated on Github: github/Monext/monext-CommerceTools-commerce-cloud

After installing the Monext payment module, you must configure the payment methods by selecting the Monext module type.


Order management

Order information is sent to Monext as soon as the order is validated: 

  • Point of sale.
  • Payment method contract number: paymentMethodIDs (Contract Number).
  • Buyer's information.
  • Buyer's billing and delivery address.
  • Selected delivery method.
  • Cart contents.
  • Order total, details and currency.


CommerceTools Order Processing

In the CommerceTools backoffice , you can view orders and payment details in the Payment tab:

  • the means of payment 
  • the Monext payment module
  • The order reference 
  • The session token 
  • CommerceTools Payment ID: Private data with the commercetoolsPaymentID key


Transaction types

TypeDescription

Authorization

Simple authorization

Charge

Validation /  Authorization&Validation

Refund

Remboursement

Cancel

Annulation

 

Transaction states

Etat

Description

Initial

Initializing authorization request
(temporary state)

Failed

Failure

Successful

Success



1. Validation: modify the delivery status of the order. 

You can validate a payment only with the API. 

The next version of CommerceTools Checkout offers back-office management. 

2. Cancellation 

You can cancel an order only before it is validated and only with the API. 

The next version of CommerceTools Checkout offers back-office management. 

3. Refund

You can refund an order after it is validated and only with the API. 

The next version of CommerceTools Checkout offers back-office management.


Payment Method Setup

The configuration is done by creating a CommerceTools backoffice project and then it takes place in 3 steps:

1. Create an API client responsible for managing payments in a project.

The API client details are taken as input as environment/configuration variables for the connection such as , , CTP_PROJECT_KEY CTP_CLIENT_ID CTP_CLIENT_SECRET

2. Configure CommerceTools URLs

Commercetools must be configured for the login application to manage sessions and the authentication process for endpoints. 

Their values ​​are taken as input as environment/configuration variables for the connection with the variable names , and . CTP_API_URL CTP_AUTH_URL CTP_SESSION_URL 

3 Configure the Monext account identifiers and configurations

An API key provided by Monext must be configured so that requests from the connect application can be authenticated : MONEXT_API_KEY.


Detailed Configuration steps

You can follow the steps given as a guide, you should refer to the CommerceTools documentation.


1. Create an API client 

Menu  Settings > Developer Settings 

Select Create new API client 






      • Select Scope: Payment Connector commerceTools Checkout
      • Select the options:  Checkout payment, Orders, Payments, Customers for Manage, View 
        as well as the Tokens View_api_clients and introspect_oauth_tokens


Credential information appears only once: please save it encrypted.

2. Create a connector to configure URLs, IDs 

Project menu > Organizations & teams

then the  Connect  tab and click on  Manage Connectors

Create a Connector.

3. Configure the connector 

In the Installations tab  to find the payment module.

      • enable with checkout next version.
      • processor with the initial version.

Once the module is selected, the Processor section allows you to configure the variables: 

      • API client: , , CTP_PROJECT_KEY CTP_CLIENT_ID CTP_CLIENT_SECRET.

      • Login application URL: CTP_API_URL,CTP_AUTH_URL et CTP_SESSION_URL. 

      • Monext API key : MONEXT_API_KEY.

You can declare multiple Stores here as well as the capture type per Store: please see the installation details on github.




Related pages