Payment Gateway International

Coming soon

Coming soon

Latest version: SIBS plugin v2.3.1 (24/07/2023)

Compatible with:

• PHP: 7.2 – 7.4
• Magento: 2.3.7 – 2.4.4

This page provides a comprehensive guide on how to install, configure, and use SIBS Payments plugin for Magento. The plugin seamlessly integrates with your Magento store, allowing you to securely process payments using your customers’ preferred payment methods.

Benefits

This type of integration offers several key benefits for businesses looking to streamline their payment processing and improve the overall customer experience:

Payment Methods: Accept payments with VISA and Mastercard, BLIK and PayByLink.

 

Embedded Payment Form: PCI DSS-compliant form, so you can focus only on selling.

 

Dynamic 3D Secure 2 authentication: Frictionless cardholder authentication with improved security for online transactions.

 

Tokenization: Your customers can save their credit card details for faster checkouts.

Before you start

Before installing the plugin to accept payments, ensure that during the onboarding process, you have received the necessary credentials to your email:

• Terminal Code
• Bearer Token
• Client ID

In the next step, we will see how you can get the SIBS WebHook Secret.

Installation guide

Step 1: Install the plugin

Step 2: Get Webhook secret

Step 3: Access the plugin settings

Step 4: Insert your authentication credentials

Step 5: Customize your payment options

Step 1: Install the plugin

1. You will receive the .zip file with the necessary files from your Account Manager.
2. Installing the plugin requires some technical knowledge. If you are comfortable dealing changing your webhosting settings and accessing your server, you can download the technical guide here.

Step 2: Get Webhook secret

To complete the authentication, you will need to configure the WebHook secret at your SIBS Backoffice. But first you will need to get the WebHook URL which will be used to input at the SIBS Backoffice.

1. At your store, in the site menu go to Orders > SIBS (status)
2. Copy the WebHook URL
3. Follow the WebHook guide (How to setup WebHooks – SIBS Pay) and use this WebHook URL.
4. Copy the WebHook secret generated and keep it for now.

Step 3: Access the plugin settings

After installing, and whenever you need to access your shop authentication configurations or make changes in your shop’s payment options, access the plugin configuration.

1. Go to Stores > Configuration

2. Click on the SALES option that appears and then Payment Methods.

3. You can access the SIBS plugin configuration by clicking Configure in the next panel.

Step 4: Insert your authentication credentials

At this step you will input the information you got mentioned at Before you start and the Step 2: Getting WebHook secret from the Install Plugin guide.

(SIBS Environment will be set to LIVE)

Step 5: Customize your payment options

SIBS plugin for Magento supports a range of popular payment methods, including Card (VISA, Mastercard) BLIK (Poland) and PayByLink.

1. Go to the plugin settings (See Step 2)
2. Below the General Configuration you can find the configurations for each payment method.

Cards

Besides being able to activate or deactivate this payment method, in the SIBS Cards configuration you can select which card types you accept and will be displayed in the checkout page.

BLIK

BLIK is a popular mobile payment method in Poland that allows customers to make payments using their unique six-digit code generated on their mobile device. The code is entered at the point of sale (your eCommerce store) making BLIK a fast, secure, and convenient payment solution.

At the BLIK configuration page you can activate or deactivate the payment method. (Enabled)

The remaining fields should be left blank or default.

PayByLink

At the PayByLink configuration page you can activate or deactivate the payment method. 

The remaining fields should be left blank or default.

Latest Version: SIBS Plugin v1.1.6 (19/07/2023)

Compatible with:

• PHP: 7.2 – 8.1
• Prestashop: 1.7.6 – 1.7.8.8

This page provides a comprehensive guide on how to install, configure and use SIBS Payments plugin for Prestashop. This plugin seamlessly integrates with your Prestashop store, allowing you to securely process payments using your customers’ preferred payment methods.

Benefits

This type of integration offers several key benefits for business looking to streamline their payment processing and improve the overall customer experience:

Payment Methods: Accept payments with VISA and Mastercard, BLIK and PayByLink.

 

Embedded Payment Form: PCI DSS-compliant form, so you can focus only on selling.

 

Dynamic 3D Secure 2 authentication: Frictionless cardholder authentication with improved security for online transactions.

 

Tokenization: Your customers can save their credit card details for faster checkouts.

 

OneClick: Effortless online payments with just one click for returning customers.

 

Multilanguage: English and Polish currently supported.

Before you start

Before installing the plugin to accept payments, ensure that during the onboarding process, you have received the necessary credentials to your email:

• Terminal Code
• Bearer Token
• Client ID
• SIBS WebHook Secret

Once you have these, you will be able to easily install the plugin on your platform.

Keep your credentials confidential to maintain security of your transactions.

Installation guide

Step 1: Install the plugin

Step 2: Access the plugin configuration

Step 3: Payments general settings

Step 4: Customize your payment options

Step 1: Install the plugin

1. You will receive a .zip file with the SIBS plugin during your onboarding process.
2. Login at your Prestashop admin area (https://yourwebsite/myadmin/) at the sidebar menu and go to Module Manager and then click Upload a Module and select the .zip file provided at the onboarding process.

Step 2: Access the plugin configurations

After installing, and whenever you need to make changes in your shop’s payment options, you can always access the plugin configuration going to the Modules section at the sidebar menu and go to Module Manager.

After scrolling to the payment modules section, you can find SIBS plugin. Press Configure to access the configuration page.

Step 3: Payments general settings

After scrolling to the payment modules section, you can find SIBS plugin. Press Configure to access the configuration page.

1. At the general settings tab you can insert the basic authentication and technical parameters you have obtained at the onboarding stage (Before you start).
2. Fill the form with the given credentials.
3. Press Save configuration to apply the changes

Step 4: Customize your payment options

Our Prestashop payment gateway plugin supports a range of popular payment methods, including Card (VISA, MasterCard), BLIK (Poland), and PayByLink. These payment methods offer secure and convenient ways for customers to make purchases online. With our plugin, you can easily configure payment settings to accept these payment methods.

Below the General Settings window you can find the configurations for each of our payment methods.

Cards

Besides being able to activate or deactivate this payment method, in the Credit Card configuration you can select which card types you accept and will be displayed in the checkout page.

BLIK

Activate or deactivate BLIK and assign the position that this method will appear in the checkout page. Ex. ‘1’ will mean this method will be the first, ‘2’ the second, etc.

PayByLink

Activate or deactivate PayByLink and assign the position that this method will appear in the checkout page. Ex. ‘1’ will mean this method will be the first, ‘2’ the second, etc.

Latest version: SIBS Plugin v2.5.0 (19/07/2023)

Compatible with:

• PHP: 7.2 – 8.1
• WordPress: 5.9 – 6.2.1
• WooCommerce: 7.4.1 – 7.7.0

This page provides a comprehensive guide on how to install, configure, and use SIBS Payments plugin for WooCommerce. The plugin seamlessly integrates with your WooCommerce store, allowing you to securely process payments using your customers’ preferred payment methods.

Benefits

This type of integration offers several key benefits for businesses looking to streamline their payment processing and improve the overall customer experience:

Payment Methods: Accept payments with VISA and MasterCard, BLIK and PayByLink.

 

Embedded Payment Form: PCI DSS-compliant form, so you can focus only on selling.

 

Dynamic 3D Secure 2 authentication: Frictionless cardholder authentication with improved security for online transactions.

 

Tokenization: Your customers can save their credit card details for faster checkouts.

Before you start

Before installing the plugin to accept payments, ensure that during the onboarding process, you have received the necessary credentials to your email:

• Terminal Code
• Bearer Token
• Client ID.

In the next step, we will see how you can get the SIBS Webhook Secret.

Keep your credentials confidential to maintain security of your transactions.

Installation guide

Step 1: Install the plugin

Step 2: Access the plugin settings

Step 3: General settings

Step 4: Customize your payment options

Step 1: Install the plugin

1. You will receive a .zip file with the SIBS plugin during your onboarding process.
2. Log into your WordPress administration area (default at https://yourwebsite/wp-admin/)
   and go to Plugins in the side menu > Add New > Upload Plugin:

3. Click Choose File, select the SIBS plugin’s .zip file. Then click Install Now:

Step 2: Access the plugin settings

After installing, and whenever you need to make changes in your shop’s payment options, access the plugin configuration.

1. Go to Plugins in the side menu > Installed Plugins.
2. Find the plugin SIBS Payment Gateway for WooCommerce and click General Settings to introduce your credentials or click Payments to configure your payment methods:

Step 3: General settings

1. Enter General Settings tab (see Step 2: Access plugin settings).
2. Fill in the form with the credentials received during onboarding (see Before you start).
3. Send to your Account Manager the Webhook URL you can find below the SIBS WebHook Secret input form.
4. You should then receive the associated WebHook secret you can then paste on this field.
5. Click Save Changes:

Step 4: Customize your payment options

SIBS plugin for WooCommerce supports a range of popular payment methods, including cards (VISA, Mastercard), BLIK (Poland), and PayByLink.

1. Enter Payments tab (see Step 2: Access plugin settings).
2. Click Manage to access the main configurations for each payment method.

Cards

Besides being able to activate or de-activate this payment method, in the SIBS Cards configuration you can select which card types you accept and will be displayed in the checkout page:

BLIK

BLIK is a popular mobile payment method in Poland that allows customers to make payments using their unique six-digit code generated on their mobile device. The code is entered at the point of sale (your ecommerce store) making BLIK a fast, secure and convenient payment solution.

At the BLIK configuration page you can activate or deactivate the payment method.

PayByLink

At the PayByLink configuration page you can activate or deactivate the payment method.

Our Plugins are fully PCI compliance solutions.

Last updated: June 16, 2023

Supported version: 7.4.1 – 7.7.0

Check installation guide

Last updated: June 16, 2023

Supported version: 1.7.6 – 1.7.8.8

Check installation guide

Last updated: June 16, 2023

Supported version: 2.3.7 – 2.4.4

Check installation guide

Last updated: June 16, 2023

Supported version: Coming soon

Check installation guide

This page provides an overview of the available customization options that allow you to modify and personalize the Payment Form, empowering you to enhance your customers’ experience.

Supported browsers

The Payment Form is a payment service of utmost importance and demands the latest security measures. As a result, we endorse all major web browsers that are still receiving official security updates and are actively maintained, such as:

• Google Chrome
• Microsoft Edge
• Mozilla Firefox
• Opera
• Safari.

Lite customization

Adjust the page colors and font to your desired specifications to align with your brand scheme.

To achieve this, you should incorporate the {formStyle} when creating the payment form.

formStyle -> spg-style=”{formStyle}”

"transaction": {
 "layout": 'default',
 "theme": 'default',

 "color": {
 "primary": "",
 "secondary": "",
 "border": "",
 "surface": "",
 "header": {
 "text": "",
 "background": ""
 },

 "body": {
 "text": "",
 "background": ""
 }
 },
 "font": ""
}

The attribute attr.spg-style is a JSON string, optional allowing you to customize the payment form:

You can find below a visual example of different colors being applied to the payment form.

Full customization (white label)

To take customization to the next level and ensure perfect alignment with your brand’s design, the full customization option offers numerous advantages.

Follow the instructions below to implement the Payment Form and start accepting payments seamlessly.

Step 1: Create an order

This step describes how to create an order once your shopper is ready to pay.

The available endpoint destination URL:

Regarding the required data to create the order, the process is simple, and it requires only a few actions:

Action 1: Define the header and add merchant and customer information

Action 2: Add transaction information to your order

Action 3: Complete your order including additional and optional information

Action 1: Define the header and add merchant and customer information

Check below the full description of the required data to start creating your order.

Header parameters

Request parameters

For logged in users the CustomerName and CustomerEmail elements are Mandatory. This will prevent the user from having to fill them in again in the payment form.

Action 2: Add transaction information to your order

Now, it is time to include your transaction information based on the payment methods you want to render in your paywall.

Request parameters: application/json

Check how to perform a one-time purchase or a pre-authorised capture.

Action 3: Add transaction information to your order

In this step, we show you that there is plenty of optional information that you add to complete your order creation. Please check below the additional information based on some use cases:

Here is an example of how to create an order.

Request body:

{
 "merchant": {
 "terminalId": 24,
 "channel": "web",
 "merchantTransactionId": "Order Id: 5hraff455o",
 "transactionDescription": "transaction short description",
 "shopURL": "https://mytest.e-shop.pl/"
 },
 "transaction": {
 "transactionTimestamp": "2023-05-16T10:33:43.587Z",
 "description": "transaction statement description",
 "moto": false,
 "paymentType": "PURS",
 "amount": {
 "value": 50.5,
 "currency": "PLN"
 },
 "paymentMethod": [
 "CARD",
 "BLIK",
 "PBLKV"
 ]
 }
}

Step 2: Create the payment form

To create the payment form you just need to add the following lines of HTML/Javascript to your page and populate the following variables that you got in response from the first step:

• The checkout’s transactionID that you got in the response from the first step:

<script src="https://stargate-cer.qly.site1.sibs.pt/assets/js/widget.js?id={transactionID}"></script>

The formContext that you get in response from the first step and a formConfig:

<form class="paymentSPG" spg-context="{formContext}" spg-config="{formConfig}"></form>

The formConfig is necessary for you to be able to create the form correctly.

formConfig -> spg-config=”{formConfig}”

{
 "paymentMethodList": [],
 "amount": {
 "value": 50.50,
 "currency": "PLN"
 },
 "language": "en",
 "redirectUrl": ""
}

The attribute attr.spg-config is a JSON in a string format with the follow parameters:

You also have the option to add a formStyle to personalize your payment form. For more in-depth information, please go to Customized Form.

After the payment has been processed, a page displaying the transaction status is presented, and the customer is then redirected to the redirectUrl defined.

You can find the default look and feel of the Payment Form below, where the customers can seamlessly enter their payment details and complete the transaction:

Step 3: Get the payment status

You can check the status of your transaction making a GET request.

GET {transactionID}/status

Request URL:

https://stargate-cer.qly.site1.sibs.pt/api/v1/payments/{transactionID}/status

Request Headers:

Authorization: ‘Bearer <AuthToken>’
X-IBM-Client-Id: ‘<ClientId>
Content-Type: application/json

Our Payment Form solution provides a secure and PCI-compliant way for merchants to accept payments on their website. Customers enter their payment information directly into our payment form, and we handle the payment processing.

Payment Form Integration is the best for merchants who:

• Want to be PCI-compliant.
• Want a fully secured and developed payment form.
• Want to prive an additional payment option alongside their existing integration.

Benefits

By using Payment Form Integration, you can enjoy the following benefits:

Tailored White Label solution to match your website’s design.

 

Secure payment processing for Cards, Pay by Link, BLIK, and other payment methods.

 

Simplified compliance with an iframe configuration that ensures customer payment data never touches your website.

 

Ability to accept a wide range of payment methods without the need for manual API requests.

 

No need to update your code for future payment methods.

How it works

Here’s how Payment Form works:

1. Embed the Payment Form into your website.
2. Customers enter their payment details directly on your checkout page.
3. Our system processes the payment information and handles the payment processing for you.
4. You receive a status update for the payment method used.

To get started with Payment Form, make sure to follow the necessary steps outlined in our integration guide and have your API and client keys ready.

Before you start

Ensure that during the onboarding process your Account Manager shared with you the necessary credentials:

• Terminal Code
• Bearer Token
• Client ID

Once you have these, you will be able to integrate the payment form.

Keep your credentials confidential to maintain security of your transactions.

Use our APIs to receive payments and create your own payment form to gain complete control over the appearance and user experience of your checkout page. Follow the instructions below to start accepting payments.

Step 1: Create an order

This step describes how to create an order once your shopper is ready to pay.

The available endpoint destination URL:

Regarding the required data to create the order, the process requires only a few actions:

Action 1: Define the header, add merchant and customer information

Action 2: Add transaction information to your order

Action 3: Complete your order with additional and optional information

Action 1: Define the header, add merchant and customer information

Check below the full description of the required data to start creating your order.

Header parameters

Request parameters

Action 2: Add transactional information to your order

Now it is time to include your transaction information based on the payment methods you want to render in your paywall.

Request parameters: application/json

Check how to perform one-time purchase or a pre-authorized capture.

Action 3: Complete your order including additional and optional information

In this step, we show you that there is plenty of optional information that you add to complete your order creation. Please check below the additional information based on some use cases:

Here is an example of how to create an order:

Request body:

{
 "merchant": {
 "terminalId": 24,
 "channel": "web","merchantTransactionId": "Order Id: 9bzraklk4v",
 "transactionDescription": "transaction short description",
 "shopURL": "https://mytest.e-shop.pl/"
 },
 "transaction": {
 "transactionTimestamp": "2023-05-15T20:11:11.488Z",
 "description": "transaction statement description",
 "moto": false,
 "paymentType": "PURS",
 "amount": {
 "value": 50.5,
 "currency": "PLN"
 },
 "paymentMethod": [
 "CARD",
 "BLIK",
 "PBLKV"
 ]
 }
}

Step 2: Get the response

The response includes a statusMsg, a transactionID, a transactionSignature and the list of available paymentMethodList that you can display.

Response example:

{
 "returnStatus": {
 "statusCode": "000",
 "statusMsg": "Success",
 "statusDescription": "string"
 },
 "transactionID": "42f59038f3f14e618d091da8bf3b717e9999",
 "transactionSignature": "42f59038f3f14e618d091da8bf3b717e9999",
 "amount": {
 "value": 50.50,
 "currency": "PLN"
 },
 "merchant": {
 "terminalId": 47215,
 "channel": "web",
 "merchantTransactionId": "5351136",
 "transactionDescription": "string",
 "shopURL": "string",
 "websiteAddress": "string"
 },
 "paymentMethodList": "",
 "tokenList": []
}

The response contains a statusMsg that can assume different values:

Step 3: Make a payment

After you create and submit the order with the shopper’s payment details, and he chooses to pay with a payment method that requires a redirection, you need to make a payment request to SIBS Gateway.

Check the instruction on how to make payment with each type of payment method: