Skip to main content
Version: next

Payline

Since version 3.22

The Payline extension lets customers pay with Monext Online (Payline) through the Payline Widget on a Magento 1 store.

The customer pays inside the store: the Payline Widget is injected in the payment step, so there is no redirection to Payline (except when the payment method itself requires it, e.g. 3-D Secure).

info

This extension targets Magento 1. The Magento 2 and Gezy flavors are planned but not available yet.

Prerequisites

This extension integrates Monext Online (Payline) and requires two modules on your Magento 1 store:

All Payline settings (merchant id, access keys, contract numbers and the homologation / production environment) are configured in Magento, so there is no FRONT_COMMERCE_PAYLINE_* environment variable to set in Front-Commerce.

Installation

Install the @front-commerce/payline package:

Command to install @front-commerce/payline
$ pnpm add @front-commerce/payline

Front-Commerce configuration

Add the Payline extension to your front-commerce.config.ts, passing the flavor matching your backend. The only supported value for now is magento1:

front-commerce.config.ts
import { defineConfig } from "@front-commerce/core/config";
import themeChocolatine from "@front-commerce/theme-chocolatine";
import magento1 from "@front-commerce/magento1";
import payline from "@front-commerce/payline";
import storesConfig from "./app/config/stores";
import cacheConfig from "./app/config/caching";

export default defineConfig({
extensions: [
themeChocolatine(),
magento1({ storesConfig }),
payline("magento1"), // ⚠️ needs to be after themeChocolatine()
],
stores: storesConfig,
cache: cacheConfig,
configuration: {
providers: [],
},
});

That's all you need: the Payline Widget now appears at the payment step of the checkout, and shoppers can pay with it.