PHPackages                             sequra/magento2-core - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. sequra/magento2-core

ActiveMagento2-module[Payment Processing](/categories/payments)

sequra/magento2-core
====================

Core module for SeQura Payment Methods

3.2.2(3w ago)5120.3k↑75.7%14[1 PRs](https://github.com/sequra/magento2-core/pulls)6MITPHPPHP &gt;=7.4 &lt;8.6CI passing

Since Nov 23Pushed 5d ago28 watchersCompare

[ Source](https://github.com/sequra/magento2-core)[ Packagist](https://packagist.org/packages/sequra/magento2-core)[ RSS](/packages/sequra-magento2-core/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (10)Dependencies (8)Versions (123)Used By (6)

Magento module for SeQura payment gateway
=========================================

[](#magento-module-for-sequra-payment-gateway)

1. [About seQura](#about-sequra)
2. [Installation guide](https://sequra.atlassian.net/wiki/spaces/DOC/pages/1377304583/MAGENTO+2)
3. [Sign-up](#sign-up)
4. [For developers](#for-developers)
    - [Importing CORE UI resources](#importing-core-ui-resources)
    - [Starting the environment](#starting-the-environment)

About seQura
------------

[](#about-sequra)

### Description

[](#description)

seQura is the flexible payment platform that will help your business improve conversion and recurrence. The easiest, safest, and quickest way for your customers to pay on installments.

+6.000 e-commerce and +1.5 million delight shoppers already use seQura. Are you still thinking about it?

This Magento 2 plugin allows you to make payments with [seQura](https://sequra.es).

### Benefits for merchants

[](#benefits-for-merchants)

> Flexible payment solutions adapted to your business.

Widest flexible payment solutions in the market:

- Buy now pay later
- Pay in 3, no interest
- Installments, up to 24 months
- Flexi, combines interest-free BNPL with long-term financing in a single purchase experience

Your customers in good hands:

- Cost transparency and clarity
- Local support teams to deliver the best shopper experience
- Secure data, we don’t share your data with anyone or use your information to sell our own or third-party products

Obsessed with conversion and recurrence

- We adapt to your business, solutions for every sector, and buyer profile
- The highest acceptance rate in Southern Europe thanks to our own risk algorithm, created and optimized for the local market
- Instant approval. A frictionless credit-purchase experience, buy-in seconds without document uploads
- seQura marketing collateral to support your campaigns

### Benefits for customers

[](#benefits-for-customers)

- Widest range of flexible payment solutions available on the market, up to 4 different solutions to pay as you want.
- Access to credit with no paperwork, just complete 5 fields to be instantly approved
- Security and privacy, we do not sell your personal data to third parties nor share with other companies

Installation guide
------------------

[](#installation-guide)

Check the [installation guide](https://sequra.atlassian.net/wiki/spaces/DOC/pages/1377304583/MAGENTO+2)

Sign-up
-------

[](#sign-up)

Si tu comercio no está dado de alta en seQura, puedes hacerlo [aquí](https://sqra.es/signupmes) para recibir credenciales de sandbox y empezar.

If you are not a seQura merchant yet, you can sign up [here](https://sqra.es/signupmen) to get sandbox credentials and get started.

For developers
--------------

[](#for-developers)

### Importing CORE UI resources

[](#importing-core-ui-resources)

The seQura Magento 2 module uses the CORE UI resources from the `sequra-core-admin-fe` package. To update the resources, you need can use the provided utility script `bin/update-integration-core-ui`.

When the setup script runs, it will automatically call this utility to ensure that the latest CORE UI resources are copied into the project if the `--install` argument is provided. However, you can also run this utility manually to update the resources at any time.

### Starting the environment

[](#starting-the-environment)

The repository includes a docker-compose file to easily test the module. You can start the environment with the following command:

```
./setup.sh --install
```

This will start a Magento 2 instance with the seQura module installed. The store URL, admin URL, and admin credentials are read from your `.env` file (`M2_URL`, `M2_ADMIN_USER`, `M2_ADMIN_PASSWORD`) and printed in the terminal once the setup completes (see the note below). With the default `.env.sample` values, the admin panel is available at `http://localhost.sequrapi.com:8018/admin` with the credentials `admin`/`Admin123`, but if you customize `.env` use the values shown in your terminal instead.

Important

Make sure you have the line `127.0.0.1	localhost.sequrapi.com` added in your hosts file.

Note

Once the setup is complete, the Magento root URL, back-office URL, and user credentials (including the password) will be displayed in your terminal.

Additionally, the setup script supports the following arguments:

ArgumentDescription`--install`Install and copy the required assets to the module before starting the containers`--ngrok`Starts an ngrok container to expose the site to internet using HTTPS. An ngrok Auth Token must be provided either as an argument or as a variable `NGROK_AUTHTOKEN` in the `.env` file for it to work`--ngrok-token=YOUR_NGROK_TOKEN`Define the ngrok Auth Token`--cloudflared`Starts a Cloudflared container to expose the site to internet using HTTPS. A Cloudflared Tunnel Token must be provided either as an argument or as a variable `CLOUDFLARED_TUNNEL_TOKEN` in the `.env` file, and the public hostname must be set in `CLOUDFLARED_TUNNEL_URL``--cloudflared-token=YOUR_CLOUDFLARED_TUNNEL_TOKEN`Define the Cloudflared Tunnel Token. Get yours at `--open-browser`Open the browser and navigate to the Magento root URL once the installation is complete### Customization

[](#customization)

When the setup script runs, it takes the configuration from the `.env` file in the root of the repository. If the file doesn't exists, it will create a new one, copying the `.env.sample` template. In order to customize your environment before the setup occurs, you might create your `.env` file. To avoid errors, is important that you make a duplicate of `.env.sample` and then rename it to `.env`

You can read the `.env.sample` file to know what are the available configuration variables and understand the purpose of each one.

### Stopping the environment

[](#stopping-the-environment)

To stop the containers and perform the cleanup operations run:

```
./teardown.sh
```

Utilities
---------

[](#utilities)

This repo contains a group of utility scripts under `bin/` directory. The goal is to ease the execution of common tasks without installing additional software.

UtilityDescription`bin/composer `This is a wrapper to run composer commands.`bin/magento `This is a wrapper to run Magento CLI commands.`bin/n98-magerun2 `This is a wrapper to run n98 magerun CLI commands.`bin/update-sequra`Reinstall the seQura plugin in Magento's `vendor` directory using the project files as the repository.`bin/xdebug --mode=`Toggle XDebug on/off. Supported modes are: `off`, `profile`, `debug`.`bin/playwright `This is a wrapper to run Playwright E2E tests. It runs the tests in a headless mode inside of a Docker container of the official image provided by the Playwright team.`bin/update-integration-core-ui`Install and copy the latest resources for the integration core UI.`bin/npm`Wrapper for npm commands.`bin/phpcbf`Wrapper for phpcbf commands.`bin/phpcs`Wrapper for phpcs commands.`bin/phpstan`Wrapper for phpstan commands.Debugging with XDebug
---------------------

[](#debugging-with-xdebug)

Create a VS Code Workspace file at `.vscode/magento2-core.code-workspace` with the following content:

```
{
	"folders": [
		{
			"path": ".."
		}
	],
	"settings": {
		"launch": {
			"version": "0.2.0",
			"configurations": [
				{
					"name": "Listen for Xdebug",
					"type": "php",
					"request": "launch",
					"port": 9003,
					"pathMappings": {
						"/var/www/html/vendor/sequra/magento2-core": "${workspaceFolder}",
						"/var/www/html/app/code/Sequra/Helper": "${workspaceFolder}/.docker/magento/HelperModule/Sequra/Helper"
					}
				}
			]
		}
	}
}
```

Then start debugging (F5) making sure you have the option `Listen for Xdebug (workspace)` selected in VS Code

Note

You need to install and activate [PHP Debug](https://marketplace.visualstudio.com/items?itemName=xdebug.php-debug) extension

SeQura Helper plugin
--------------------

[](#sequra-helper-plugin)

This plugin is intended to provide webhooks to setup data or ease common development tasks. A Postman collection is provided in `.docker/magento/HelperModule/Sequra/Helper/Webhooks.postman_collection.json` with the definition of the supported endpoints and parameters.

End to end Tests
----------------

[](#end-to-end-tests)

### Installation

[](#installation)

First, install NPM on your local machine (NVM is recommended) (See system requirements at: ).

Then, Install required Node packages by running the following command from the root directory:

```
npm install
```

Last, install browsers using this command:

```
npx playwright install chromium chromium-headless-shell --with-deps --force
```

The `chromium` browser is used for standard Playwright runs, while `chromium-headless-shell` matches the headless Chromium build used in the official Playwright Docker image. The `--with-deps` flag installs any system dependencies Playwright needs. The `--force` flag forces Playwright to re-download the specified browsers instead of relying on any cached versions; you can omit it for a first-time install, but it is useful if a previous download is corrupted or out of date.

### Usage

[](#usage)

You can use the provided utility `bin/playwright` to run E2E tests defined in `tests-e2e` directory. This utility will run tests in a headless mode inside of a Docker container of the official image provided by the Playwright team.

Also, you can pass additional arguments to the utility to configure test execution. Some examples of arguments you can append to the command above:

ArgumentDescription`--debug`Runs tests in debug mode`--project=chromium`Execute the tests in the `chromium` project as defined in `playwright.config.js`. The single `chromium` project runs every spec in `tests-e2e/specs/`.`./tests-e2e/example.spec.js`Execute specific test file. Supports multiple file paths space separated. Also supports file name without extension and path like this: `example`More info at:

Important

In order for some tests to succeed, you must expose your Magento container to the internet, so that the callbacks made by SeQura can work. Make sure that you run the setup script passing the `--ngrok` argument.

Important

Make sure you wrote values for `SQ_MERCHANT_REF`, `SQ_USER_SECRET` and `SQ_ASSETS_KEY` in the `.env` file before launching e2e tests.

### Running using UI mode

[](#running-using-ui-mode)

Note

This is the recommended way to execute the E2E tests.

UI Mode lets you explore, run, and debug tests with a time travel experience complete with a watch mode. All test files are displayed in the testing sidebar, allowing you to expand each file and describe block to individually run, view, watch, and debug each test.

Run the following command in the repository root directory:

```
bin/playwright --ui
```

### Running using headed mode

[](#running-using-headed-mode)

It's also possible to run Playwright in headed mode. This will open a browser window to execute the tests. This approach could help you when you some debugging is needed. Run the following command in the repository root directory:

```
bin/playwright --headed
```

Note: append many arguments as needed to the command. For example `--debug`.

Building Docker images
----------------------

[](#building-docker-images)

The `docker-compose.yml` file uses a customized Magento 2 Docker image available at GitHub Packages Registry. Since the image is private, you need to authenticate to pull it. To do so, you need to create a GitHub Personal Access Token and store it in the `.env` file under the `GITHUB_TOKEN` variable.

Tools for building and pushing the Docker image are available in the `.docker/magento` directory. You can easily build and push the image by running the following commands:

```
.docker/magento/build-image.sh
```

The behavior of the script can be customized by setting the following arguments:

ArgumentDescription`--push`Push the image to the GitHub Packages Registry. Authentication is required.`--magento=`The Magento version to use. Supported versions are 2.4.3-p3, 2.4.4-p11, 2.4.5-p10, 2.4.6-p8, 2.4.7-p3`--php=`The PHP version to use. Supported versions are 7.4, 8.1, 8.2If arguments are not provided, the script will build the image using the values defined in the `.env` file.

Note

For pushing the image, you need a token with the `read:packages` and `write:packages` scopes. The token must be stored in the `.env` file under the `GITHUB_TOKEN` variable or as a global environment variable.

###  Health Score

71

—

ExcellentBetter than 100% of packages

Maintenance97

Actively maintained with recent releases

Popularity41

Moderate usage in the ecosystem

Community33

Small or concentrated contributor base

Maturity98

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 50.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~37 days

Recently: every ~44 days

Total

84

Last Release

23d ago

Major Versions

1.0.5 → 2.1.02019-01-15

2.7.1 → 3.0.02025-09-09

PHP version history (5 changes)2.5.0.x-devPHP &gt;=7.2

2.5.0.0PHP &gt;=7.4

2.7.0PHP &gt;=7.4 &lt;8.4

3.1.1PHP &gt;=7.4 &lt;8.5

3.2.2PHP &gt;=7.4 &lt;8.6

### Community

Maintainers

![](https://www.gravatar.com/avatar/4904ec8495b7510c38009cab31b03c7275af6d58d7be820e228e7bdd09eaa517?d=identicon)[sequra](/maintainers/sequra)

---

Top Contributors

[![m1k3lm](https://avatars.githubusercontent.com/u/1660934?v=4)](https://github.com/m1k3lm "m1k3lm (242 commits)")[![mescalantea](https://avatars.githubusercontent.com/u/22981044?v=4)](https://github.com/mescalantea "mescalantea (174 commits)")[![MarijaIv](https://avatars.githubusercontent.com/u/60438874?v=4)](https://github.com/MarijaIv "MarijaIv (24 commits)")[![AleksandarBoljanovic](https://avatars.githubusercontent.com/u/101107199?v=4)](https://github.com/AleksandarBoljanovic "AleksandarBoljanovic (20 commits)")[![tamaralogeecom](https://avatars.githubusercontent.com/u/81744738?v=4)](https://github.com/tamaralogeecom "tamaralogeecom (6 commits)")[![ristokekovic](https://avatars.githubusercontent.com/u/6854736?v=4)](https://github.com/ristokekovic "ristokekovic (6 commits)")[![jlnarvaez](https://avatars.githubusercontent.com/u/16030334?v=4)](https://github.com/jlnarvaez "jlnarvaez (1 commits)")[![jlnarvaez-hiberuscom](https://avatars.githubusercontent.com/u/259584464?v=4)](https://github.com/jlnarvaez-hiberuscom "jlnarvaez-hiberuscom (1 commits)")[![JMLucas96](https://avatars.githubusercontent.com/u/47561465?v=4)](https://github.com/JMLucas96 "JMLucas96 (1 commits)")[![brankologeecom](https://avatars.githubusercontent.com/u/97597214?v=4)](https://github.com/brankologeecom "brankologeecom (1 commits)")[![bfontaine](https://avatars.githubusercontent.com/u/1334295?v=4)](https://github.com/bfontaine "bfontaine (1 commits)")[![andreusala](https://avatars.githubusercontent.com/u/51320914?v=4)](https://github.com/andreusala "andreusala (1 commits)")[![amine-y](https://avatars.githubusercontent.com/u/48916036?v=4)](https://github.com/amine-y "amine-y (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

paymentmagento2pagossequra

### Embed Badge

![Health badge](/badges/sequra-magento2-core/health.svg)

```
[![Health](https://phpackages.com/badges/sequra-magento2-core/health.svg)](https://phpackages.com/packages/sequra-magento2-core)
```

###  Alternatives

[qenta/magento2-qcp

QENTA Checkout Page extension for Magento 2

113.7k](/packages/qenta-magento2-qcp)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
