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-core

• Enable 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:

Open

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.

Open

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.

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 widgets

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.