WooCommerce Enterprise

The HiPay Enterprise extension for WooCommerce is a PHP plugin which allows you to accept payments in your WooCommerce store, offering innovative features to reduce shopping cart abandonment rates, optimize success rates and enhance the purchasing process on merchants’ sites to significantly increase business volumes without additional investments in WooCommerce, the e-commerce plugin for WordPress.

Platform Configuration

IP Address

When a request is sent to the HiPay Enterprise servers, the IP address or IP address range from where the connection was made is verified. If it matches with the IP address previously provided by the merchant, the request will be processed. In case of missing or incorrect information, the server will respond with an appropriate error message, indicating the error in the request.

To allow the IP addresses of your servers, you must log in your HiPay Enterprise back office (https://merchant.hipay-tpp.com), click on the “Integration“ tab, then on “Security Settings“ and enter your IP address(es) in the “IP Restriction“ section.

When changing your IP addresses, make sure that all the new ones are configured for your account. If not, your server requests will be rejected.

Notifications URLs

To use the HiPay Enterprise extension for WooCommerce, you must configure the notification URLs.

To do so, two methods are possible.

1. The notification URL is sent by the CMS in the transaction request (Recommended)

You must enable the option “Send url Notification“ in the HiPay Enterprise Credit Card payment method configuration panel, under the Payment Method tab.

2. Configure the URL in your HiPay Enterprise back office

To do so, go to your HiPay Enterprise back office, then to the “Integration“ tab, in the “Notifications“ section.

FAQ: Find answers to frequently asked questions on how to use the plugin.

Plugin Settings

This tab allows you to configure the API IDs required to run HiPay services.

It is comprised of the following components that you must set up first and foremost.

Plugin mode

This setting is very important as it allows you to define whether payments will be processed on the HiPay Test or Production platform. By default, the plugin is in Test mode, which means that payments will not be actually charged.

We strongly advise you to run tests before launching your site in Production mode.

Production configuration

Use this interface to specify the credentials linked to your HiPay account. These identifiers are used if your plugin is configured in Production mode.

For more information about credentials generation, please refer to the Credentials section.

Account (Private)

Private credentials are used to process payments through the HiPay APIs. These identifiers are mandatory.

Name

Description

Username

Your HiPay Enterprise production account API username

Password

Your HiPay Enterprise production account API password

Secret passphrase

Your HiPay Enterprise secret passphrase

Tokenization (Public)

Public credentials are used as part of the JavaScript tokenization. These identifiers are to be specified only if you want to use the plugin in Hosted Fields mode.

Name

Description

Username

Your HiPay Enterprise production account API username

Password

Your HiPay Enterprise production account API password

Test configuration

This interface is similar to the Production configuration. These identifiers are used if your plugin is configured in Test mode.

Fraud screening

Based on the screening results of HiPay Sentinel, our advanced anti-fraud solution, when a transaction is suspected of being fraudulent, it is in “challenged“ status. In your WooCommerce back office, the order is flagged as being “On-Hold”.

An email is then sent to the site administrator to warn him/her that a transaction has been “challenged” and that it must be accepted or declined.

With this interface, you can add recipients for email notifications about “challenged” transactions. You must enter a valid email address: when a transaction is being challenged, an email will be sent to this address.

Accepting or declining transactions

At the moment, it is only possible to do so from your HiPay Enterprise back office. Once a transaction is accepted or declined, the order is then updated in your WooCommerce back office.

Credit Card

After setting up the previous required components, this interface allows you to define global payment settings and settings specific to the credit card payment method.

To activate a payment method, please refer to this example from the WooCommerce official documentation.

Settings

This general configuration will be applied whatever the payment methods being used.

Name

Description

Value

Operating mode

Defines if the payment form is displayed on the merchant’s site or on a HiPay payment page.

– Hosted Fields: Customers complete their banking information directly on the merchant’s site but the form fields are hosted by HiPay. This mode is only valid for credit cards.

Capture

Defines if payments should be captured manually or automatically. Manual capture will be possible either on the order page of the WooCommerce back office or on the HiPay Enterprise back office. Please refer to the section on Capture mode.

– Manual: All transactions will be captured manually either from your HiPay Enterprise back office or from your WooCommerce back office.

– Automatic: All transactions will be captured automatically.

Customer’s cart sending

The customer’s cart will be sent during the transaction. This option is required for Oney transactions.

“Yes”/“No”

Logs information

Activates debug logs.

Activate 3-D Secure

Enables and configures 3DS rules.

You can choose between three options:

– Disabled (to bypass 3-D Secure authentication)

– Try to enable for all transactions

– Force for all transactions

Send url Notification

The URL used by HiPay to send the notifications is directly filled in the order transaction.

“Yes”/“No”

Hosted Page

When you choose the “Hosted page“ as operating mode, you have access to additional settings.

Name

Description

Value

Display hosted page

Defines if the Hosted Page is displayed in an iFrame or with a redirect.

All card types are enabled and set to default. For each type of card, you can then define a different configuration.

Name

Description

Value

Activated

Allows or not customers to use this type of card.

“Yes” / “No”If the card type is not activated, customers will have a warning message upon payment, inviting them to use another type of card.

Minimum order amount

Indicates a minimum threshold for the type of card available for payment.

Amount in default currencyIf the amount is not reached, customers will have a warning message upon payment, inviting them to use another type of card.

Maximum order amount

Indicates a maximum threshold for the type of card available for payment.

Amount in default currencyIf the amount is exceeded, customers will have a warning message upon payment, inviting them to use another type of card.

Currencies

Currencies for which the card type will be activated. These are the installed and active currencies on your store

Selection of one or more currencies

Countries

Countries for which the card type will be activated.

Selection of one or more countries

Local Payment Means

Local payments include all payments other than credit cards. In this block, you can find the link to all local payments settings interfaces.

Activation

To activate a payment method, please refer to this example from the WooCommerce official documentation.

Configuration interface

To configure the HiPay Enterprise plugin, click on “WooCommerce -> Settings -> Payments“ in your WordPress dashboard. Then click on the name of the payment method you want to configure (“HiPay Enterprise Bnppf-3xcb“ for example).

Settings

Configuration is done as for credit cards, except for certain local payments: “currencies” and “countries” cannot be modified because they are imposed by each payment method.

You can also define the following element for each payment method.

Name

Description

Value

Display name

Name displayed on the WooCommerce checkout page

String

Capture

Automatic mode

When making a purchase in “automatic” mode, the capture is automatically requested right after authorization.

If the payment fails, the customer is redirected to an error page and the status is defined as “Cancelled“.

If the payment is successful, the customer is redirected to the success page and the status is defined as “Completed“.

Manual mode

When making a purchase in “manual” mode, the transaction status will be “On-Hold“ until you ask for the capture. The customer is not charged directly: you have seven days to “capture” the order and charge the customer. Otherwise, the order is cancelled.

If the authorization fails, the customer is redirected to an error page and the status is defined as “Cancelled“.

If the authorization is successful, the customer is redirected to the success page and the status is defined as “On-Hold“.

To capture a transaction in your WooCommerce back office:

Go to your list of orders and select any one. The order status should be “On-Hold”. Manual and partial captures are not native WooCommerce features. If you are familiar with the WooCommerce system for captures, the principle of capture is based on manual capture.

If the order is in the correct status and if the amount already captured does not reach the total of the order, you should have a “Capture” button to the right of the “Refund” button in the panel for the item.

Click on the “Capture“ button. Specify the quantity of product(s) to be captured in the text box(es) displayed for each item line. The capture amount will be automatically adjusted based on the product(s) captured. You can also capture delivery costs: make sure to fill in the tax.

Then click on “Capture €XX via HiPay Enterprise Credit Card“

Once the capture is made, a line appears for each item, indicating “Captured with HiPay” or the quantities and amounts captured. The status of the order will evolve to:

– Partially captured if you have not captured all the items of the order,

– Processing if you have captured them all.

“Partially captured” is a status added by the HiPay extension that allows you to easily identify orders partially captured. It is similar to WooCommerce’s “On-Hold” status. Therefore, all the actions relating to a change of status will be performed when the order status changes from “Processing” to “Complete”.

Refund

The plugin supports the WooCommerce native feature for refunds. To make a refund:

Go to: “WooCommerce > Orders“.

Select the order you wish to refund.

Click on the grey Refund button.

Specify the quantity of product(s) to be refunded in the text box(es) appearing for each item line. The refund amount will be automatically adjusted based on the product(s) refunded. If inventory levels are not managed, you can also simply enter the Refund amount, without adjusting the product quantity. If the quantities of items are not set when issuing a refund, the order will not be marked as refunded and the email that is sent will say “partial refund.”

Add refund notes, if desired.

Click on “Refund $X via HiPay”.

The status of the order will evolve to:

– Partially refunded if you have not refunded all the items of the order. This status has been added by the HiPay extension for allowing you to easily identify orders partially refunded.

– Refunded if you have refunded them all. You can also make a total refund directly from your HiPay Enterprise back office. The order will then be automatically updated in your WooCommerce back office.

For more information, please refer to the WooCommerce documentation on Refunds.

Category & Carrier Mapping

The customer’s cart information can be sent with the transaction details if you enabled the option in the global settings. This mapping is necessary to establish a correlation between your data and HiPay’s. It is mandatory to do all the mappings to use the Oney Facily Pay payment method.

All the delivery methods available on your store are listed. For each of them, you must fill in the necessary corresponding information.

This information is used to calculate an approximate delivery date.

Name

Value

Order preparation estimated time

Expressed in days

Delivery estimated time

Expressed in days

HiPay delivery mode

– store: At the store

– carrier: Delivery by carrier

– relaypoint: Delivery in a pick-up location

– electronic

– travel

HiPay delivery method

– standard

– express

– Priority 24H

– Priority 2H

– Priority 1H

– Instant

Logs

HiPay logs all the necessary information if there is a problem with the plugin. These logs will be requested by HiPay’s technical teams in case of an issue. The HiPay Enterprise plugin uses the default log system from WooCommerce. To access your logs, go to “WooCommerce -> Status -> logs“.

There is no sensitive information in these logs (e.g: card numbers).

You will find different categories of logs in this interface.

Error logs: All errors that occurred on the HiPay Gateway

Info logs: Technical and debug logs

Callback logs: HiPay Gateway notifications

Request logs: Calls to the HiPay Gateway

Custom Data

With this extension, you have the possibility of sending additional information with the transaction details that can then be viewed in your HiPay back office. To do so, you can use the filter functionality from WordPress. Custom data can be received through HiPay notifications and processed later.