HitPay Gateway Extension for Magento 2

HitPay provides a seamless payment experience for your customers and an easy integration process for the developers. Hitpay payment works by creating Payment Request and then the customers accepting the Payment Request.

Install Extension

1. Download the latest Source code zip file from the HitPay GitHub (Use the download button).
2. Extract the magento2-extension.zip.
3. Place the extracted files into app/code/SoftBuild/HitPay/ folder under Magento root path.
4. Check your Magento Mode: Run "php bin/magento deploy:mode:show" to find your mode If your Magento mode is "production", please run the below commands:

i)   php bin/magento cache:clean 
ii)  php bin/magento cache:flush 
iii) php bin/magento setup:upgrade 
iv) php bin/magento setup:static-content:deploy
If your Magento mode is "default" (or) "developer", please run the below commands: 
i)  php bin/magento setup:upgrade 
ii) php bin/magento setup:static-content:deploy -f

Upgrade/Update Extension

1. If you're performing an update and if your already installed module version is 1.0.0(you can find version in the etc/module.xml file).
2. Please run the following commands: i) php bin/magento module:disable SoftBuild_HitPay ii) php bin/magento module:uninstall SoftBuild_HitPay iii) php bin/magento setup:upgrade
3. Download the latest Source code zip file from the HitPay GitHub (Use the download button).
4. Extract the magento2-extension.zip.
5. Place the extracted files into app/code/SoftBuild/HitPay/ folder under Magento root path.
6. Check your Magento Mode: Run "php bin/magento deploy:mode:show" to find your mode If your Magento mode is "production", please run the below commands:

i)   php bin/magento cache:clean 
ii)  php bin/magento cache:flush 
iii) php bin/magento setup:upgrade 
iv) php bin/magento setup:static-content:deploy
If your Magento mode is "default" (or) "developer", please run the below commands: 
i)  php bin/magento setup:upgrade 
ii) php bin/magento setup:static-content:deploy -f

1. If you're performing an update and if your already installed module version is greater than 1.0.0(you can find version in the etc/module.xml file).
2. Download the latest Source code zip file from the HitPay GitHub (Use the download button).
3. Extract the magento2-extension.zip.
4. Replace/overwrite the existing app/code/SoftBuild/HitPay/ folder with the extracted files.
5. Check your Magento Mode: Run "php bin/magento deploy:mode:show" to find your mode If your Magento mode is "production", please run the below commands:

i)   php bin/magento cache:clean 
ii)  php bin/magento cache:flush 
iii) php bin/magento setup:upgrade 
iv) php bin/magento setup:static-content:deploy
If your Magento mode is "default" (or) "developer", please run the below commands: 
i)  php bin/magento setup:upgrade 
ii) php bin/magento setup:static-content:deploy -f

Configure Extension

1. Log in to your Magento Store Backend
2. Choose Stores on the Admin sidebar to the left. Now go to Settings > Configuration.
3. In the Configuration page, click on Sales on the left and choose Payment Methods.
4. On the Payment Methods page, navigate to HitPay Payment Section. i) Enabled - select yes to enable the HitPay Payment Method.
   ii) Mode - select sandbox or live mode. iii) Title - This title will show under the payment methods section on the checkout page of Magento. iv) API Key - Enter Your received from HitPay. v) API Salt - Enter Your received from HitPay. vi) Enabled Auto Invoice - select yes to create invoice automatically if payment is successful. vii) Debug - select yes to enable the debug, this will log HitPay API calls under var/log/hitpay.log file. viii) Countries - Allow all countries or select specific countries to access this payment method. 5. Click Save Config.
5. Refresh Magento Cache.

You need to have Api Key and Salt. The values you can take from the page after registration

After set up the Api Key and Salt You can go to checkout page

After click on “Place Order” Button: It will redirect you on payment page:

After making a successful payment, it will redirect to the success page.

Refunds

1. Log in to Admin
2. Navigate to Sales ⇒ Orders
3. Click view link to navigate to Admin Order Details page.
4. Click Invoices tab as shown in the screen, an invoice would have been created if order is paid via 'HitPay Payment Gateway' and payment is successful and transaction id saved on the Database.
5. Click the view link in the invoices list to go to invoice page.
6. Click the Credit Memo button at the top to initiate Online Refund request. [Note: Please do remember and make sure, you have to navigated into invoice page and click the Credit memo button to initiate the Online Refund Request with HitPay Payment Gateway. If you click the Credit Memo button in other pages, Magento will provide option to Refund offline only]
7. Now click the 'Refund' button (marked red color in the screen) to request the Refund with HitPay Payment Gateway through online/api.
8. If gateway accepted the refund request and the Refund details will be added to order history.
9. Only one refund is allowed per transaction.
10. Refund is only applicable if the initial charge was made with PayNow or Card.

Checkout UI Drop-in (Popup) Settings

Checkout UI Drop-in (Popup)

Changelog

= 1.0.0 =

• Initial release.

== Upgrade Notice ==

= 2.0.6 =

• Added FPX and Zip Payment logos selection

= 2.0.7 =

• Partial quantity refund option enabled

= 2.0.8 =

• Fixed: Amount format greater 1000 data passed

= 2.0.9 =

• Added Atome and Billease, GCash, Union Bank, QRPH, PESONet logos

= 2.1.0 =

• Drop-In (Popup) feature included and added 45 new payment logos

= 2.1.1 =

• Fixed: Invoice creation failed causing the order canceled

= 2.1.2 =

• Jul 18, 2024
• Added DuitNow, Touch n Go and Boost logos
• Fixed Hitpay Fee Currency Issue
• Fixed Admin Payment method and Fee display error for multi-store
• Fixed Admin refund error for multi-store
• Fixed Success page status display loader issue when reloading the page
• Plugin tested on Magento 2.4.7-p1

= 2.1.3 =

• Aug 2, 2024
• Updated Return URL page, removed the order canceling if any php error/warning/notice occurs and removed the comparison of the order references.

= 2.1.4 =

• Oct 4, 2024
• Tested on 2.4.7-p2
• Upgraded to support HitPay POS Terminals.