Read this in Português, and
Inglês
This is the Ifthenpay plugin for Joomla with Virtuemart E-Commerce component
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.
Contract with Ifthenpay is required.
See more at Ifthenpay.
Follow the table below to verify Ifthenpay gateway plugin compatibility with your online store.
Joomla 3 + virtuemart 4 | Joomla 4 + Virtuemart 4 | |
---|---|---|
Ifthenpay v1.0.0 to v1.0.5 | Compatible | Compatible |
Installation is straightforward:
- fill the payment method information, and click the "Save" button:
- Payment Name - Set as "Ifthenpay"
- Sef Alias - Set as "Ifthenpay"
- Published - Select "Yes" if you wish to display this payment method on checkout
- Payment Description - Optional
- Payment Method - Select "Ifthenpay Payments"
- Shopper Group - Optional (according to your shop needs)
- List Order - Optional (according to your shop needs)
- Currency - Euro is selected by default, since it is currently the only supported currency
- if you still do not have an Ifthenpay account, you may request one by filling the membership contract pdf file downloadable by the "Request an account" button, and send it along with requested documentation to the email ifthenpay@ifthenpay.com
- fill the payment method configuration, and click the "Save" button:
- Gateway Key - Input the Gateway Key given on membership contract completion, for example: AAAA-999999 (four uppercase alphabet letters, an hyphen, and six digits)
- Anti-phishing Key - Automatically generated, but you can create one, this must contain a total of 50 alphanumeric characters
- Replace Payment Logos - If you do not wish to display your contracted payment method logos, you may replace these with a string of text
- Pending Orders - Set by default to Pending, but you may change this if necessary
- Success Orders - Set by default to Confirmed, but you may change this if necessary
- Failed Orders - Set by default to Cancelled, but you may change this if necessary
- Countries - Leave empty if you wish to allow this payment method to all countries, or select one or more countries to make this payment method available only the selected ones
- Minimum amount - Leave empty if you wish to allow any amount, or input a numeric value to filter the availability of this method by minimum order total amount
- Maximum amount - Leave empty if you wish to allow any amount, or input a numeric value to filter the availability of this method by maximum order total amount
- Currency - Euro is selected by default, since it is currently the only supported currency
- after saving new fields will be available:
- Available Payment Methods - (read only) will display the logos of the payment methods available on your payment gateway
- Activate - press this button to be redirected to the activation page
- Url - (read only) this is the callback url, you may use it for testing the update of order state
- Anti-phishing Key - (read only) the anti-phishing key you have stored on database
- to activate your callback press Activate (this is necessary to update the state of the order from pending to confirmed when the customer payment is received)
- in the callback activation assistant page you will find that the Gateway Key and Anti-Phishing Key values are filled in for you correctly, so you only need to insert your Backoffice Key and press the Ativar button (the Backoffice Key is made of four sets of four digits separated by an hyphen and is given to you when signing contract with Ifthenpay, here is an example of the key: 1111-2222-3333-4444)
- and you are finished configuring your payment plugin, you can try it out from the customer side now.
The following is experienced from the perspective of your customer. Your shop customer may pay for an order in the following manner:
- ...after placing an item in the cart and heading to checkout, select the Ifthenpay payment method (this may be shown as one or multiple payment method logos, or only a string of text, depending on your configuration)
- agree to the Terms of Service
- click the Confirm Purchase button
(you will be redirected to Ifthenpay Gateway Page)
- here you may verify the order value to pay
- select a payment method from the ones available, these will depend on your contract:
- ATM (Multibanco) - Entity, Reference and Value data is given, you may use these to pay either on a public ATM or at you online homebanking
- MB WAY - (This requires that you have the MB WAY app installed on you smartphone) select the callsign of your country and your smartphone number, click the pay button, and you should receive a notification for payment in your MB WAY app
- Payshop - Reference, and Value is given, you may use these to pay at a CTT shop or at any Payshop agent shops
- Ccard - Fill in your credit card info and click the pay button
- you may print the payment information if you so require, by clicking the "print" button
- after obtaining your payment data for offline payments methods (ex: Multibanco, and Payshop) or finishing your payment using online payment (ex: MB WAY, and Ccard), you can click the "close" button to return to the shop's Thank you page
- choosing Multibanco, you will be shown the Entity, Reference, and amount to use in an ATM or online banking app
- choosing MB WAY, you will be prompted to input the phone number, and press pay in to send the notification to the MB WAY app on the smartphone (note: customer must have the app installed in the smartphone associated with the number)
- choosing Payshop, you will be shown the Payshop reference and the amount to pay, these can be used on any Payshop store/agent
- choosing Credit Card, you will be redirected to another page where you can fill in your credit card information and press the pay button to finish