Installation and setup
Minimum requirements
Magento: 2.4.3
PHP: 7.4
For older versions, go to → Legacy Integration
If you have already used seQura extensions, you should consider migrating them to a unified extension, sequra/magento2-core, 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:
To retain the previous configuration, run the following command:
composer require sequra/magento2-core:"<=2.4.2.5"Uninstall unnecessary extensions:
php bin/magento module:uninstall Sequra_Campaign Sequra_Splitpayments Sequra_Partpayments Sequra_Invoice Sequra_Card Sequra_MageplazaRewardpoints Sequra_Remotesales Sequra_MagestoreRewardpointsRemove dependencies for unnecessary extensions:
composer remove sequra/magento2-campaign sequra/magento2-splitpayments sequra/magento2-partpayments sequra/magento2-invoice sequra/magento2-card sequra/magento2-mageplaza-rewardpoints sequra/magento2-remotesales sequra/magento2-magestore-rewardpointsRequire the latest version of the
sequra/magento2-coreextension:composer require sequra/magento2-core
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, you can access the seQura configuration page at Sales → SeQura:
Step 1: Once inside 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 credentials are valid, you will be redirected to the next step, the country configuration. This is where you configure the countries in which you want to offer seQura payment methods. Just like in the previous step, it is necessary to add the corresponding merchant ID (username) for each country.
Step 3: After completing the country configuration, we move on to the step for configuring the promotional widgets. Here, you configure the appearance of 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
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.
Steps to make a Test Purchase in the Testing Environment (Sandbox):
Ensure that you have completed the previous steps of this manual.
Conduct several test purchases and any other tests you desire.
In Sandbox, 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 the promotional widgets have been enabled and configured in the integration settings, they can be added to the product and cart pages of the store. To do this, it is necessary to use the native Magento 2 mechanism with blocks and widgets.
Step 1: Create a 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.
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.
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, exit the editor and save your changes.
Step 2: Create a widget
Within Content → Widgets, you need to create a new widget and select the sequra block created in the previous step.
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.
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.
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
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.
Configuration to display the widget below the product:
Configuration to display the widget in the cart:
Configuration to display the widget on the product list (from seQura settings):
Widgets interaction
Product listing
Customers browsing the product listing page on the storefront will be able to see ways to pay for a specific product using SeQura installments in the listing. In case the product price is equal or higher than the minimum supported product amount on SeQura, it will show the configured teaser message in the current storefront language.
Otherwise, if the product price is lower than the minimum supported product amount on SeQura, the configured message below limit will be displayed.
Product page
Customers that open the product page for a given product will be able to see ways to pay for that product using SeQura payment methods. Promotional widgets use the current product price and take into account any additional costs caused by the specific product variation.
Additionally, clicking on the info link in a specific promotional widget block opens up more information about payment arrangement for that specific SeQura payment method.
Cart page
Customers whoreach the cart page in Magento 2 storefront will be able to see options to pay for their current cart using SeQura payment methods.
Similarly as on the product page, customers can click on the link in the promotional widget and see more information about payment options with that payment method.
Payment methods interaction
Once the SeQura integration is successfully connected to the shop, customers will be able to select SeQura payment methods on the checkout page as their payment method of choice.
Once the payment method is picked the Sequra form is displayed. After following the instructions described in the form, the payment process should be completed.
If a payment needs to be reviewed by SeQura before it can be processed and declared successful, as the last form view there will be a notification about payment revision, before redirecting to the thank you page.
After a successful payment, customer should be greeted by the shop’s thank you page:
Since the payment may need a review from SeQura, merchants are able to check and monitor the payment status in the Magento 2 admin panel in the Orders page.
Order management
SeQura order information
Merchant is able to view SeQura payment information - the order reference and the link to SeQura order on the Order overview page.
Merchant is able to view SeQura payment information on the Order details page.
Update order
Merchant is able to update an order placed with SeQura payment method in the shop system and see that change propagated to the SeQura portal or rejected if the SeQura does not support such a change. The integration propagates changes in billing and shipping addresses.
Ship order
Merchants can either partially or fully ship an order placed with the SeQura payment method using the native Magento 2 mechanism for shipping an order.
Refund order
Merchants can either partially or fully refund order items using the native Magento 2 mechanism for refunding order line items.
To refund an order placed with the SeQura payment method, merchants should open an invoice for the created order and create a Credit Memo.
SeQura integration supports only online refunds:
Cancel order
Merchants can cancel an order made with SeQura payment methods using the native Magento 2 mechanism for cancelling an order. Magento 2 only allows merchants to cancel an order that has not yet been paid and shipped.
