| Table of Contents | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Installation and setup
...
Minimum requirements
Magento: 2.4.3
PHP: 7.4
For older versions see
Step 1: Installation
To set up the Sequra extension, merchants can follow the classic Magento2 installation process by executing the subsequent commands:
Install the Sequra extension:
...
, go to → Legacy Integration
| Info |
|---|
If you have already used |
seQura extensions, |
you should consider migrating them |
to a unified extension, |
, which contains all configurations in one place |
. Then, remove any extensions that are no longer |
needed. To accomplish this successfully |
, the merchant should |
execute the following commands:
|
...
|
...
|
...
|
Step 1: Installation
To configure the Sequra extension, follow the classic Magento 2 installation process by running the following commands:
Run the command:
composer require sequra/magento2-coreEnable the seQura Core module:
php bin/magento module:enable Sequra_Core
Step 2: Connect integration
After the installation, merchant you can access the integration seQura configuration page using the SeQura menu item from the Sales menuat Sales → SeQura:
...
Step 1: Once the SeQura menu item is pressed, the integration connection page is opened. Here is where the SeQura account information needs to be entered and that includes the username and password, as well as choosing the adequate environmentinside the seQura configuration page, you must enter the credentials (username and password) and select the appropriate environment: Sandbox (testing environment) or Live (production environment).
...
Step 2: If the connection credentials are valid, merchants you will be redirected to the next onboarding step - Selling countries step, the country configuration. Here This is where merchants can you configure the countries where they in which you want to offer SeQura seQura payment methods and enter merchant IDs for each of them.
...
. Just like in the previous step, it is necessary to add the corresponding merchant ID (username) for each country.
...
Step 3: After successfully selling countries completing the country configuration, merchant is redirected to the Promotional widgets configuration stepwe move on to the step for configuring the promotional widgets. Here, merchants can you configure the look and feel appearance of promotional widgets before placing them on storefront pages.
...
Additionally, you can select on which pages you want to allow widgets to be displayed and, in case of product listing mini-widgets, you will be able to configure additional options.
...
Configuration
Manage payment methods
Merchant is able to filter and see imported payment methods for each selling country on the payment methods page.
...
Manage general settings
Merchant is able to configure the main settings of the SeQura integration.
...
Manage connection settings
Merchant is able to disconnect his current API credentials or change connection settings at any time.
...
Filter categories and products
Within seQura configuration, in General Settings, there is the section that allows us to filter both categories and products.
...
Test purchases
Important
the widgets. You can find different styles of the widget here: https://live.sequracdn.com/assets/static/simulator.html
...
Configuration
Payment Methods Configuration
You can filter and view the available payment methods for each country in the Payment Methods section.
...
General settings
Within Settings → General Settings, you will find various sections such as:
Allowed IP Addresses: In this field, you can filter the IPs that will be able to view seQura. If the IP field is left empty, seQura will be visible to everyone. The seQura IP is:
212.80.211.33.Excluded Categories: In this field, you can filter categories that will not offer seQura.
Excluded Products: In this field, you can filter products that will not offer seQura.
Countries: In this field, you configure the countries where seQura will be available.
...
Connection settings
If you need to modify the configuration or disconnect the current credentials, within Settings → Connection Settings, you will find a red button that allows you to disconnect and reconnect the credentials at any time.
...
Test purchases
| Note |
|---|
Important! Before putting the new payment method into production, we recommend conducting test purchases in the |
...
testing environment (Sandbox Mode). This way, both |
...
the e-commerce platform and |
...
seQura can ensure that everything is working correctly. Remember, the minimum amount to make a purchase with the " |
...
Split Payment" option is €50.00. For |
...
amounts below this, this payment method will not be selectable. |
We recommend the following procedure:
...
Steps to make a Test Purchase in the Testing Environment (Sandbox):
Ensure that you have completed the previous steps in of this manual have been completed.
Make some Conduct several test purchases and perform any additional other tests you wishdesire.
In Sandbox, no SMS messages are not sent. The validation code requested during the purchase process will be the last 5 digits of the mobile number provided in the previous step.
In Sandbox, the fictitious card number for testing will be 4716 7730 7733 9777, the expiration date 12/30, and the CVV/CVC 285.
Place promotional widgets
Once merchants the promotional widgets have been enabled and configured promotional widgets in the integration configurationsettings, they can add them be added to the product and cart pages in of the store using . To do this, it is necessary to use the native Magento 2 mechanism with blocks and widgets.
Step 1: Create a block
In Content > Blocks, merchants should create a block and place a layout component (row, columns or tabs).
...
Then, merchant should drag and drop the SeQura promotional widget inside the layout component and save the block:
...
To create a block, navigate to Content → Blocks → Add Block. Within the block, you need to place a design component and, inside it, the seQura widget.
...
| Note |
|---|
To create the block and add the Sequra widget, the Page Builder editor must be enabled. |
When creating the block, you need to add a name and an identifier, such as sequra. In the Store View section, select All Store Views. The next step is to edit the block by clicking Edit With Page Builder.
...
Within the Page Builder editor, add a row. Inside the row, you need to drag and drop the seQura promotional widget.
...
| Info |
|---|
If there is more than one |
...
seQura product contracted, |
...
hover over the row |
...
you just created and click on the |
...
options gear icon (⚙️ ). This |
...
will open another tab where |
...
you can configure the widget |
...
you want to display |
...
. For example, if |
...
you have the |
...
"Split Payment" and "Divide in Three" products, you can configure them in different widgets. |
Once the block is configured, we save itexit the editor and save your changes.
...
Step 2: Create a widget
In Within Content > → Widgets, merchant should you need to create a new widget and choose Sequra select the sequra block created in the previous step:
To create a new widget, you need to create the widget as a CMS static block type, choosing the active theme.
...
Then, the merchant can configure on which pages the blocks .
...
When clicking on Add Widget, configure the Type as CMS Static Block and ensure that the same theme that is active on the website is set.
| Info |
|---|
To view the active theme of the website, navigate to Content → Design → Themes.  |
Once the type and design are defined, you need to specify the widget name, for example, sequra, and configure on which pages it will be displayed. It is essential to select the option "All Store Views" in the "Assign to Store Views" field.
...
field.
...
On the same screen, further down, you need to configure the widget's location for the product page. To do this, select All Product Types in the Display On field and choose Product Info Auxiliary Container in the Container field.
...
In the Widget Options, select the block created earlier and save your changes.
...
After completing this configuration, the Sequra widget should be visible below the product price.
...
Step 3: Set up the mini-widgets
| Info |
|---|
Remember that you need to activate the widgets you want to display on the seQura configuration page.   |
For the product page, in the layout updates section, you need to select All Product Types in the Display on field.
...