Download the PHP package sequra/magento2-core without Composer

Magento module for SeQura payment gateway

1. About seQura
2. Installation guide
3. Sign-up
4. For developers

About seQura

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.

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

• 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

Check the installation guide

Sign-up

Si tu comercio no está dado de alta en seQura, puedes hacerlo aquí para recibir credenciales de sandbox y empezar.

If you are not a seQura merchant yet, you can sign up here to get sandbox credentials and get started.

For developers

Starting the environment

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

This will start a Magento 2 instance with the seQura module installed. You can access the admin panel at http://localhost.sequrapi.com:8018/admin with the credentials admin/Admin123.

[!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:

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

To stop the containers and perform the cleanup operations run:

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.

Debugging with XDebug

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

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 extension

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

Installation

First, install NPM on your local machine (NVM is recommended) (See system requirements at: https://playwright.dev/docs/intro#system-requirements).

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

Last, install browsers using this command:

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:

More info at: https://playwright.dev/docs/intro

[!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

[!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:

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:

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

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:

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

If 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.