This knowledge base article will walk you through the process of setting up and configuring IfThenPay for your online store. We'll cover everything you need to know, including setting up payment methods, configuring payment notifications, and troubleshooting common issues.
IfThenPay Backoffice settings
In order to configure your TronShop administration settings, it is necessary to first set up your IfThenPay payment gateway account and enable the "Pay By Link" payment method within it.
1. First, login to the IfThenPay backoffice portal at https://backoffice.ifthenpay.com/Account/Login
2. Go to the “Management” > “Contract” section in the backoffice portal
3. In the “Filter” section on the top of the page select one account
4. Then, on the same page in the section called “Callback Activation” setup all the information for callback notifications (**). Set the “callback URL” to the IfThenPay webhook notification URL of your shop (This information can be found and copied from TronShop Administration under the payment integration settings – see guide bellow) but please check the format, it has to be: https://<your-shop-doman>/api/ifthenpay?key=[ANTI_PHISHING_KEY]&id=[ID]&amount=[AMOUNT]&payment_datetime=[PAYMENT_DATETIME]&payment_method=[PAYMENT_METHOD]
5. Do this for all accounts (MBWAY, Multibanco, …)
Setting up IfThenPay in TronShop Administration
The following section provides details on how to enable and configure IfThenPay as a payment gateway for TronShop.
1. First, you need to obtain credential for payment gateway integration configuration – Gateway Key and Antiphishing Key. After completing the registration process, IfThenPay will provide you with a "Gateway key." This key is unique to your account and is required for payment processing. Additionally, you have to invent/generate an "Antiphishing key" (**), which is a security code used to authenticate and validate webhook callbacks from IfThenPay. This key ensures that only authorized requests are accepted and helps to prevent phishing and other security threats.
2. Go to the payment settings page in TronShop Administration portal
3. Enable payment in payment settings and type Gateway key and Antiphishing key to payment gateways integrations settings in TronShop portal. Then, save the settings.
4. From this settings you can copy the webhook URL (**)
5. Add payment method to TronShop
6. Add translations, prices and deliveries for IfThenPay payment method
PLEASE TAKE ATTENTION
- A webhook callback is a way for web applications to communicate with each other in real-time. It is a type of web API that allows one application to send automatic notifications or messages to another application whenever a specific event or trigger occurs.
- While the Antiphishing Key can be any text string, it is highly recommended that you choose a secure and complex key, such as a strong password, to ensure the highest level of security.
- Use your domain with SSL certificate (beginning with “https://”). It's important to use SSL communication because it provides a secure and encrypted connection between a website or application and its users. SSL (Secure Sockets Layer) technology helps to protect sensitive information, such as usernames, passwords, and financial data, from being intercepted or manipulated by hackers or malicious actors. Without SSL, this information is transmitted in plain text, making it vulnerable to attacks. By using SSL, users can trust that their data is being transmitted securely, and website owners can establish a secure online presence and protect their reputation.