Straal for PrestaShop.

# Overview

This plugin allows you to accept credit card and pay-by-bank payments (via link) on your PrestaShop 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 PrestaShop gives you access to card and pay-by-bank payments (via link). Furthermore, payments are synchronised with the Straal Kompas reporting system, where you can track transaction history.

# Supported versions

The latest version optimized for Prestashop 1.6.x and 1.7.x 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 link).
  • 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 PrestaShop 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 GitHub(opens new window)

Download PrestaShop plugin from Github

  1. Login to your PrestaShop admin panel, go to Module manager > Upload a module and add previously downloaded zip file.

Install plugin in Prestashop admin panel

# Activate plugin in PrestaShop admin panel

  1. Go to Payment Methods find Straal - Payment Gateway plugin and select "Configure"

Activate plugin

  1. Set up API Key and Notification endpoint

Activate 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 PrestaShop 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 PrestShop 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 PrestaShop 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]