HiPay Fullservice module for Magento 2

The HiPay Fullservice module for Magento 2 is a PHP module which allows you to accept payments in your Magento 2 online store. It offers innovative features to reduce shopping cart abandonment rates, optimize success rates and enhance the purchasing process on merchants’ sites in order to significantly increase business volumes without additional investments in the Magento 2 e-commerce CMS solution.

Getting started

Read the project documentation for comprehensive information about the requirements, general workflow and installation procedure.

Resources

• Full project documentation — To have a comprehensive understanding of the workflow and get the installation procedure
• HiPay Support Center — To get technical help from HiPay
• Issues — To report issues, submit pull requests and get involved (see Apache 2.0 License)
• Change log — To check the changes of the latest versions
• Contributing guidelines — To contribute to our source code

Features

• Compatibility with Magento 2
• 3-D Secure enabling/disabling
• Oneclick option configuration with custom rules
• Management of multiple cards per customer for one-click payment
• iFrame integration, hosted page and custom card API
• Mail management for transactions pending fraud validation (challenged)
• Manual and automatic capture
• Partial capture and refund
• Payment in x installments without fees
• Subscription management (development in progress)

Support

HiPay frequently releases new versions of the modules. It is imperative to regularly update your platforms to be compatible with the versions of HiPay’s APIs, which are also evolving.
HiPay offers support services provided that your platforms run on maintained PHP versions and updated CMS versions with the latest security patches (see the list below).
We are obligated to follow each publisher’s minimum recommendations.
If you encounter an issue while using the modules, before contacting our Support team, we invite you to:

• analyze your platform’s PHP logs as well as the logs specific to the HiPay module,
• update the module to the most recent version,
• perform similar tests on your stage environments,
• analyze possible overloading in the code and interferences with third-party modules,
• perform tests on a blank environment without your developments or any third-party modules.

Requirements

If you encounter problems when saving the configuration, you must increase the value of the php property "max_input_vars"

Minimum value:

max_input_vars = 10000

License

The HiPay Fullservice module for Magento 2 is available under the Apache 2.0 License. Check out the license file for more information.

Changelog

UNRELEASE

1.32.0

• Fix : Fixed fatal error when saving OneClick card without payment method data in notification.
• Add : Added Bancomat Pay payment method.
• Add : Added Apple Pay multi-browser configuration and checkout support with popup/modal display modes.

1.31.2

• Fix : Improved REFUND_REFUSED (165) handling when no operation ID is provided.

1.31.1

• Fix : Updated picqer/php-barcode-generator constraint to ^3.2 to avoid dependency conflicts.
• Fix : Prevent duplicate AUTHORIZED (116) notifications from returning an error when the order is already authorized.
• Fix : Resolved PHP 8.4 deprecated warnings (implicit nullable parameters) and upgraded Docker environment to PHP 8.4.6.

1.31.0

• Fix : Fixed compatibility with php 8.4 and 8.5
• Add : Enforced sending a validated Magento shipping address to PayPal V2 to prevent address changes on PayPal.
• Fix : Improved PayPal availability checks to prevent unnecessary API calls and errors.

1.30.0

• Fix : Restricted the Alma payment method to France only.
• Add : Added configurable email to send Multibanco and Mooney/SisalPay payment instructions when HiPay sends a notification.
• Fix : Fixed duplicate entries showing in Mapping Categories and Mapping Shipping grids.
• Fix : Improved detection of checkout agreement checkboxes for Apple Pay and PayPal payment methods.
• Fix : Removed the "Accept and Capture Payment" button and controller, relying on Magento's native "Accept Payment" action instead.

1.29.2

• Fix : Fixed Apple Pay card brand detection using payment_product property
• Fix : Fixed frontend scope for ResponseNotFoundOrderRepositoryInterface preference, thanks to zfmaster for issue #170

1.29.1

• Fix : Enhanced payment method validation with smart button visibility control for PayPal and Apple Pay.
• Fix : Handle manual capture notifications from Magento when HiPay response arrives before invoice creation, by generating the invoice with the operationId to avoid blocked orders.
• Fix : Enhanced One-Click functionality by adding a layer of validation for hosted field payment method

1.29.0

• Add : Made the cancellation delay configurable per payment method.
• Add : Use JS SDK for Oney, add Oney widget & include oney.io domain in CSP
• Fix : Improved RestoreBasketObserver to handle missing order during early HiPay notifications.

1.28.0

• Add : Enhanced SDK JavaScript security by implementing Subresource Integrity (SRI) with automatic integrity hash fetching
• Fix : Improved synchronization between mini cart and checkout cart for PayPal.
• Fix : Fixed PayPal environment switching (sandbox/production) per store view.
• Fix : Apple Pay failure occurring during timeout responses scenarios.
• Fix : Multibanco SIBS SPG integration -> Order API
• Fix : Handle "on hold" orders during authorization status update (status 116)

1.27.6

• Fix : Fixed payment product api store id
• Fix : Fixed default env stage value in config.xml for payment methods
• Fix : Improved efficiency of PayPal config provider service

1.27.5

• Fix : Fixed rounded amounts using higher value on PayPal and ApplePay payment methods
• Fix : Fixed payment product environment account merchant info
• Fix : Fixed PayPal checkout price in PopIn

1.27.4

• Fix : Simplified PayPal API version detection by using direct requestPaymentProduct method
• Fix : Updated selectors to make PayPal and Alma settings work across all Magento store views.
• Fix : Fixed rounded amounts using higher value on PayPal and ApplePay payment methods
• Fix : Fixed mini-cart display not showing items restored after payment cancellation.

1.27.3

• Fix : (OneClick) Prevent saving payment card details without proper authorization.

1.27.2

• Fix : Updated order status and state upon authentication failure with notification code 109, thanks to madleen for issue #167
• Fix : Avoid redundant ApplePay initialized session

1.27.1

• Fix : Updated order status and state upon transaction failure with notification code 113
• Fix : Modified the cleanPendingOrder cron job to exclude non-HiPay payment methods and restore cancel pending/pending_payment order state

1.27.0

• Add : Update OneClick payment
• Fix : Cancel order when payment abandonment instead of updated to pending state
• Fix : Fixed lock order table row while executing notification

1.26.0

• Add : Dynamically get Alma MAX/MIN from merchant account
• Fix : Lock order table row while executing notification
• Fix : Allow retrieving customer X-Forwarded-For IP addresse
• Fix : Replace deprecated Zend validator with Laminas validator, thanks to YoanSamuel for issue #164
• Fix : Removed redundant cancel during CleanPendingOrders

1.25.0

• Add : Added Klarna payment method
• Fix : Fixed issues on order timeout by redirecting customer to pending URL
• Fix : Fixed stock discount when Blocked (110) or Denied (111) notification is received

1.24.2

• Fix : Fixed display issue about ApplePay payment method which was displayed on unsupported devices
• Fix : Fixed issue about CSP policy

1.24.1

• Fix : Fixed issue about deprecated JavaScript / jQuery method
• Fix : Fixed error when CleanPendingOrders CRON job was running

1.24.0

• Add : Added new system to clean pending orders

1.23.0

• Fix : Fixed reference to pay rendering from customer's orders view
• Fix : Fixed CSP issues allowing inline scripts and new entries in csp_whitelist.xml
• Fix : Handle terms of conditions checkboxes
• Add: Add PayPal v2
• Add: Add rebranding colors and new logo to HiPay module

1.22.3

• Fix : Fixed stock discount when order refused or during clean pending orders, thanks to madleen for issue #163 and syno-bgt for issue #161
• Fix : Fixed cart restoration when cron mode is active, thanks to brmor-mistermenuiserie for issue #162
• Fix : Fixed email template for MO/TO payments

1.22.2

• Fix : Fixed HostedPayment method adding custom_css field for HostedPage v1 with Mix Payment

1.22.1

• Fix : Fixed PHP method usage when checking card holder
• Fix : Fixed coupon credit on order cancel - removed functionality, merchants are supposed to make this themselves
• Fix : Fixed notification process causing unclosed transactions
• Fix : Fixed notification error handling

1.22.0

• Fix : Fixed CRON for cleaning pending orders to support multi websites
• Fix : Fixed reference to pay rendering
• Fix : Fix translations
• Add : Added IT translation
• Fix : Fixed SDD order processing

1.21.0

• Add : Fully removed split payment processing.
• Add : Add cancel button option for hosted page.

1.20.0

• Add : Added support for new payment means :
  • Alma 3x
  • Alma 4x
• Add : Removed Split Payment method. Existing split payments are still processed normally.
• Add : Removed Hosted Page v1 option
• Add : Removed unsupported Klarna Invoice payment method
• Fix : Fixed issues with deprecations in PHP 8.2

1.19.1

• Fix : Fixed issues with deprecations in PHP 8.2

1.19.0

• Add : Added Mooney payment method using Hosted Fields
• Add : Removed some unused payment means
• Fix : Fixed coupon usage for customers after refunded or failed order, thanks to Synoffs for issue #156
• Fix : Fixed issues about PHP 8.2 deprecated functions

1.18.0

• Add : Added setting option to process HiPay notifications using CRON job
• Add : Added Multibanco reference to customer order view
• Fix : Fixed PHP 8 compatibility issues

1.17.0

• Add : Added HiPay CSP withelist
• Fix : Added documentation about PHP server configuration issue causing database saving problems
• Fix : Added more details on notification exceptions
• Fix : Fixed configuration rules for IDeal & Giropay payment methods
• Fix : Fixed missing configuration field for MbWay payment method
• Fix : Fixed date syntax on split payment screens
• Fix : Fixed enabling option for status field on split payment screens
• Fix : Fixed browser issue about <iframe> HTML tag
• Fix : Fixed invoice update when HiPay notification is processed before invoice creation
• Fix : Fixed notificiation process on BO

1.16.0

• Add : Added Bancontact Credit Card / QR code payment method
• Fix : Fixed order status as Cancelled when Expired notification (114) is received
• Fix : Fixed deprecation issues on recent PHP version

1.15.0

• Add : Removed Credit Card payment methods using Direct Post integration. Use instead Credit Card payment methods using Hosted Fields or Hosted Page
• Fix : Fixed deprecation issues with PHP 8 version

1.14.4

• Fix : Payment product for Oney Credit Long payment methods during order

1.14.3

• Fix : Fixed redirection on checkout error
• Fix : Fixed order auto cancellation if it's not paid until timeout
• Fix : Fixed credit memo generation when triggered from HiPay's back office
• Fix : Fixed cart generation for items without descriptions
• Fix : Fixed cart reloading on payment error

1.14.2

• Fix : Fixed upgrade script for non prefixed installations
• Add : Handle multiple OPC on the Credit Long payment method
• Fix : Fixed payment status of refunded orders

1.14.1

• Fix: Fixed Magento compiling

1.14.0

• Add: Added Mutlibanco and MB Way payment methods using Hosted Fields
• Add: Added ApplePay public credentials in HiPay configuration
• Add: Added authorization_code to additional_information in sales_payment_transaction
• Fix: Fixed DND Audit feedback

1.13.8

• Fix: PHP-7.4 compatibility

1.13.7

• Fix: Fixed CRON for cleaning pending orders

1.13.6

• Fix: Fixed notification on Capture Refused for orders via API
• Fix: Fixed ECI value for orders via Mail Ordering (MO)
• Fix: Fixed cancel pending orders CRON
• Fix: Fixed auto-cancel timer on Oney payment products

1.13.5

• Fix: Fixed auto-cancel timer on Paypal payment product
• Fix: Update PHP SDK to fix PSD2 parameter recovering

1.13.4

• Fix: Enabled HostedPage v2 by default
• Fix: notifications for retried orders on Hosted Page v2

1.13.3

• Fix: Merchant promotion oney
• Fix: Mbway phone
• Fix: Cancel order cron

1.13.2

• Fix: Expired Authorization notification handling
• Fix: Added option to restore the basket when user clicks on back button
• Fix: E-mail recovring method
• Fix: Split payment error handling
• Fix: Multisite category mapping
• Fix: SKU handling when making ONEY requests

1.13.1

• Fix: iDEAL Hosted Fields template

1.13.0

• Add iDeal Hosted Fields payment method
• Add Credit Long payment method
• Add Hosted Page v2 option on HostedPage parameters
• Add missing fields for Hosted payment methods
• Fix: placeOrder button blocking due to other active payment methods #132
• Fix: deprecated method from a Magento dependency
• Fix: payment product problem with hipay_hostedsplit payment method

1.12.2

• Fix: Corrected too high logging levels on some errors

1.12.1

• Fix: Notification handling
• Fix: Order expiration handling

1.12.0

• New: Add restrictions rules for Oney 3x, 4x
• Fix: HiPay card mapping categories
• Fix: PHP-7.4 compatibility

1.11.0

This release contains SQL changes, be sure to run the magento upgrade command:

 php bin/magento setup:upgrade

• [BETA] New: ApplePay support
• New: Added MB Way payment method
• New: Added MB Way product method on Hosted Page
• New: Added Illicado product payment on Hosted Page
• Fix: Notification processing on capture refused
• Fix: Configuration import from UAT to live
• Fix: MOTO email template redirect link

1.10.2

This release contains SQL changes, be sure to run the magento upgrade command:

 php bin/magento setup:upgrade

• Fix: Fix 500 error on checkout
• Fix: Corrected HTTP User Agent recovering
• Fix: Add custom shipping methods in mappings for dynamic shipping methods

1.10.1

• Fix: Fixed some errors on capture and notifications

1.10.0

• New: Added merchant promotion field for Oney With or Without Fees payment methods

1.9.1

• Fix: Fix Entity query
• Fix: Fix js minifying

1.9.0

• New: Added Multibanco payment method

1.8.1

• Fix: Removed fake value for shipto_house_number

1.8.0

• New: Retreive configuration from PHP SDK
• Fix: Corrected Astropay

1.7.3

• Fix: Missing method for Config class
• Fix: Wrong version in request source

1.7.2

• Fix: notification controller 302 HTTP code error (Magento 2.3.2) #121
• Fix: MO/TO credentials retrieval
• Fix: Disable oneclick when not logged-in
• Fix: Save oneclick cards on 116 and 118 notification

1.7.1

• Fix: wrong method declaration (PHP7.1 and less) #122

1.7.0

• Init 3DS V2

1.6.1

• Update payment method configuration form
• Fix issue #119

1.6.0

• Add MyBank payment method

1.5.0

• Add error message on field
• Update payment method configuration

1.4.3

• Fix bad require and bug with magento validation
• Improve notification capture with authorization

1.4.2

• Fix multi_use for one-click
• Fix Magento 2.3 compliance

1.4.1

• Fix entity name for new magento checks
• Fix Magento 2.3 compliance

1.4.0

• Add Payment Method Hosted Fields

1.3.4

• Fix cvv not mandatory for Maestro card
• Add command to convert data serialized to json

If you are migrating Magento from 2.1.X to 2.2.X and have defined 3DS or OneClick rules, you will need to run the new command to perform the migration.
See: https://devdocs.magento.com/guides/v2.2/release-notes/backward-incompatible-changes/

After your magento upgrade, execute in your magento directory:

 php bin/magento hipay:upgradeToJson

1.3.3

• Fix the exception with manual captures
• Fix compilation error

1.3.2

• #114 Fix issue #114 : Fatal error on failure order (#114)
• Fix : Split payment AI method cannot be displayed alone

1.3.1

• Fix : Change refund workflow
• Fix : Split payment status

1.3.0

• Add proxy settings (gateway requests)
• Fix : SEPA remove electronic signature
• Fix : partial refund

1.2.2

• Fix : Astropay payment method bug
• Fix : Category mapping bug
• Code rework/reformatting

1.2.1

• Fix : Api call wrongly formatted (gender)
• Fix : Issue #107
• Fix : Error on DI compilation #113
• Add casperJS tests
• Improve CI

1.2.0

• Add support for multi-currency payments
• Add hash algorithm selection in BO
• Add notification URL support
• Fix notification response (500 HTTP code on fail)
• Fix : split payment
• Fix : MOTO
• Fix : basket

1.1.8

• Add support for product without category and option basket

1.1.7

• New payment method support : Bnp Personal Finance 3X and 4X

1.1.6

• Fix invoice/credit-memo status (Pending/Paid) for partials captures

1.1.5

• Add time_limit_to_pay in HostedPaymentPageRequest
• Remove CDATA parameters ( Use custom_data now )

1.1.4

Fixed bugs:

• Missing authentication indicator

1.1.3

Fixed bugs:

• Error with RequestHandler compilation

1.1.2

Fixed bugs:

• Fix autoclosing tag for fingerprint javascript inclusion
• Change composer installation. Remove module installation in folder (app/code/Hipay). Now installation is in folder vendor
• Fix wrong invoice status with multiple partials capture
• Bad configuration for fingerprint.js

New feature:

• Parameter support : "operation_id"

1.1.1

• Bugfix CCType for hosted payment

1.1.0

• New feature FACILY PAY ONEY
• New feature KLARNA
• New feature Adding request sources
• New feature Adding custom data
• New feature Adding device fingerprint
• New feature ASTROPAY
• New feature SEPA SDD
• New feature POSTFINANCE
• New feature SOFORT
• New feature WEBMONEY & YANDEX
• New feature PRZELEWY24
• New feature GIROPAY
• New feature iDEAL
• New feature PAYPAL
• New feature Basket V2 (cart synced to HiPay)
• New feature Mapping categories Website <> HiPay
• New feature Mapping carriers Website <> HiPay with delivery date synced to HiPay
• FIX New branding
• FIX translations

1.0.8

• Skip Magento fraud checking

1.0.7

• Bugfix Add display selector value to TPP request

1.0.6

• Bugfix template iFrame send by the request new order

1.0.5

• Update documentation URL to the HiPay portal developer

1.0.4

• Bugfix PeriodUnit method and Docker image

1.0.3

• Bugfix namespace in class Sisal, Qiwi Wallet and unit tests

1.0.2

• Update version composer.json with new version PHP SDK and bumps package version

1.0.1

• README updates