Straal for Magento 2.

# Overview

This plugin allows you to accept credit card and pay-by-link payments on your Magento enabled online store. It takes advantage of Straal Checkout - a hosted payment page provided by Straal. Straal takes care of all the technical and regulatory details so that you can focus on running your business.

The Straal plugin for Magento gives you access to the card and pay-by-bank payments. In addition, payments made using the plugin are synchronised with the Straal Kompas reporting system, where you can track transaction history.

# Supported versions

The latest version for Magento version 2.4.0 or later, is available on GitHub(opens new window)

We do not recommend customising the plugin as it may be more challenging to update. Create an issue on GitHub if you want to suggest a new feature for the plugin Issues(opens new window)

# Key features

  • Accept credit card payments.
  • Accept pay-by-bank payments (bank transfers via links).
  • Customize how the payment method is displayed (title, description).
  • Test payments with sandbox mode.
  • Receive automatic order status updates when customer finalises the payment.
  • Debug technical issues with automatic logging.

# Getting started

Before you activate the plugin, make sure:

  • You have signed an agreement with Straal, and your account manager confirmed that you could start processing payments. Reach out to our sales team(opens new window) and learn how Straal can help grow your e-commerce business.
  • You have access to a working API Key- ii will be necessary to authenticate the plugin in Straal Gateway. Then, you can generate it in Straal Kompas(opens new window) .

Generate api key

# Payment flow from the customer perspective

  1. Your customer starts the checkout process. They fill out all the necessary details to fulfil the order and choose "Straal" as the payment option (you can change this name in the plugin settings).
  2. When the customer clicks on the "Pay" button, the Straal Magento plugin automatically redirects them to the Straal Checkout page.
  3. The customer fills in payment details (such as credit card number) in a secure, PCI certified environment and completes their payment.
  4. Straal Gateway processes the payment and displays the payment confirmation page to the customer.
  5. Finally, the customer is redirected back to your website, where they can see the order confirmation page.

# Plugin installation

  1. Download this repository as a .zip file from GitHub(opens new window)

Download Magento plugin from Github

  1. Unzip the downloaded file on your computer.
  2. Connect to your FTP server and copy the unzipped content to the app/code/straal directory of your Magento 2 shop. If there is no "code" directory, create one.

Copy unziped plugin to Magento server

  1. After copying the files to the Magento server from the console, run the following command in the shell (sshcommand) from the website root folder.
php bin/magento module:enable Straal_Payment
php bin/magento setup:upgrade
php bin/magento cache:flush


Run command in shell form website root

# Activate plugin in Magento admin panel

  1. Open your Magento admin panel.
  2. Navigate to Magento > Stores > Settings > Configuration > Sales > Payment Methods.
  3. Click on "Straal".

Open Magento panel go to plugin

  1. Configure: API Key, notifications username and password (see "Notifications" below).
  2. (optional) Configure: title, description, sandbox API Key (see "Testing" below).
  3. Check "Enable Straal Checkout" and click on "Save changes".

Parametrize Magento plugin

# Notifications

Notifications from Straal allow for automatic payment status updates for your orders. We highly recommend configuring them.

  1. Go to Straal Kompas(opens new window) and log in. If you don't have access contact our support team
  2. Navigate to "Notification endpoints".
  3. Click on "Create".
  4. Enter URL that is provided in Straal Magento admin panel in plugin settings.

Copy your URL (URL address is automatically generated by the plugin):

Source of notification url

  1. Enter username and password you wish to use and create the endpoint.
  2. Go back to your website and enter the same username and password in Straal Magento plugin settings and save changes.

That's it, you should now receive order status updates.

Create notification endpoint

# Testing

Straal provides every customer with a test account to test the integration before accepting live transactions. You can enable test mode for the Straal Magento plugin in the settings by checking the "Enable Straal sandbox mode". Once enabled, all payments will be processed using the Sandbox API key that should be generated for the test account provided by Straal. The test API and test notification endpoint can be found in the Komapass test account which you can be provided by our support.

# Support

Any suggestions or reports of technical issues are welcome! Contact us via email [email protected]