--- title: "Magento 2" description: "Magento 2 plugin documentation for Fabrick Payment Orchestra. Complete guide to installation, configuration and payment management via the Ecommerce Sella plugin for Magento 2." url: "https://docs.fabrick.com/en/payment-hub-and-orchestra/ecommerce/integration-methods/plugin/magento2/" language: "en" --- # Magento 2 [Apple Pay](https://docs.fabrick.com/en/payment-hub-and-orchestra/ecommerce/alternative-payments/apple-pay/ "Apple Pay")[Fabrick Pay by Bank](https://docs.fabrick.com/en/payment-hub-and-orchestra/ecommerce/alternative-payments/pay-by-bank/ "Fabrick Pay by Bank")[Google Pay](https://docs.fabrick.com/en/payment-hub-and-orchestra/ecommerce/alternative-payments/google-pay/ "Google Pay")[PayPal](https://docs.fabrick.com/en/payment-hub-and-orchestra/ecommerce/alternative-payments/paypal/ "PayPal")[Satispay](https://docs.fabrick.com/en/payment-hub-and-orchestra/ecommerce/alternative-payments/satispay/ "Satispay") ## Features The Ecommerce Sella plugin for Magento 2 provides the following features, which can be customized as needed: ### ✓ — S2S REST ✓ — 3DS2 – Authentication ✓ — Tokenization ✓ — PayPal Seller Protection ✓ — Pay By Link ✓ — Wallet\&Click2Pay with Fabrick Payment ✓ — Sella RBA (Risk Based Authentication) ✓ — Fabrick Guaranteed payments ## Detailed feature description: - Simple and fast configuration - Wide availability of alternative payments - Order and invoice management via server-to-server calls (orders, refunds, pre-authorizations) - Fast payment management thanks to card tokenization (one-click mode) - Fast payment management via the form rendered on the Magento checkout page ![Magento 2](https://docs.fabrick.com/en/assets/images/magento2-pagina-pagamento-cde5f5b4dd33deb6a99f8d030901aed7.png) - Pay By Link: ability to generate an order from the Magento backend, sending the customer an email with a link to complete the payment (not all alternative methods are supported) Email example ![Magento 2](https://docs.fabrick.com/en/assets/images/magento-2-2-6818ac82930d3b20cef5b51d5c3e155b.png) - Sella RBA (Risk Based Authentication): a solution that analyzes the fraud risk of transactions in real time and, in case of low risk, activates the TRA (Transaction Risk Analysis) exemption. - Fabrick Guaranteed payments: an end-to-end fraud prevention solution for online merchants that leverages an artificial intelligence system to assess transaction risk levels (Powered by Riskified). - The plugin is compatible with: - Adobe Commerce (cloud): 2.4 - Adobe Commerce (on-prem): 2.4 - Magento Open Source: 2.4 All compatibility tests were conducted on the most recent versions of Adobe Commerce available for the compatible release lines at the time the extension was submitted. ## Merchant back-office configuration In the **merchant back-office** provided, you can retrieve credentials, SHOP Login and API Key, to be reused when configuring the plugin in the **Magento back-office**. Within *Configuration > Security > APIKEY* you can create the required value ![Magento 2](https://docs.fabrick.com/en/assets/images/magento2-configurazione-1-a3be625d4d1ae26223fa9e203db21b46.png) By pressing the *Add Key* button. ![Magento 2](https://docs.fabrick.com/en/assets/images/magento2-gestione-apikey-20ef62a05e85ff3891cbef0e50b2d924.png) Then press the copy button, highlighted in the figure, to copy the key to clipboard, for later use on the Magento backend. Within *Payment Page > Fields & Parameters* the `PaymentMethod` parameter must be enabled in the response, on both pages By checking the two entries visible in the following screen. ![Magento 2](https://docs.fabrick.com/en/assets/images/magento2-2-flag-1-6a5e07058c0fbefe0140de2e863c3709.png) ## Plugin installation information ### Installation via Composer (all versions) Installation via Composer, the official Adobe method for installing modules. - From the Adobe Commerce website, add to cart and purchase (free of charge) the "Ecommerce Sella" module [https://commercemarketplace.adobe.com/easynolo-ecommercesella.html](https://commercemarketplace.adobe.com/easynolo-ecommercesella.html) - Run the command "`composer require easynolo/ecommercesella`" Everything should now be ready for configuration via the administration panel. ## Plugin configuration > **note** > > To use the plugin features, you need to request Sella support to activate the following features on the merchant code: > > - iFrame > - S2S API (Authorization, Capture, Refund, Inquiry) After installing the plugin, you need to configure the options made available through the **Magento back-office**. In the dedicated section **stores → configuration → sales → payment methods** there is the "Sella" block for plugin configuration. ![Magento 2](https://docs.fabrick.com/en/assets/images/magento-2-8-1-ca9e05cdf7cdf6d1ae7bae63b7c4f039.png) In the first section you can configure: - **plugin activation**: enables the display of payment methods provided by Sella during checkout; - **test mode activation**: allows you to use the payment gateway sandbox with the corresponding test SHOP Login and API Key; - **Wallet\&Click2Pay activation**: enables access to Apple Pay, Google Pay and credit card services on the new Fabrick Payment page; - **card tokenization activation**: allows the customer's payment card to be securely saved and then offered in subsequent payments; - **credit card operation type selection**: identifies the settlement method: if set to **"Authorization and capture"** the transaction, if authorized, is also captured automatically; if set to **"Authorization"** the transaction, if authorized, requires a manual operation to be captured Here is an example of the configuration section: ![Magento 2](https://docs.fabrick.com/en/assets/images/magento-2-9-8cf99b47e3623854649f1c0870fd3a21.png) > **info** > > If you want to use the **Wallet & Click2Pay** feature with **Fabrick Payment**, you need to configure the following URLs for positive, negative and Server to Server responses in the merchant back office: > > - positive response: `{domain}/sella/back/success/` > - negative response: `{domain}/sella/back/failed/` > - Server to Server: `{domain}/sella/back/walletclick2paypost/` > > Enabling the Wallet & Click2Pay feature requires keeping the GooglePay section set to **NO** (see the section below). > > Additionally, you can configure the visibility of individual payment methods. If needed, a dedicated button is provided to hide a method. ## Payment method configuration In the first section, there are three sub-sections for managing extra configurations on specific payment methods: - **Consel**, where, upon enabling the method, you need to specify the **Merchant Promotional Code**; - **Google Pay**, where, upon enabling the method, you need to specify the **Merchant ID**; - **PayPal**, for which you can choose the operation type: **authorization and capture** or **authorization**. In the second section there are two specific fields for entering the **SHOP Login** and **API Key** credentials. When saving the configuration, the entered credentials are validated. If valid, the plugin will synchronize all active payment methods on the terminal to offer them during checkout to the end customer. If payment methods are updated in the merchant back-office, a Magento procedure periodically synchronizes the list. If the merchant wants to synchronize payment methods with immediate effect, they will need to save the plugin configuration on Magento again. If Wallet\&Click2Pay mode is enabled, it will not be necessary to specify Google Pay parameters as this method will be managed through Fabrick Payment, and the parameters will be specified within the back-office. ## Fabrick Guaranteed Payments configuration (Powered by Riskified) To enable the use of the anti-fraud solution, you need to set the following option to "Yes": ## Saved card management information (frontend) If the backend has the option to save the token for credit cards enabled, on the frontend the buyer will see the save option when entering card details at checkout ![Magento 2](https://docs.fabrick.com/en/assets/images/magento-img1-38b3dbe9752e025281139be2493637d8.png) Once saved, when placing an order, the saved tokens will appear as the first payment option (but the buyer can always choose to use another payment method or enter a new credit card). ![Magento 2](https://docs.fabrick.com/en/assets/images/magento-img2-d047f0e60dab93e2afdb376b25497c4b.png) Subsequently, from their profile, under "Stored Payment Methods", they can view all cards saved on the site and delete those they prefer. ![Magento 2](https://docs.fabrick.com/en/assets/images/magento-img3-a1c9e1f229c09c8ddaf19fa6f45cb509.png) ## Order and transaction management information ### Authorization request With the M.O.T.O. configuration, Fabrick allows separating the authorization and capture phases. If activated, the first transaction is limited to the authorization request, otherwise Fabrick captures the amount immediately after authorization. The plugin works according to the chosen configuration described in the *Plugin configuration* section. ### Capture With the capture operation, the authorized total is permanently transferred to the merchant's bank account. To use it, the M.O.T.O. function must be configured so that it is separated from the authorization. With this configuration, Magento creates an order and during payment the amount is held through the authorization operation (the merchant receives an email from Fabrick). When the invoice is requested, Magento requests Fabrick to capture the authorized amount, which proceeds and sends an email to the merchant. The operation can be performed through the Magento backend (from *Sales > Orders*), selecting the relevant order, pressing **View** and then **Invoice** from the top right panel. In the window that opens, select **Capture Online** and then **Submit Invoice**. ![Magento 2](https://docs.fabrick.com/en/assets/images/magento-2-12-2-708335b231f09fb9e664b09794dd581d.png) ### Cancellation Cancellation can be requested for an authorized but not yet captured transaction, and the M.O.T.O. function must be set with the separation of authorization and capture. The operation can be performed through the Magento backend (from *Sales > Orders*), selecting the relevant order, pressing **View** and then **Cancel** from the top right panel. ![Magento 2](https://docs.fabrick.com/en/assets/images/magento-2-13-19cea554c37e4a03a8d59d1818fb50e5.png) ### Refund It can only be requested on already captured payments. From a fiscal standpoint, it involves a charge to the merchant and a credit to the buyer's card. A transaction can be refunded totally or partially multiple times, up to the total payment amount. On Magento, a refund is performed through the backend (from *Sales > Orders*), selecting the order and pressing **View**. Then, enter the **invoices** menu and select the invoice linked to the order. From the invoice, select **Credit Memo**. ![Magento 2](https://docs.fabrick.com/en/assets/images/magento-2-14-87853ef6470ab2ba9691a6ab9ed1968f.png) Select the quantities of the products you wish to refund. ![Magento 2](https://docs.fabrick.com/en/assets/images/magento-2-15-1-78e05754d637fa040c04bb340f1716ae.png) Finally, after deciding whether to refund shipping costs or other details, press "Refund", as shown below. ![Magento 2](https://docs.fabrick.com/en/assets/images/magento-2-16-3716d286a9b474109acc6b4178b96ea2.png) ## MOTO management Depending on the configuration on the plugin or on the Fabrick merchant back office, there are three possible scenarios: - If you want Fabrick to capture the transaction, you need to set **MOTO: Unify transaction** on the Fabrick merchant back office. On the Magento side, the action to set is **Authorization** and the Capture via Magento order page can only be **offline** (for invoice generation only). - If you want Magento to capture the transaction, you need to set **MOTO: Separate** on Fabrick. After doing so, there are two options: - On the Magento side, the action to set is **"Authorization"** if you want to perform a manual Capture via the Magento order page. In this case, the Capture via Magento order page can be **offline** (for generating the invoice only without financially capturing the transaction), or **online** (for generating the invoice and financially capturing the transaction). In the case of offline capture, the financial settlement must be done from the Fabrick dashboard. - On the Magento side, the action to set is **"Authorization and capture"** if you want Magento to financially capture the transaction immediately, and immediately generate the invoice. In this case, the Capture via Magento order page **must not** be managed because the transaction is already captured and the invoice generated. ## LOG files The operation logs are available in the **`debug.log`** file, in the **`/var/log`** path. ## CRON Job Leveraging the CRON Job already present in Magento, the Ecommerce Sella plugin can: 1. Handle the **Waiting(XX)** status returned by certain payment methods that do not immediately return an OK or KO upon order confirmation 2. Handle the pending status from **Riskified**, which in some circumstances does not immediately approve or reject the transaction, but requires more time for fraud analysis ## Compatible versions The plugin is compatible with: - Adobe Commerce (cloud): 2.4 - Adobe Commerce (on-prem): 2.4 - Magento Open Source: 2.4 All compatibility tests were conducted on the most recent versions of Adobe Commerce available for the compatible release lines at the time the extension was submitted.