Skip to main content

Account Setup

Before you begin integrating HitPay payments into your PretaShop store, you need to set up your HitPay account and ensure some prerequisites are met:
  1. If you haven’t already, create an account on HitPay.
  2. Ensure that you have the necessary payment methods activated in your HitPay account.
  3. Make sure the payment methods you want to offer are enabled in your PretaShop sales channel.

Integration Guide

Follow these steps to seamlessly integrate HitPay payments into your PretaShop store:
  1. Upload Module File
Download the zip files below and follow the installation guide below: For Prestashop 1.7 versions - use the 1.1.7 plugin below: Download Here For Prestashop 1.8 versions - will be compatible with 9 version too - or 9 version can use 1.8 extension. Download Here For Prestashop 1.6 versions - use the 1.1.4 plugin below: Download Here
  1. Log into your PrestaShop account
  2. Navigate to Modules > Module Manager and click Upload a Module
Upload
  1. Upload the source code zip file from your computer
Please ensure the file is compressed or zipped before uploading File
  1. Click Configure
Configure You will now be redirected to the below page: PretaShop HitPay
  1. Copy/Paste the API Keys and Salt Values from HitPay to PretaShop. You can find your API and Salt Keys by navigating to Payment Gateway > API in the HitPay dashboard.
  2. Paste the values in the Configure panel, enable Live mode and click Save
Save 8. Enable/disable the payment methods for your Prestashop Checkout by updating your Integration Settings for Prestashop Integration That’s it! You’re all set up with HitPay on PretaShop. 🎉

Support for Drop-In UI

This plugin supports Drop-In UI. Drop-In allows your customers to complete the payment without a redirect; it is embedded into your webpage, so your customers will never have to leave your site. This is recommended if you have payment methods like Cards and Native QR Code payments (e.g., PayNow). PayNow Checkout Drop-In
Drop-In UI currently does not support Apple Pay.

FAQs

No, HitPay does not send an email confirmation to your customer if the payment is made through PrestaShop. This is because PrestaShop, by default, sends an email to your customer with the order details. To prevent duplicate emails, HitPay does not send an additional email to your customers. As a merchant, you will receive a payment alert email.
If a user is stuck on the “We are retrieving your payment status, please wait…” page, it might be necessary to clear the JavaScript cache from your PrestaShop settings. You can refer to this guide for detailed instructions on how to clear the JS cache.
If you are using a payment plugin, after every successful payment, a webhook is sent to your store to acknowledge the payment confirmation. Your order is marked as paid through this webhook.A webhook status showing as "failed" indicates that Hitpay failed to communicate with your server. This can happen for the following reasons:
  • Your store may have a security feature that blocked Hitpay's request.
  • Your server was unavailable during this time.
To avoid this issue, ensure that you whitelist Hitpay's IP addresses:
  • Production: 3.1.13.32, 52.77.254.34
  • Sandbox: 54.179.156.147
For further details, please review your store's debug logs.
On the HitPay checkout page, you will see the option for Apple Pay/Google Pay only once you select CARDS as the payment method. Additionally, it will work only if the browser supports the respective method:
  • Apple Pay: Only available on the Safari browser. Ensure you have Apple Pay enabled. Here's a guide from Apple on how to enable Apple Pay on your browser.
  • Google Pay: Only available on the Chrome browser. Ensure you have Google Pay enabled on your Google account.
Here are two checks you can perform to ensure the payment method is visible on your checkout page:
  1. Navigate to Payment Gateway > Integrations. Ensure that your payment method is enabled for your respective sales channel.
  2. If you have checkout rules, navigate to Payment Gateway > Checkout Customization > Payment Method Rules and ensure your payment method is selected.
I