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