Read this in 
Portuguese, and 
English
- Backoffice Key
- Enable Payment Method
- Multibanco
- Multibanco with Dynamic References
- MB WAY
- Credit Card
- Payshop
- Cofidis Pay
- Pix
- Ifthenpay Gateway
- Support
- Request account
- Request additional account
- Logs
- Reset Configuration
- Updates
- Sandbox Mode
- Invoice Option
- Callback
- Test Callback
- Paying order with Multibanco
- Paying order with Payshop
- Paying order with MB WAY
- Paying order with Credit Card
- Paying order with Cofidis Pay
- Paying order with Pix
- Paying order with Ifthenpay Gateway
This is the Ifthenpay plugin for Prestashop e-commerce platform
Multibanco is one Portuguese payment method that allows the customer to pay by bank reference. This module will allow you to generate a payment Reference that the customer can then use to pay for his order on the ATM or Home Banking service. This plugin uses one of the several gateways/services available in Portugal, IfthenPay.
MB WAY is the first inter-bank solution that enables purchases and immediate transfers via smartphones and tablets.
This module will allow you to generate a request payment to the customer mobile phone, and he can authorize the payment for his order on the MB WAY App service. This module uses one of the several gateways/services available in Portugal, IfthenPay.
Payshop is one Portuguese payment method that allows the customer to pay by payshop reference. This module will allow you to generate a payment Reference that the customer can then use to pay for his order on the Payshop agent or CTT. This module uses one of the several gateways/services available in Portugal, IfthenPay.
Credit Card This module will allow you to generate a payment by Visa or Master card, that the customer can then use to pay for his order. This module uses one of the several gateways/services available in Portugal, IfthenPay.
Cofidis Pay is a payment solution of up to 12 interest-free installments that makes it easier to pay for purchases by splitting them. This module uses one of the several gateways/services available in Portugal, IfthenPay.
Pix is an instant payment solution widely used in the Brazilian financial market. It enables quick and secure transactions for purchases, using details such as CPF, email, and phone number to complete the payment.
Contract with Ifthenpay is required.
See more at Ifthenpay.
Follow the table below to verify Ifthenpay's module compatibility with your online store.
| Prestashop 1.6 | Prestashop 1.7 | Prestashop 8 [8.0.0 - 8.1.7] | |
|---|---|---|---|
| Ifthenpay v8.0.0 -> v8.3.0 | Not compatible | Not compatible | Compatible |
You may install the module for the first time on you Prestashop platform or just update it.
- To install it for the first time, go the module's Github page and click the the latest release;
- And download the installer zip named "ifthenpay.zip";
- Or if you are upgrading, you can download it from Prestashop in Modules/Ifthenpay/Configure;
- Go to Module Manager;
- Click "Upload a module";
- Drag the installer zip on to "Upload a module" box;
- After a successful installation click the "Configure" button;
- Insert your Ifthenpay Backoffice key and save:
- The backoffice key is given upon contract and is made of four sets of four digits separated by a dash (-), insert it in the Backoffice key field;
- Click "Save" button;
The following takes Multibanco as example, but the process is the same for the remaining payment methods
- To enable a payment method, follow the steps:
- (optional) Switch on this option if you are testing the payment methods, this will prevent the callback activation;
- Enable the payment method by switching the "Status" to Enabled;
- Click "Save" button;
- To configure Multibanco payment method click the "MANAGE" button for Multibanco;
- Configure Multibanco payment method:
- Activate Callback, by selecting this option the order state will update when a payment is received;
- Select an Entity. Can only select from the Entities associated with your Backoffice Key;
- Select a Sub Entity. Can only select from the Sub Entities associated with Entity previously selected;
- (optional) Input minimum order value to only display this payment method for orders above it;
- (optional) Input maximum order value to only display this payment method for orders below it;
- (optional) Select one or more countries to only display this payment method for orders with that shipping country, leave empty to allow all;
- (optional) Input an Integer number to order this payment method in the checkout page. Smallest takes first place;
- Click "Save" button;
- If you previously set the "Callback" to activate, after saving, it's state will be updated below with the generated Anti-Phishing key and Callback Url;
Multibanco with Dynamic References payment method generates references by request, and is used if you wish to add a deadline with limited number of days to your order payment.
- Configure Multibanco with Dynamic References:
- Select "MB" from the Entity field, this entity will only be available for selection if you contracted an account for Multibanco with Dynamic References;
- Select a Sub Entity.
- (optional) Select number of days for deadline.
- (optional) Activate Cancel Multibanco Order, by selecting this option, Multibanco orders that are still unpaid after the deadline will have status changed to "Canceled";
- Click the "Manage" button for MB WAY;
- Configure MB WAY payment method:
- Activate Callback, by selecting this option the order state will update when a payment is received;
- (optional) Activate Cancel MB WAY Order, by selecting this option, MB WAY orders that are still unpaid 30 min after confirmation, will have status changed to "Canceled";
- MB WAY Countdown, set to "Activate" by default, this option determines whether the MB WAY 5 minutes countdown is displayed or not after confirming order;
- Select a MB WAY key. Can only select from the MB WAY keys associated with your Backoffice key;
- (optional) Input minimum order value to only display this payment method for orders above it;
- (optional) Input maximum order value to only display this payment method for orders below it;
- (optional) Select one or more countries to only display this payment method for orders with that shipping country, leave empty to allow all;
- (optional) Input an Integer number to order this payment method in the checkout page. Smallest takes first place.
- Click "Save" button;
- If you set the "Callback" to activate, it's state will be updated below with the generated Anti-Phishing key and Callback Url;
- In Modules/Ifthenpay/Configure, click the "MANAGE" button for Credit Card;
- Configure Credit Card (also referred to as Ccard) payment method:
- Select a CCard key. Can only select from the CCard keys associated with your Backoffice key;
- (optional) Activate Cancel Credit Card Order, by selecting this option, Credit Card orders that are still unpaid 30 min after confirmation, will have status changed to "Canceled";
- (optional) Input minimum order value to only display this payment method for orders above it;
- (optional) Input maximum order value to only display this payment method for orders below it;
- (optional) Select one or more countries to only display this payment method for orders with that shipping country, leave empty to allow all;
- (optional) Input an Integer number to order this payment method in the checkout page. Smallest takes first place.
- Click "Save" button;
- In Modules/Ifthenpay/Configure, click the "MANAGE" button for Payshop;
- Configure Payshop payment method:
- Activate Callback, by selecting this option the order state will update when a payment is received;
- Select a Payshop key. Can only select from the Payshop keys associated with your Backoffice key;
- (optional) Input a Deadline for payment, from 1 to 99 days or leave empty if you do not want it to expire;
- (optional) Activate Cancel Payshop Order, by selecting this option, Payshop orders that are still unpaid after the deadline will have status changed to "Canceled";
- (optional) Input minimum order value to only display this payment method for order above it;
- (optional) Input maximum order value to only display this payment method for order below it;
- (optional) Select one or more countries to only display this payment method for orders with that shipping country, leave empty to allow all;
- (optional) Input an Integer number to order this payment method in the checkout page. Smallest takes first place.
- Click "Save" button;
- If you set the "Callback" to activate, it's state will be updated below with the generated Anti-Phishing key and Callback Url;
- In Modules/Ifthenpay/Configure, click the "MANAGE" button for Cofidis Pay;
- Configure Cofidis Pay payment method:
- Activate Callback, by selecting this option the order state will update when a payment is received;
- Select a Cofidis Pay key. Can only select from the Cofidis Pay keys associated with your Backoffice key;
- (optional) Activate Cancel Cofidis Pay Order, by selecting this option, Cofidis Pay orders that are expired 60 minutes after confirmation will have status changed to "Canceled";
- (optional) Input minimum order value to only display this payment method for order above it. Important Notice: On Cofidis Key selection, this input is updated with value configured in ifthenpay's backoffice, and when editing, it can not be less then the value specified in ifthenpay's backoffice.;
- (optional) Input maximum order value to only display this payment method for order below it. Important Notice: On Cofidis Key selection, this input is updated with value configured in ifthenpay's backoffice, and when editing, it can not be greater then the value specified in ifthenpay's backoffice.;
- (optional) Select one or more countries to only display this payment method for orders with that shipping country, leave empty to allow all;
- (optional) Input an Integer number to order this payment method in the checkout page. Smallest takes first place.
- Click "Save" button;
- If you set the "Callback" to activate, it's state will be updated below with the generated Anti-Phishing key and Callback Url;
- In Modules/Ifthenpay/Configure, click the "MANAGE" button for Pix;
- Configure Pix payment method:
- Select a Pix key. Can only select from the Pix keys associated with your Backoffice key;
- Activate Callback, by selecting this option the order state will update when a payment is received;
- Enable Invoice, by selecting this option, when an order is updated with it's respective payment method confirmed status, it will trigger Prestashop invoice logic.
- (optional) Activate Cancel Pix Order, by selecting this option, Pix orders that are expired 30 minutes after confirmation will have status changed to "Cancelled";
- (optional) Input minimum order value to only display this payment method for order above it;
- (optional) Input maximum order value to only display this payment method for order below it;
- (optional) Select one or more countries to only display this payment method for orders with that shipping country, leave empty to allow all;
- (optional) Input an Integer number to order this payment method in the checkout page. Smallest takes first place.
- Click "Save" button;
- If you set the "Callback" to activate, it's state will be updated below with the generated Anti-Phishing key and Callback Url;
- In Modules/Ifthenpay/Configure, click the "MANAGE" button for Ifthenpay Gateway;
- Configure Ifthenpay Gateway payment method:
- Activate Callback, by selecting this option the order state will update when a payment is received;
- Select a Ifthenpay Gateway key. Can only select from the Ifthenpay Gateway keys associated with your Backoffice key;
- Select a Payment Method Key per each Method and check the checkbox if you want to display it in the gateway page.
- Select a Payment Method that will be selected in the gateway page by default.
- (optional) Input a Deadline for gateway page link, from 1 to 99 days or leave empty if you do not want it to expire;
- Text displayed in the "Return to Shop" button in the gateway page;
- (optional) Activate Cancel Ifthenpay Gateway Order, by selecting this option, Ifthenpay Gateway orders that are expired 60 minutes after confirmation will have status changed to "Cancelled";
- (optional) Input minimum order value to only display this payment method for order above it.
- (optional) Input maximum order value to only display this payment method for order below it.
- (optional) Select one or more countries to only display this payment method for orders with that shipping country, leave empty to allow all;
- Display this payment method logo image on checkout, choose from 3 options:
- enabled - default image: displays ifthenpay gateway logo;
- disabled: displays Payment Method Title;
- enabled - composite image: displays a composite image of all the payment method logos you have selected;
- Text that appears to the consumer during checkout if logo option above is set to disabled.
- (optional) Input an Integer number to order this payment method in the checkout page. Smallest takes first place.
- Click "Save" button;
Important Notice: It is not possible to change to or update to the Credit Card and Cofidis Pay payment methods. At Prestashop order details, you can edit the order payment method and payment data. An use case for this would be a customer ordered 2 units of a product, but decided to only get one, so the customer contacts the store admin and requests that change. The store admin edits the product quantity and at the bottom of the page clicks the "Update Multibanco/MB WAY/Payshop Data" button and next clicks the "Resend Payment Data". Multibanco payment method is used to explain the following procedures. The procedures are the same for all methods apart from MB WAY that does require a phone number.
- After changing the order, click the "Update Multibanco Data" button;
- After updating the payment data, you must resend the payment details to this order's customer by clicking the "Resend Payment Data" button;
- If you have long deadlines on your payment methods and want to remind your customer of an order's pending payment, click the "Remember Payment Details" button;
Choose a different payment method:
- Start the process by clicking the "Choose new Payment Method" button;
- From the newly shown select box, select your new payment method (1), and click the "Change Payment Method" button (2);
- The payment details will be updated with the new methods payment data, now you must click the "Resend Payment Data" to let your customer know;
- If you are changing from Multibanco or Payshop to MB WAY, you are required to input the customer's phone number and click the "Change Payment Method" button. This action sends the MB WAY notification automatically, but you can use the "Resend Payment Data" button if the customer does not pay in the 5 minutes time window and requires another payment notification to their MB WAY app;
- In Modules/Ifthenpay/Configure click the "Go to Support!" button to be redirected to the Ifthenpay helpdesk page;
- If you still do not have an Ifthenpay account, you may request one by filling the membership contract pdf file that you can download by clicking the "Request an account!" button, and send it along with requested documentation to the email [email protected]
If you already have an Ifthenpay account, but don't have a payment method unlocked, you can make an automatic request to Ifthenpay;
- At Modules/Ifthenpay/Configure, there will be a "REQUEST ... ACCOUNT CREATION" button for every payment method that you have yet to unlock. Click the button for the payment method you require. After Ifthenpay's team have added your payment method, the list of payment methods available on your module will be updated with the new one.
- You can consult logs related to this module at Module/Ifthenpay/Configure by clicking the tab "LOGS";
- The logs will record errors and other events that can be helpful in detecting issues;
- If for example you acquired a new Backoffice key, and want to assign it to your site, but already have one assigned, you can reset the module's configuration.
At Module/Ifthenpay/Configure click the "Reset" button. Warning, this action will reset all current configurations for this module;
- After reset, you will once again be asked for your Backoffice key;
- At Module/Ifthenpay/Configure, bottom of the page you can check if there are any updates available for the module;
- If a new version is available you may proceed with the upgrade by clicking (1) to download the module installer;
- And uploading it to your Prestashop store like you did when installing it in the first place;
Click "Upload a module";
- Drag the installer zip on to "Upload a module" box;
- You may want to run tests before going into production. To do so, you must turn "Sandbox Mode" to Enabled and click the "Save" button, before activating any payment method Callback.
The Sandbox Mode is used in order to prevent the Callback activation and the communication between our server and your store.
- You may want to automatically generate the invoice for an order when it is confirmed as paid. To enable this functionality you can enable the Invoice option (1) in any of the available methods.
- This action will update the confirmed order status for the respective payment method, which you may check in Prestashop backoffice at Shop Parameters/Order Settings/Statuses.
- With this, when your order is confirmed, Prestashop will add an invoice line to the Payment tab in order details.
-
Callback is a functionality that when active, will allow your store to receive the notification of a successful payment. When active, a successful payment for an order will trigger a change in that specific order's status to "paid" or "processing" (status name will depend on your Prestashop configuration). You can use the Ifthenpay Payment methods without activating the Callback, but your orders will not update their status automatically;
-
Callback statuses:
- Callback Disabled (order will not change state upon receiving payment);
- Callback Activated (order will change state upon receiving payment);
- Callback Activated & Sandbox Mode enabled (order will not change state upon receiving payment);
In each payment method config page (except Ccard), you can test the Callback functionality by clicking the "Test Callback" button. This will simulate a successful payment for a order in your store, and will change its status. Requires Callback to be activated;
Multibanco: Use the following data (1) and (2) from order payment details:
to fill the Test Callback form and click the "Test Callback" button (3):
MB WAY: Use the following data (1) and (2) from order payment details:
to fill the Test Callback form and click the "Test Callback" button (3):
Payshop: Use the following data (1) and (2) from order payment details:
to fill the Test Callback form and click the "Test Callback" button (3):
Cofidis: Use the following data (1) and (2) from order payment details:
to fill the Test Callback form and click the "Test Callback" button (3):
Pix: Use the following data (1) and (2) from order payment details:
to fill the Test Callback form and click the "Test Callback" button (3):
Ifthenpay Gateway: In the backoffice, use the order ID and the order amount, and enter them in the respective fields (1) and (2) of the Callback test form, then click on Test (3).
The following action are described from the perspective of the consumer.
- Select Multibanco at checkout and place order:
- Select "Pay by Multibanco";
- Check the box of "terms of service" (this will depend on your Prestashop configuration);
- Click "PLACE ORDER" button;
- Upon confirmation, you will be greeted with the Multibanco payment information;
- Select Payshop at checkout and place order:
- Select "Pay by Payshop";
- Check the box of "terms of service" (this will depend on your Prestashop configuration);
- Click "PLACE ORDER" button;
- Upon confirmation, you will be greeted with the Payshop payment information;
- Select MB WAY at checkout and place order:
- Select "Pay by MB WAY";
- Input the mobile phone number of a smartphone with MB WAY app installed;
- Check the box of "terms of service" (this will depend on your Prestashop configuration);
- Click "PLACE ORDER" button;
- Upon confirmation, you will be greeted with the MB WAY countdown, and payment information:
- MB WAY countdown;
- MB WAY payment information;
- During countdown, interactions from user with MB WAY app will update countdown accordingly:
- if you accept the payment in the smartphone's MB WAY app, the countdown will update with "Order Paid!";
- if you reject the payment in the smartphone's MB WAY app, the countdown will update with "payment refused!";
- if at checkout you inputted a phone number to a smartphone that does not have MB WAY app installed, or there are communication issues with SIBS servers at that moment, the countdown will update with "payment failed!";
- if you ran out of time, you can resend a MB WAY notification by clicking "RESEND MB WAY NOTIFICATION";
- Select Credit Card at checkout and place order:
- Select "Pay by Credit Card";
- Check the box of "terms of service" (this will depend on your Prestashop configuration);
- Click "PLACE ORDER" button;
- Fill Credit Card data:
- Input Card Number;
- Input Expiry Date;
- Input CVV/CVC;
- Input Name;
- Click "PAY" button;
- After paying you will be redirected back to the store;
- Select Cofidis Pay at checkout and place order:
- Select "Pay by Cofidis Pay";
- Check the box of "terms of service" (this will depend on your Prestashop configuration);
- Click "PLACE ORDER" button;
- Login or, if you don't have an account, sign up with Cofidis Pay:
- Click "Avançar" to sign up with Cofidis Pay;
- Or if you have a Cofidis Pay account, fill in your access credentials and click enter;
- Number of installments and billing and personal data:
- Select the number of installments you wish;
- Verify the summary of the the payment plan;
- Fill in your personal and billing data;
- Click "Avançar" to continue;
- Terms and Conditions:
- Select "Li e autorizo" to agree with terms and conditions;
- Click "Avançar"
- Agreement formalization:
- Click "Enviar código";
- Agreement formalization authentication code:
- Fill in the code you received on your phone;
- Click "Confirmar código";
- Summary and Payment:
- Fill in your credit card details (number, expiration date and CW), and click "Validar";
- Success and return to store:
- Click the return icon to return to the store;
- After which you will be redirected back to the store;
- Select Pix at checkout and place order:
- Select "Pay by Pix";
- Fill the name, CPF, and Email, these are required;
- Address related fields are optional
- Check the box of "terms of service" (this will depend on your Prestashop configuration);
- Click "PLACE ORDER" button;
- Proceed with payment with one of two options:
- Reading QR code with mobile phone;
- Copy the Pix code and pay with online banking;
Important Note: In order to be redirected back to the store after paying, this page must be left open. If closed the consumer will still be able to pay, as long as he has already read the Pix code, he will only not be redirected back to the store.
- After paying you will be redirected back to the store;
- Select Ifthenpay Gateway at checkout and place order:
- Select "Pay by Ifthenpay Gateway";
- Check the box of "terms of service" (this will depend on your Prestashop configuration);
- Click "PLACE ORDER" button;
Select one of the payment methods available in the gateway page (1).
In case of Multibanco method, the entity, reference and amount will be displayed. Here the user can do one of the two:
- in case of an offline payment method, note down the payment details, click the close gateway button (2) and pay later;
- pay at that moment and click the confirm payment button (3) to verify the payment.
If the user did not pay at the moment and did not take note of the payment details, it is also possible to access the Ithenpay Gateway link at a later date in the user account order history or order confirmation email.
You have reached the end of the ifthenpay extension manual for Prestashop 8.