Terminology
maibmerchants - portal dedicated to the Merchant, where they can configure the necessary settings for integration with maib e-commerce, perform certain financial operations (such as payment refunds), and access additional functionalities.
The portal is continuously evolving, and in the future, it will also include other tools that will streamline and enhance the digital experience of the Merchant.
maib ecomm - the maib system that processes ecommerce transactions.
maib ecomm checkout - the page where the Customer is redirected to enter the card data (or pay via Apple Pay™ / Google Pay™).
The merchant has the ability to modify this page. Upon request, they will receive the page template and the requirements according to which they will make the modifications.
Merchant - an entity engaged in commercial activity that owns an ecommerce solution and initiates integration with maib e-commerce to accept online payments.
Project - an entity in the maibmerchants platform that contains information and settings related to integrating a solution with maib e-commerce.
For each website/app a new Project will be opened and the following settings will be made:
Domain - website/app domain, must belong to the Merchant.
IP - hosting/server IP.
Platform - refers to the platform used to build/develop and manage the ecommerce solution. This can be a CMS (content management system), framework or a specific programming language.
Callback URL - the link where the Merchant will receive the final response with the transaction status and data.
Ok URL - the link where the Customer will be redirected if the transaction is successful.
Fail URL - the link where the Customer will be redirected if the transaction failed.
Project Secret - is used together with Project ID to generate the Access Token, used to authorize requests to maib ecomm.
Signature Key - used to validate notifications with transaction status and data on the Callback URL. See more details in the Notifications on Callback URL section.
Intermediate response - response from maib ecomm to Merchant containing the transaction identifier and the link to the maib ecomm checkout.
Final response - response from maib ecomm to Merchant (on Callback Url) containing the status and basic data of the transaction. Callback Url is set in maibmerchants but can also be sent in request (callbackUrl parameter).
Test Project
The Test Project is intended for conducting transactions in the testing environment. In the test environment, all types of payments provided in the maib e-commerce API can be performed: direct payments, two-step payments, recurring payments, and one-click payments.
Testing is one of the mandatory conditions for activating the Production Project.
Execute successful tests according to the endpoints for the type of payment you intend to use, using data.
Production Project
The Production Project is intended for carrying out real transactions and can be activated only after signing the e-commerce contract and configuring the project in the platform (Domain / IP / Platform / Callback URL / Ok URL / Fail URL).
After activating the Project, you will have access to the Project Secret and Signature Key for integrating your solution with maib e-commerce API.
Last updated