Smart2Pay Plugins

Do you already have an integration with one of the bellow plugins? Please click on it to learn more about how to configure your module and to sign-up with us.

Smart2Pay Environments

Smart2Pay offers 3 environments that you can use to interact with our payment platform.

Demo – you should start in Demo environment where all the available payment methods are activated by default and you can use to test our plugin right away. No activation is required. You can test various payment flows for more than 150 payment methods. The order status does not update in this environment, you need to use Test and Live environments for an end to end testing.

Test – Once you are familiar with payment flows you should start the integration and testing phase using the test platform https://dashboardtest.smart2pay.com. You will receive an e-mail from our merchant integration team with more details such as your test MID and instructions on how to generate the test signature and setup the notification URL where you will receive payment status change notifications so your orders are correctly updated once the payment flows are completed.

Live – As soon as the development and testing phase are successfully completed you will need to follow the same steps for integration on the live platform: https://dashboard.smart2pay.com.

You can always contact our Merchant Integration Team to request additional information about our services at: support@smart2pay.com.

Smart2Pay Magento Plugin

Magento

Smart2Pay Magento Plugin: connects your Magento store to GlobalPay, the latest payment platform of Smart2Pay. Below you will find the necessary details for Magento websites administrators on how to install and configure the plugin on your Magento store.

Magento Plugin Version and Compatibility List

Current stable plugin version of Magento is 1.1.16b. Smart2Pay plugin is compatible with the following Magento versions: 1.5, 1.6, 1.6.1, 1.6.2.0, 1.7, 1.8, 1.8.1, 1.9, 1.9.1.0, 1.9.1.1, 1.9.2.1.

Also, we have released a payment plugin that is compatible with Magento 2.0 version. For more details about the configuration of the new plugin, please go to Smart2Pay Magento 2.0 Plugin Configuration.

Smart2Pay Magento Plugin Installation

After downloading the archive from GitHub, you can install our plugin by following these steps:

  1. Log in to the administration area of Magento and then select System-> Magento Connect->Magento Connect Manager.
  2. Image 1 - Magento Connect Manager Menu

  3. Copy/paste the extension key http://connect20.magentocommerce.com/community/Smart2Pay and click ‘Install’.
  4. Image 2 - Magento Connect Manager

Smart2Pay Magento Plugin Configuration

The configurations for the Smart2Pay Magento plugin can be found in the administration area of Magento under: System->Configuration menu, section Sales->Payment Methods-> Smart2Pay Payment Module.

Note: If the Smart2Pay Payment Module is not visible, please make sure that the module output is enabled from: System->Configuration->Advanced->Advanced->Disable Modules Output->Smart2Pay_GlobalPay.

Checkout below the available options of configuration for the Smart2Pay Magento plugin:

Smart2Pay Payment Module Configuration

1 General settings
General Settings
Field Description Type Sample
Enabled Defines whether the Smart2Pay payment module is active or not. If it is active it will appear in the payment method lists. Boolean Yes
Environment The environment to which the plugin points to. If Test is selected then the Post URL Test, Signature Test and MID Test will be used when making the payment. If Demo environment is selected, shop will create transactions on a predefined MID, SiteID and Signature combination, just so that you can see an end-to-end transaction flow. This will not require any registration on your behalf on our test or live platforms. However, keep in mind that your shop will not receive background notifications about order updates so not all details and functionality for an order will be available / visible. [Test, Demo, Live] Test
Post URL Live The URL of GlobalPay API live environment. String https://api.smart2pay.com
Post URL Test The URL of GlobalPay API integration environment. String https://apitest.smart2pay.com
MID Live The Merchant ID for the live environment. Create an account at https://dashboard.smart2pay.com The account will be activated by Smart2Pay Merchant Integration Team  and you will receive an e-mail containing this MID. Integer
MID Test The Merchant ID for the live environment. Create an account at https://dashboardtest.smart2pay.com. The account will be activated by Smart2Pay Merchant Integration Team and you will receive an e-mail containing this MID. Integer 1045
Site ID If you are managing multiple stores you can use a separate SiteID for each website, with different Signature, ReturnURL and NotificationURL. Please contact support@smart2pay.com for more details on how to setup a multistore configuration. Integer 30112
Signature Live The signature that will be used to compute the hash for live environment. You can set up your signature for production environment at: https://dashboard.smart2pay.com, Configuration Tab->Signature. String 0
Signature Test

The signature that will be used to compute the hash for test environment. You can set up your signature for test environment at: https://dashboard.smart2pay.com. String fb1159ed-3359
Return URL An URL where the customer will be redirected after the payment process ends. It is advisable to include the path to the smart2pay/feedback action which displays a friendly message to the user depending on the redirection status of the transaction. This field is filled automatically by plugin at install time. If however, this URL doesn’t work for you, you can manually correct it in a similar way which is presented in Sample column. String http://www.merchant.com/index.php/globalpay/index/info/
Title This will be displayed to the customers in the checkout process when selecting from possible payment methods. String Alternative payment methods
Skin ID Specify the skin ID. The skins can be created in the Online Skin Editor available in the Merchant Dashboard or by uploading a CSS file. Integer 6
[Debug form] For integration/debugging purposes only. If set to ‘Yes’, a form with the values sent in the initial POST to GlobalPay will be displayed prior to the actual POST. Boolean No
2 Methods display settings
Methods Display Settings
Field Description Type Sample
Display surcharge fee to client If set to yes, it shows the surcharge amount provided in shop’s default currency. Yes
Methods display mode By default, method icon images will be shown (Logo). You have the option to display the payment methods as text or as logo and text. Boolean Logo
Show methods in grid By default, methods will be displayed as a two columns table, having payment method’s logo or name and description. When set to yes, description is omitted, and columns number can be specified bellow. Boolean No
Grid column number The number of columns for the grid with logos. Has effect only if Show methods in grid is set to ‘Yes’. Integer 4
Send order number as product description If set to ‘Yes’, the Magento order number will be sent as description. If ‘No’ is selected, the below custom description will be sent. Boolean Yes
Custom product description Specifies a global description that will be sent for all the transactions. String Custom product description
3 Email settings
Email Settings
Field Description Type Sample
Notify customer by email If set to ‘Yes’, the system automatically sends a confirmation email to the customer on success payment notification. Boolean Yes
Payment Confirmation Template The template of the e-mail List GlobalPay Confirmation Template
Send payment instructions on order creation For Bank Transfer and Multibanco SIBS, Magento can send a confirmation email to the customer on order creation with payment details. Boolean Yes
Payment Instructions Template (for Multibanco SIBS) The template of the e-mail containing payment instructions for Multibanco SIBS (PT) payment method. List
Payment Instructions Template (for Bank Transfer) The template of the e-mail containing payment instructions for Bank Transfer payment method. List
4 Order related settings
Order Related Settings
Field Description Type Sample
Create invoice on success If set to ‘Yes’, the system automatically creates an invoice if payment is successfully completed. The invoice is automatically set to ‘paid’. Boolean No
Automate shipping If set to ‘Yes’, the system automatically creates a shipping. Boolean No
New Order status The status of the order after creation. List On Hold
Order status on SUCCESS You should only deliver the goods/services based on the Success notifications. The notifications are received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. The notification URL is in the form: http://www.merchant.com/index.php/globalpay/index/handleResponse. Magento Smart2Pay_GlobalPay Plugin automatically updates the order status according to the received notifications. This configuration defines the status of the order when the payment has been successfully completed and a ‘success’ notification is sent by GlobalPay system. You can release the goods/services in this case. List Processing
Order status on CANCEL The status of the order when a ‘canceled’ notification is sent by GlobalPay system. List Canceled
Order status on FAIL The status of the order when a ‘failed’ notification is sent by GlobalPay system. List Canceled
Order status on EXPIRED The status of the order when an ‘expired’ notification is sent by GlobalPay system. List Canceled
5 Payment flow settings

Payment Flow Settings
Field Description Type Sample
Auto-select GlobalPay payment methods The alternatives payment methods are automatically selected Boolean Yes
Skip payment page If set to ‘Yes’, if all the necessary parameters are sent in the initial POST for a specific payment method, the GlobalPay payment page is skipped and the customer is redirected automatically to the payment method provider. Boolean No
Redirect in IFrame If set to ‘Yes’, GlobalPay will try to keep the payment flow inside the IFrame. Only some payment methods providers support IFrames, for the others the customer will be redirected to the provider in the main window. Boolean Yes
Message Success The message that is displayed at the end of the payment flow when the redirection status is a success. You should only deliver the goods/services based on the success notification received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. The notification URL is in the form: http://www.merchant.com/index.php/globalpay/index/handleResponse. String Thank you, the transaction was processed successfully. After we receive the final confirmation, we will release the goods.
Message Failed The message that is displayed at the end of the payment flow when the customer is redirected with a failed status. String There was a problem processing your payment. Please try again.
Message Canceled The message that is displayed at the end of the payment flow when the customer has canceled the payment. String You canceled the payment.
Message Pending The message that is displayed to the customer when the redirection status is unknown or the customer must take additional actions to complete the payment: e.g. go to the bank and make an offline bank transfer. String Thank you, the transaction is pending. After we receive the final confirmation, we will release the goods.

After the main configuration of the Smart2Pay Payment Module, please activate the payment methods that you plan to use. You have the option to pass the payment method fee to the customer. The fixed amount and/or percentage of the fee can be set in Surcharge column.

Image 4 - Payment method activation

Smart2Pay Magento 2.0 Plugin Configuration

You can download the archive of the Smart2Pay Magento 2.0 Plugin from GitHub.

The configurations for the Smart2Pay Magento 2.0 plugin can be found in the administration area of Magento under: Stores-> Settings -> Configuration menu->section Sales->Payment Methods-> Smart2Pay.

Note: If the Smart2Pay Payment Module is not visible, please make sure that the module output is enabled from: Stores->Settings->Configuration menu->section Advanced->Advanced->Disable Modules Output->Smart2Pay_GlobalPay.

Checkout below the available options of configuration for the Smart2Pay Magento 2.0 plugin:

Smart2Pay Payment Module Configuration

1 Smart2Pay - General settings

Smart2Pay – General Settings
Field Description Type Sample
Enabled Defines whether the Smart2Pay payment module is active or not. If it is active it will appear in the list of payment methods. Boolean Yes
Method Title You can insert a custom title for the payment module. This will be displayed to the customers in the checkout process when selecting from possible payment methods. String Smart2Pay Methods
Environment The environment to which the plugin points to. If Test is selected then the Post URL Test, Signature Test and MID Test will be used when making the payment. If Demo environment is selected, shop will create transactions on a predefined MID, SiteID and Signature combination, just so that you can see an end-to-end transaction flow. This will not require any registration on your behalf on our test or live platforms. However, keep in mind that your shop will not receive background notifications about order updates so not all details and functionality for an order will be available / visible. [Test, Demo, Live] Test
Post URL Live The URL of GlobalPay API live environment. String https://api.smart2pay.com
Post URL Test The URL of GlobalPay API integration environment. String https://apitest.smart2pay.com
MID Live The Merchant ID for the live environment. Create an account at https://dashboard.smart2pay.com. The account will be activated by Smart2Pay Merchant Integration Team and you will receive an e-mail containing this MID. Integer 0
Site ID If you are managing multiple stores you can use a separate SiteID for each website, with different Signature, ReturnURL and NotificationURL. Please contact support@smart2pay.com for more details on how to setup a multistore configuration. Integer 30562
MID Test The Merchant ID for the test environment. Create an account at https://dashboardtest.smart2pay.com. The account will be activated by Smart2Pay Merchant Integration Team and you will receive an e-mail containing the MID. Integer 1045
Signature Live The signature that will be used to compute the hash for live environment. You can set up your signature for production environment at: https://dashboard.smart2pay.com, Configuration Tab->Signature. String  
Signature Test The signature that will be used to compute the hash for test environment. You can set up your signature for test environment at: https://dashboard.smart2pay.com. String 752ae49a-7958
Return URL An URL where the customer will be redirected after the payment process ends. It is advisable to include the path to the smart2pay/feedback action which displays a friendly message to the user depending on the redirection status of the transaction. This field is filled automatically by plugin at install time. If however, this URL doesn’t work for you, you can manually correct it in a similar way which is presented in Sample column. String http://www.yoursite.com/smart2pay/payment/finish/
Skin ID Specify the skin ID. The skins can be created in the Online Skin Editor available in the Merchant Dashboard or by uploading a CSS file. Integer 0
Debug form For integration/debugging purposes only. If set to ‘Yes’, a form with the values sent in the initial POST to GlobalPay will be displayed prior to the actual POST. Boolean Yes
Sort order Sort order will change order of all Smart2Pay payment methods. Integer 0

1 Smart2Pay - Methods Display Settings

Smart2Pay – Methods Display Settings
Field Description Type Sample
Methods display mode By default, method icon images and text will be shown (Logo and Text). You have the option to display the payment methods as text, as logo, or as logo and text. List Logo and Text
Display method description By default, methods will be displayed having payment method’s logo and description. When set to yes, description will be displayed. Boolean Yes
Send order number as product description If set to ‘Yes’, the Magento order number will be sent as description. If ‘No’ is selected, the below custom description will be sent. Boolean Yes
Custom product description Specifies a global description that will be sent for all the transactions. String Custom product description

1 Smart2Pay - Email Settings

Smart2Pay – Email Settings
Field Description Type Sample
Notify customer by email If set to ‘Yes’, the system automatically sends a confirmation email to the customer on success payment notification. Boolean Yes
Payment Confirmation Template The template of the email. List Payment Confirmation
Send payment instructions on order creation For Bank Transfer and Multibanco SIBS, Magento can send a confirmation email to the customer on order creation with payment details. Boolean Yes
Payment Instructions Template (for Multibanco SIBS) The template of the e-mail containing payment instructions for Multibanco SIBS (PT) payment method. List Payment Instructions (SIBS)
Payment Instructions Template (for Bank Transfer) The template of the e-mail containing payment instructions for Bank Transfer payment method. List Payment Instructions (Bank Transfer)

1 Smart2Pay - Order Related Settings

Smart2Pay – Order Related Settings
Field Description Type Sample
Create invoice on success If set to ‘Yes’, the system automatically creates an invoice if payment is successfully completed. The invoice is automatically set to ‘paid’. Boolean Yes
New Order status The status of the order after creation. List Smart2Pay New Order
Order status on SUCCESS You should only deliver the goods/services based on the Success notifications. The notifications are received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. The notification URL is in the form: http://www.merchant.com/index.php/globalpay/index/handleResponse. Magento Smart2Pay_GlobalPay Plugin automatically updates the order status according to the received notifications. This configuration defines the status of the order when the payment has been successfully completed and a ‘success’ notification is sent by the GlobalPay system. You can release the goods/services in this case. List Smart2Pay Success
Order status on CANCEL The status of the order when a ‘canceled’ notification is sent by GlobalPay system. List Smart2Pay Canceled
Order status on FAIL The status of the order when a ‘failed’ notification is sent by GlobalPay system. List Smart2Pay Failed
Order status on EXPIRED The status of the order when an ‘expired’ notification is sent by GlobalPay system. List Smart2Pay Expired

1 Smart2Pay - Payment Flow Settings

Smart2Pay – Payment Flow Settings
Field Description Type Sample
Skip payment page If set to ‘Yes’, if all the necessary parameters are sent in the initial POST for a specific payment method, the GlobalPay payment page is skipped and the customer is redirected automatically to the payment method provider. Boolean Yes
Message Success The message that is displayed at the end of the payment flow when the redirection status is a success. You should only deliver the goods/services based on the success notification received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. The notification URL is in the form: http://www.merchant.com/index.php/globalpay/index/handleResponse. String Thank you, the transaction was processed successfully. After we receive the final confirmation, we will release the goods.
Message Failed The message that is displayed at the end of the payment flow when the customer is redirected with a failed status. String There was a problem processing your payment. Please try again.
Message Canceled The message that is displayed at the end of the payment flow when the customer has canceled the payment. String You have canceled the payment.
Message Pending The message that is displayed to the customer when the redirection status is unknown or the customer must take additional actions to complete the payment: e.g. go to the bank and make an offline bank transfer. String Thank you, the transaction is pending. After we receive the final confirmation, we will release the goods.

After the main configuration of the Smart2Pay Payment Module, please activate the payment methods that you plan to use.

1 Smart2Pay - Select Methods

Smart2Pay Magento 2.0 Payment Flow

  1. The customer adds the product in the shopping cart and Proceeds to checkout.

    1 Checkout Initiation

  2. In the Shipping area the customer needs to enter a valid email address that will be used for order confirmation. Also, the customer needs to provide a delivery address. The mandatory filed are marked with an asterisk sign. The customer can create an account after the checkout.

    1 Shipping Address

  3. After choosing a delivery address, the customer has to select a shipping method.

    1 Shipping Methods Selection

  4. Depending on the billing country of the customer, the activated methods are shown in the checkout process in the Payment step, Smart2Pay Methods section. After choosing the payment method, the customer can click Place the Order button.

    1 Payment Method Selection

  5. After selecting the preferred payment method the customer needs to confirm the order by clicking on the Submit button.

    1 Order Confirmation

  6. After order confirmation the customer is redirected to the chosen payment method provider where he enters the necessary details of the payment.

    1 Smart2Pay payment page

  7. The customer is redirected to the provider’s confirmation page. All the payment details are provided here and the customer has the posibility to print them.

    1 Smart2Pay payment page with success status

  8. Upon completion of the payment flow, the customer is redirected back to your website.

    1 Return page when the redirection status is a success

Smart2Pay Magento Payment Flow

  1. In the frontend, depending on the billing country of the customer, the activated methods are shown in the checkout process in the payment information step.

    Image 5 - Checkout process - Payment information

  2. After order confirmation the customer is redirected to the chosen payment method provider where he finalizes the payment.

    Smart2Pay payment page with Redirect in Iframe set to Yes

  3. Upon completion of the payment flow, the customer is redirected back to your website.

    Image 7 - Return page when the redirection status is a success

Smart2Pay OpenCart Plugin

Opencart

Smart2Pay OpenCart Plugin: connects your OpenCart store to GlobalPay, the latest payment platform of Smart2Pay. Below you will find the necessary details for OpenCart websites administrators on how to install and configure the plugin on your OpenCart store.

Smart2Pay OpenCart Plugin Installation

  1. After downloading the archive from GitHub, you need to copy the contents of the archive in your OpenCart installation folder.
  2. In order to install an OpenCart Extension you need to connect to your FTP server and locate your shop on your server. This will be the location in which you installed your store.

    Locate the extension on your local machine that you wish to install and the folders to be uploaded.

    Inside the designated upload folder you will find the folders that need to be uploaded to install the extension.

    To install the extension, simply drag the designated folders into the empty space below the files on your server. The extension folder structure will put the extension files in the required locations. Make sure to drag the folders into an empty area below the files on your server to avoid uploading the files into a subfolder.

    For more information about installing OpenCart modules, please check out the following tutorial: https://www.youtube.com/watch?v=eShFC94VYCg.

  3. From OpenCart Back Office go to Extensions -> Modules -> Module List -> Module Name, where you can install the new plugin, as shown in the below picture.
  4. Image 1 - Smart2Pay Payment Plugin Installation

Smart2Pay OpenCart Plugin Configuration

The configurations for the Smart2Pay OpenCart plugin can be found in the administration area of OpenCart under: Extensions -> Payments menu -> Payment Method section -> Smart2Pay Payment Module. Once you find the Smart2Pay plugin click on the Edit button and go to Module Settings, where you can edit the Smart2Pay plugin, as shown in the below picture.

Smart2Pay plugin contains the generic configurations that are necessary to connect your store with the payment platform. You will also need to install and activate the payment methods that you intend to use: e.g. Smart2Pay Paysafecard, Smart2Pay UKash, Smart2Pay iDEAL etc.

Please make sure that Smart2Pay module is enabled from Extensions -> Payments menu, Payment Method section -> Smart2Pay -> Edit (Enabled set to yes).

Checkout below the available options of configuration for the Smart2Pay OpenCart plugin:

Smart2Pay Payment Module Configuration

Image 1 - Module settings

Field Description Type Sample
Enabled Defines whether the Smart2Pay payment module is active or not. If it is active it will appear in the payment method lists. Boolean Yes
Environment The environment to which the plugin points to. If Demo is selected you don’t have to provide other MID or signature. If Test is selected then the Post URL Test, Signature Test and MID Test will be used when making the payment. [Demo, Test, Live] Test
Post URL Live The URL of GlobalPay API live environment. String https://api.smart2pay.com
Post URL Test The URL of GlobalPay API test integration environment. String https://apitest.smart2pay.com
Signature Live The signature that will be used to compute the hash for live environment. You can set up your signature at: https://dashboard.smart2pay.com, Configuration Tab->Signature for live environment. String Fb4235ed-xxxx
Signature Test The signature that will be used to compute the hash for live environment. You can set up your signature at: https://dashboardtest.smart2pay.com for test environment. String Fb4235ed-xxxx
MID Live

The Merchant ID for the live environment. Create an account from https://dashboard.smart2pay.com The account will be activated by Smart2Pay Operations Team and you will receive an e-mail containing the MID.

Integer 1045
MID Test The Merchant ID for the test environment. Create an account from https://dashboardtest.smart2pay.com The account will be activated by Smart2Pay Operations Team and you will receive an e-mail containing the MID. Integer 1045
SiteID If you are handling multiple OpenCart websites and you want to use a single MerchantID for all of them, you need to configure multiple websites from GlobalPay Merchant Dashboard, Configuration tab. Integer 40015
Skin ID Specify the skin ID. The skins can be created in the Online Skin Editor available in the GlobalPay Merchant Dashboard or by uploading a CSS file. Integer 6
Return URL An URL where the customer will be redirected after the payment process ends. It is advisable to include the route payment/smart2pay/feedback action which displays a friendly message to the user depending on the redirection status of the transaction. String http://www.merchant.com/ index.php?route=payment/smart2pay/feedback

Image 2 - Module settings

The available options are described in the following table:

Field Description Type Sample
Send order number as product description If set to ‘Yes’, the OpenCart order number will be sent as description. If ‘No’ is selected, the below custom description will be sent. Boolean No
Custom product description Specifies a global description that will be sent for all the transactions. String Cinema ticket
Notify customer by email If set to ‘Yes’, the system automatically sends a confirmation email to the customer on success payment notification. Boolean Yes
Make order visible By default, orders are not visible in the orders list. You can control the moment when an order is confirmed and becomes visible by selecting one of the following options:

–          When initiated: the order is confirmed and made visible when the customer initiates a payment via Smart2Pay.

–          When redirecting to payment page: the order is confirmed and made visible when the customer returns to the ReturnURL.

–          When receiving payment notification: the order is confirmed and made visible when the transaction has a final status from: success, failed, cancelled, expired.

–          When transaction is paid: the order is confirmed and made visible only when the customer paid and the transaction is confirmed by the payment method provider.

Order status when NEW The status of the order when a new order is created. List Pending
Order status when SUCCESS You should only deliver the goods/services based on the success notifications. The notifications are received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. The notification URL is in the form: http://www.merchant.com/index.php?route=payment/smart2pay/callback. OpenCart Smart2Pay GlobalPay Plugin automatically updates the order status according to the received notifications. This configuration defines the status of the order when the payment has been successfully completed and a ‘success’ notification is sent by GlobalPay system. You can release the goods/services in this case. List Processing
Order status when CANCEL The status of the order when a ‘canceled’ notification is received from Smart2Pay’s GlobalPay system. List Canceled
Order status when FAIL The status of the order when a ‘failed’ notification is received from Smart2Pay’s GlobalPay system. List Failed
Order status on EXPIRED The status of the order when an ‘expired’ notification is received from Smart2Pay’s GlobalPay system. List Expired
Skip Payment Page If set to ‘Yes’, if all the necessary parameters are sent in the initial POST for a specific payment method, the GlobalPay payment page is skipped and the customer is redirected automatically to the payment method provider. Boolean Yes
Redirect in Iframe If set to ‘Yes’, GlobalPay will try to keep the payment flow inside the Iframe. Only some payment methods providers support Iframes, for the others the customer will be redirected to the provider in the main window. Boolean No
[Debug form] For integration/debugging purposes only. If set to ‘Yes’, a form with the values sent in the initial POST to GlobalPay will be displayed prior to the actual POST. Boolean No
Sort Order Sort order will change order of all Smart2Pay payment methods.

After saving the main configuration, please go to Payment Methods to activate the payment methods that you plan to use.

The following message will appear:

Image 3 - Payment Method Edit Settings

A list of all Smart2Pay payment methods will appear, making it easier for you to see all the payment methods. From here you can install and activate the payment method that you wish.

Image 4 - Payment method activation

Smart2Pay OpenCart Payment Flow

  1. After the customer adds the product in the shopping cart, he has two options: to Continue Shopping or to go to Checkout.

    Image 5 - Checkout initiation

  2. Depending if the customer is a New or a Returning Customer he has to create an account or only to provide an email and a password to complete the login/sign in process.

    Image 6 - Customer's checkout options

  3. Depending on the billing country of the customer, the activated methods are shown in the checkout process in the Payment Method step.

    Image 7 - Payment method selection

  4. After selecting the proper payment method the customer needs to confirm the order.

    Image 8 - Order confirmation

  5. After order confirmation the customer is redirected to the chosen payment method provider where he finalizes the payment.

    Image 9 - Smart2Pay payment page with Redirect in Iframe set to Yes

  6. Upon completion of the payment flow, the customer is first redirected back to the Smart2Pay return page.

    Image 10 - Smart2Pay return page when the redirection status is a success

  7. The flow is ended when the customer is redirected back to order confirmation page.

    Image 11 - Order confirmation page

OpenCart Payment Status Notification

After receiving the final confirmation from the provider, our server notifies OpenCart about the status change. The plugin handles these notifications and updates the order accordingly. This can be checked in OpenCart backend in Sales -> Orders area -> Order List.

Image 12 - Order list

Smart2Pay Prestashop Plugin

Prestashop

Smart2Pay Prestashop Plugin: connects your Prestashop store to GlobalPay, the latest payment platform of Smart2Pay. Below you will find the necessary details for Prestashop websites administrators on how to install and configure the plugin on your Prestashop store.

Smart2Pay Prestashop Plugin Configuration

The configurations for the Smart2Pay Prestashop plugin can be found in the administration area of Prestashop under: MODULES->Modules-> Smart2Pay->Configure.

Note: Smart2Pay plugin contains the generic configurations that are necessary to connect your store with the payment platform. You will also need to activate the payment methods that you intend to use: e.g. Smart2Pay Paysafecard, Smart2Pay UKash, Smart2Pay iDEAL etc.

Please make sure that Smart2Pay module is enabled from MODULES->Modules->Modules List->Filter by->Installed Modules, Author: Smart2Pay.

Checkout below the available options of configuration for the Smart2Pay Prestashop plugin:

Smart2Pay Payment Module Configuration

Image 1 - Settings

Field Description Type Sample
Enabled Defines whether the Smart2Pay payment module is active or not. If it is active it will appear in the payment method lists. Boolean Yes
Environment The environment to which the plugin points to. If Test is selected then the Post URL Test, Signature Test and MID Test will be used when making the payment. If Demo environment is selected, shop will create transactions on a predefined MID, SiteID and Signature combination, just so that you can see an end-to-end transaction flow. This will not require any registration on your behalf on our test or live platforms. However, keep in mind that your shop will not receive background notifications about order updates so not all details and functionality for an order will be available / visible. [Demo, Test, Live] Demo
Post URL Live The URL of GlobalPay API live environment. String https://api.smart2pay.com
Post URL Test The URL of GlobalPay API integration environment. String https://apitest.smart2pay.com
MID Live The Merchant ID for the live environment. Create an account at https://dashboard.smart2pay.com. The account will be activated by Smart2Pay Operations Team and you will receive an e-mail containing the MID. Integer 0
MID Test The Merchant ID for the test environment. Create an account at https://dashboardtest.smart2pay.com. The account will be activated by Smart2Pay Operations Team and you will receive an e-mail containing the MID. Integer 1045
SiteID If you are handling multiple Prestashop websites and you want to use a single MerchantID for all of them, you need to configure multiple websites from GlobalPay Merchant Dashboard, Configuration tab. Integer 30102
Skin ID Specify the skin ID. The skins can be created in the Online Skin Editor available in the GlobalPay Merchant Dashboard or by uploading a CSS file. Integer 0
Signature Live The signature that will be used to compute the hash for live environment. You can set up your signature at: https://dashboard.smart2pay.com, Configuration Tab->Signature for live environment. String
Signature Test The signature that will be used to compute the hash for test environment. You can set up your signature at: https://dashboardtest.smart2pay.com for test environment. String 38ed98c7-2701
Return URL An URL where the customer will be redirected after the payment process ends. It is advisable to include the route smart2pay/feedback action which displays a friendly message to the user depending on the redirection status of the transaction. This field is filled automatically by plugin at install time. If however, this URL doesn’t work for you, you can manually correct it in a similar way which is presented in Sample column. String http://www.merchant.com/prestashop1609/index.php?fc=module&module=smart2pay&controller=returnHandler&id_lang=1
Force country If this option is selected Country detection will be disregarded.

NOTE: Please be sure all your clients can make payments in selected country.

List Don’t force country

Image 2 - Settings

Field Description Type Sample
Country detection Plugin will try detecting visitor’s country by IP. Country is important for plugin as payment methods are displayed depending on country. Country detection is available when you install and activate Smart2Pay Detection plugin. If you select ‘Yes’ and country detection plugin is not installed, plugin will use as fallback country set in customer’s billing address. Boolean Yes
Fallback country If the country detection fails or set to ‘No’, the module will use the country set in this field (by default will be: country set in billing address). List Country From Billing Address
Send order number as product description If set to ‘Yes’, the Prestashop order number will be sent as description.

If ‘No’ is selected, the below custom description will be sent.

Boolean Yes
Custom product description Specifies a global description that will be sent for all the transactions. String Custom product description
Create invoice on success If set to ‘Yes’, the system automatically creates an invoice if payment is successfully completed. The invoice is automatically set to ‘paid’. Boolean Yes
Notify customer by email If set to ‘Yes’, the system automatically sends a confirmation email to the customer on success payment notification. Boolean Yes
Send payment instructions on order creation For Bank Transfer and Multibanco SIBS, Prestashop can send a confirmation email to the customer on order creation with payment details.

Boolean

Yes

Alter order total based on surcharge

When using a payment method which has a surcharge amount or percent set, order total will be incremented with resulting surcharge amount.

Boolean Yes
Surcharge will use currency (display only) When displaying surcharge amount in checkout flow, it will use currency that is: setup in front-end or used in payment method setup List Setup in front-end

Image 3 - Settings

Field Description Type Sample
Surcharge display amount The display of the surcharge amount in the checkout flow as: separated percent and fixed amount, as sum of percent and fixed amount or as total amount for the order. List Separated percent and fixed amount
New Order Status The status of the order when a new order is created. List Smart2Pay – Awaiting payment
Order status on SUCCESS You should only deliver the goods/services based on the success notifications. The notifications are received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. The notification URL is in the form: http://www.merchant.com/index.php?fc=module&module=smart2pay&controller=replyHandler&id_lang=1. Smart2Pay Prestashop Plugin automatically updates the order status according to the received notifications. This configuration defines the status of the order when the payment has been successfully completed and a ‘success’ notification is sent by GlobalPay system. You can release the goods/services in this case. List Smart2Pay – Awaiting payment
Order status on CANCEL The status of the order when a ‘canceled’ notification is received from Smart2Pay’s GlobalPay system. List Smart2Pay – Canceled payment
Order status on FAIL The status of the order when a ‘failed’ notification is received from Smart2Pay’s GlobalPay system. List Smart2Pay – Failed payment
Order status on EXPIRED The status of the order when an ‘expired’ notification is received from Smart2Pay’s GlobalPay system. List Smart2Pay – Expired payment
Message Success The message that is displayed at the end of the payment flow when the redirection status is a success. You should only deliver the goods/services based on the success notification received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. The notification URL is in the form: http://www.merchant.com/index.php?fc=module&module=smart2pay&controller=replyHandler&id_lang=1. String Thank you, the transaction was processed successfully. After we receive the final confirmation, we will release the goods.
Message Failed The message that is displayed at the end of the payment flow when the customer is redirected with a failed status. String There was a problem processing your payment. Please try again.

Message Canceled

The message that is displayed at the end of the payment flow when the customer has canceled the payment. String You canceled the payment.
Message Pending The message that is displayed to the customer when the redirection status is unknown or the customer must take additional actions to complete the payment: e.g. go to the bank and make an offline bank transfer. String Thank you, the transaction is pending. After we receive the final confirmation, we will release the goods.
Skip payment page If set to ‘Yes’, if all the necessary parameters are sent in the initial POST for a specific payment method, the GlobalPay payment page is skipped and the customer is redirected automatically to the payment method provider. Boolean No
Redirect in IFrame If set to ‘Yes’, GlobalPay will try to keep the payment flow inside the IFrame. Only some payment methods providers support IFrames, for the others the customer will be redirected to the provider in the main window. Boolean No
[Debug form] For integration/debugging purposes only. If set to ‘Yes’, a form with the values sent in the initial POST to GlobalPay will be displayed prior to the actual POST. Boolean Yes

After saving the main configuration of the module, please activate the payment methods that you plan to use.

Image 4 - Payment method activation

Surcharge: Some payment methods may have a surcharge, meaning an extra fee added to the regular cost. The surcharge amount is provided in shop’s default currency.

Priority: If you want to prioritize payment methods when displaying them at checkout, use Priority column. Lower values will display payment method higher on the page.

You can select the countries for which the method is active using the Customize countries button.

Image 5 - Customize countries

Press the Update method button so that the updated list of countries to appear. The countries for which the method is active will have a check mark.

Image 6 - Update method

Changes are saved when you submit the form using the button Update payment methods which is under the table of methods.

Image 7 - Update payment methods

A confirmation message will appear on top of the Configure Smart2Pay module page.

Image 8 - Payment methods updated

Smart2Pay Prestashop Payment Flow

  1. The customer adds the product in the shopping cart and Proceeds to checkout.

    Image 9 - Checkout initiation

  2. Depending if the customer is a New Customer or Already Registered he has to create an account or only to complete the login/sign in process.

    Image 10 - Login - sign in process

  3. After choosing a delivery address, the customer has to select a delivery method.

    Image 11 - Delivery method selection

  4. During the checkout process, the customers see the activated payment methods, depending on country detection settings of Smart2Pay plugin (forced country, country detected by IP or fallback country).

    Image 12 - Payment method selection

  5. After selecting the preferred payment method the customer needs to confirm the order.

    Image 13 - Order confirmation

  6. After order confirmation the customer is redirected to the chosen payment method provider where he finalizes the payment.

    Image 14 - Smart2Pay payment page

  7. Upon completion of the payment flow, the customer is redirected back to your website.

    Image 16 - Return page when the redirection status is a success

Smart2Pay WooCommerce Plugin

Woo Commerce

Smart2Pay WooCommerce Plugin connects your WooCommerce store to GlobalPay, the latest payment platform of Smart2Pay. Below you will find the necessary details for WooCommerce websites administrators on how to install and configure the plugin on your WooCommerce store.

Smart2Pay WooCommerce Plugin Installation

The installation process of the Smart2Pay Plugin requires first downloading the WordPress platform, WooCommerce plugin, and then uploading the Smart2Pay WooCommerce plugin and installing Smart2Pay PHP-SDK.

In order to download the WordPress platform, please go to the download page of https://wordpress.org/download/ and follow the installation instructions.

In order to install the WooCommerce plugin, please go to https://wordpress.org/plugins/woocommerce/installation/ and follow the installation instructions.

In order to install Smart2Pay WooCommerce plugin, you need to follow the next steps:

  • Download the archive from GitHub in your installation folder.
  • Please note: Upon download, the system will rename the directory into woocommerce-master. You will have to change the name of the directory into the correct form woocommerce-smart2pay.

  • Upload woocommerce-smart2pay directory to the plugins directory from your WordPress dashboard.
  • Go to Plugins setting page and activate WooCommerce Smart2Pay.
  • 1 WooCommerce Smart2Pay Plugin Activation
  • From your WordPress dashboard go to WooCommerce area -> Settings -> Checkout section and navigate to Payment Gateways area where Smart2Pay – alternative payment methods option should be available and click Enable button.
  • Click the Save Changes button to complete the installation of the WooCommerce plugin.
1 Smart2Pay Payment Plugin Installation

Smart2Pay WooCommerce Plugin Configuration

The configurations for the Smart2Pay WooCommerce plugin can be found in the WordPress dashboard under WooCommerce area: Settings -> Checkout -> Smart2Pay.

Smart2Pay plugin contains the generic configurations that are necessary to connect your store with the payment platform. You will also need to install and activate the payment methods that you intend to use: e.g. Smart2Pay Paysafecard, Smart2Pay UKash, Smart2Pay iDEAL etc.

If the Smart2Pay payment module is not visible, please make sure that Smart2Pay module is activated from Plugins -> Installed Plugins -> WooCommerce Smart2Pay -> Activate.

Checkout below the available options of configuration for the Smart2Pay WooCommerce plugin:

Smart2Pay Payment Module Configuration

1 Smart2Pay - General settings
Smart2Pay – General Settings
Field Description Type Sample
Enabled Defines whether the Smart2Pay payment module is active or not. If it is active it will appear in the payment method lists. Boolean Enable Smart2Pay payment gateway
Method Title

This will be displayed to the customers in the checkout process when selecting from possible payment methods

String Smart2Pay – Alternative payment methods
Environment The environment to which the plugin points to. If Demo is selected you don’t have to provide API Key, Site ID or Skin ID. If Test is selected then the TEST API Key, TEST Site ID and TEST Skin ID will be used when making the payment. [Demo, Test, Live] Test
TEST API Key The API Key used to authenticate the requests for the test environment. To obtain your credentials for test environment, please contact us at support@smart2pay.com. String OjGm0QudKqUZqqfct3WN+hW+gUkgOixxxxxxxxx
LIVE API Key The API Key used to authenticate the requests for the live environment. To obtain your credentials for live environment, please contact us at support@smart2pay.com. String  
TEST SiteID The ID of the test website, a unique number that identifies the website. If you are handling multiple WooCommerce websites and want to use a single MerchantID for all of them, you need to configure multiple websites from GlobalPay Merchant Dashboard, configuration tab. Integer 305xx
LIVE Site ID The ID of the live website, a unique number that identifies the website. If you are handling multiple WooCommerce websites and want to use a single MerchantID for all of them, you need to configure multiple websites from GlobalPay Merchant Dashboard, Configuration tab. Integer 0
TEST Skin ID Specify the skin ID for the test environment. The skins can be created in the Online Skin Editor available in the GlobalPay Merchant Dashboard or by uploading a CSS file. Integer 0
LIVE Skin ID Specify the skin ID for the live environment. The skins can be created in the Online Skin Editor available in the GlobalPay Merchant Dashboard or by uploading a CSS file. Integer 0
Return URL An URL where the customer will be redirected after the payment process ends. Please set Notification URL in Smart2Pay Dashboard to: http://s2pubuntu.cloudapp.net/woo/?wc-api=WC_Gateway_Smart2Pay. String http://s2pubuntu.cloudapp.net/woo/smart2pay_return/
1 Smart2Pay - Display Settings
Smart2Pay – Display Settings
Field Description Type Sample
Display Surcharge The display of the surcharge amount in the checkout flow as separated percent and fixed amount. Boolean Display surcharge amounts to client?
Methods display mode By default, method icon images and text will be shown (Both). You have the option to display the payment methods as only logo, method name or both. List Both
Show methods in grid By default, methods will be displayed as a two columns table, having payment method’s logo or name and description. When checked, description is omitted, and columns number can be specified bellow. Boolean Show methods in grid
Grid column number The number of columns for the grid with logos. Has effect only if Show methods in grid is marked. If left blank, the default value is 3 (This value is used only if above option is checked). Integer 2
Send order number as product description If checked, the WooCommerce order number will be sent as description. If not checked, system will send below custom description. Boolean Send order number as product description
Custom product description Specifies a global description that will be sent for all the transactions. String  
1 Smart2Pay - Order Related Settings
Smart2Pay – Order Related Settings
Field Description Type Sample
New order status Status of the order right before redirecting to payment page. List On Hold
Order status when NEW The status of the order when a new order is created. List Pending
Order status when SUCCESS You should only deliver the goods/services based on the success notifications. The notifications are received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. The notification URL is in the form: http://www.merchant.com/index.php?route=payment/smart2pay/callback. WooCommerce Smart2Pay GlobalPay Plugin automatically updates the order status according to the received notifications.

This configuration defines the status of the order when the payment has been successfully completed and a ‘success’ notification is sent by GlobalPay system. You can release the goods/services in this case.

List Processing
Order status when CANCEL The status of the order when a ‘canceled’ notification is received from Smart2Pay’s GlobalPay system. List Canceled
Order status when FAIL

The status of the order when a ‘failed’ notification is received from Smart2Pay’s GlobalPay system. List Failed
Order status on EXPIRED The status of the order when an ‘expired’ notification is received from Smart2Pay’s GlobalPay system. List Cancelled
1 Smart2Pay - Payment Flow Settings
Smart2Pay – Payment Flow Settings
Field Description Type Sample
Success message The message that is displayed at the end of the payment flow when the redirection status is a success. You should only deliver the goods/services based on the success notification received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. The notification URL is in the form: http://www.merchant.com/index.php/globalpay/index/handleResponse. String Thank you, the transaction has been processed successfully. After we receive the final confirmation, we will release the goods.
Failed message The message that is displayed at the end of the payment flow when the customer is redirected with a failed status. String There was a problem processing your payment. Please try again.
Cancelled message The message that is displayed at the end of the payment flow when the customer has canceled the payment. String You have canceled the payment.
Pending message The message that is displayed to the customer when the redirection status is unknown or the customer must take additional actions to complete the payment: e.g. go to the bank and make an offline bank transfer. String Thank you, the transaction is pending. After we receive the final confirmation, we will release the goods.

After the main configuration of the Smart2Pay Payment Module, please activate the payment methods that you plan to use.

Note: Surcharges will be calculated from cart subtotal + shipping price. Additional taxes and fees will not be included in surcharge calculation.

1 Smart2Pay - Payment Methods

Smart2Pay WooCommerce Payment Flow

  1. The customer adds the product in the shopping. Cart. He has to options: to continue shopping or view cart.

    1 Adding products in the shopping cart

  2. In the shopping cart the customer can see the added products and the details of the payment.

    1 Checkout initiation

  3. The customer needs to enter the billing details, including customer and billing address to complete the sign in process. Next to the billing details the customer can see the details of the order.

    1 Sign in process

  4. Depending on the billing country of the customer, the activated methods are shown in the checkout process in the Smart2Pay – Alternative payment methods step.

    1 Payment method selection

  5. After selecting the preferred payment method the customer needs to confirm the order by clicking on the Place Order button.

    1 Order confirmation

  6. After order confirmation the customer is redirected to the chosen payment method provider where he enters the necessary details of the payment.

    1 Smart2Pay payment page

  7. Upon completion of the payment flow, the customer is redirected back to the payment return page.

    1 Payment return page when the redirection status is a success