Installation and setup
Step 0: 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:
Run the command:
composer require sequra/magento2-coreEnable the Sequra Core module:
php bin/magento module:enable Sequra_Core
If you have already used Sequra extensions, a merchant should consider migrating them into a unified extension sequra/magento2-core that contains the entire configuration in one place and remove those that are no longer necessary.
To successfully achieve this, the merchant should run the following commands:
To preserve old 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_MagestoreRewardpoints
Remove dependencies on 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-rewardpoints
Require the latest version of the sequra/magento2-core extension:
composer require sequra/magento2-core
Step 2: Connect integration
After installation, merchant can access the integration configuration page using the SeQura menu item from the Sales menu:
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 environment.
Step 2: If the connection credentials are valid, merchants will be redirected to the next onboarding step - Selling countries configuration. Here is where merchants can configure countries where they want to offer SeQura payment methods and enter merchant IDs for each of them.
Step 3: After successfully selling countries configuration, merchant is redirected to the Promotional widgets configuration step. Here, merchants can configure the look and feel 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
Before putting the new payment method into production, we recommend conducting test purchases in the test environment (Sandbox Mode). This way, both parties, the e-commerce platform and SeQura, ensure that everything is working correctly.
Remember, the minimum amount to make a purchase with the "Installment Payment" option is €50. For lower amounts, this payment method will not be selectable.
We recommend the following procedure:
Ensure that the previous steps in this manual have been completed.
Make some test purchases and perform any additional tests you wish.
In Sandbox, no SMS messages are 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 have enabled and configured promotional widgets in the integration configuration, they can add them to product and cart pages in the store using 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:
If there is more than one SeQura product contracted, we place the cursor over the row we just created and click on the settings wheel. This opens another tab where we can configure the widget we want to display, for example, if we have the products pay in installments and split into three, we can set them up in different widgets.
Once the block is configured, we save it.
Step 2: Create a widget
In Content > Widgets, merchant should create a new widget and choose Sequra block created in 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 will be displayed. It is essential to select the option "All Store Views" in the "Assign to Store Views" field.
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.
