open menu
axerve docs
Plugin/WooCommerce

WooCommerce WooCommerce

Available features
attivaS2S SOAP (except callReadTrxS2S and callVerifyCardS2S)
attivaTokenization
attiva3DS1
attiva3DS2 – Authentication
attiva3DS2 – Recurring transactions
attivaRBA (Risk-Based Authentication)
attivaPayPal Seller Protection
Available Payment Methods
Carte di credito
BANCOMAT Pay
MyBank
PayPal
PayPal Billing Agreement
PayPal Buy Now Pay Later

WooCommerceexternal link is a marketplace plugin for wordpress. You can start selling your items in less than 15 minutes, and there are also many plugins to accomplish all your needs.

Axerve Ecommerce Solutions develops and distributes a free plugin for WooCommerceexternal link.

Prerequisites

The only prerequisite is that you already know how to use Wordpress and WooCommerce, as a user. You won’t need coding skills to use the plugin.

To simplify the configuration, use a Wordpress instance deployed on a public server. Using it on a local server might be difficult since Axerve Ecommerce Solutions might not be able to access your machine from outside.

How to install

Download the zip file and save to a known location on your hard drive.

In Wordpress, Plugins > Add New; search for Gestpay for WooCommerce and click install now.

Don’t forget to Activate the plugin.

If you want to manual install the plugin, you can find it in the Wordpress Plugin Repositoryexternal link.

Configure Gestpay for WooCommerce

Once installed and activated, you’ll can go to WooCommerce > Settings and click on Gestpay for WooCommerce tab to configure the plugin.

There are four operational modes in this plugin, selectable by the Account Version dropdown. Which one to use depends on Axerve Ecommerce Solutions version you are using:

  • Axerve Ecommerce Solutions Starter

  • Axerve Ecommerce Solutions Professional

  • Axerve Ecommerce Solutions Professional On Site

  • Axerve Ecommerce Solutions Professional iFrame

default

The plugin also supports Subscriptions.

Axerve Ecommerce Solutions Starter

Gestpay Starter is the easiest version of the plugin. By using this, your buyer will be redirected to Axerve Ecommerce Solutions payment page. After the payment, the user is redirected again on your website.

Here we will describe the configuration options.

Field
Description

Axerve Shop Login

The unique Axerve Ecommerce Solutions identifier. You can also use a test shop login (see below). Here you can insert either the TEST shopLogin (starting with GESPAYXXXXX) or the production shop login, that consists of only numbers (example: If your login code to the Merchant Back-Office is XX912345, you should use only 912345).

IP Address

The plugin will detect the server public IP. Use this IP to configure Axerve Ecommerce Solutions.

Sandbox mode

Check if you want to redirect your payments to the test environment, where you can test the payment process without real credit card numbers and money.

Debug log

Check if you want to save a log of the data sent to Axerve Ecommerce Solutions. Useful for testing and for bug reporting.

Force response verification

In case of problems with order status updates, check this option. The Axerve Ecommerce Solutions response will be forcely verified.

Axerve Ecommerce Solutions Professional

With Axerve Ecommerce Solutions Professional you can further customize the way Axerve Ecommerce Solutions interacts with your users. Your buyers will still be redirected to Axerve Ecommerce Solutions payment page for credit card payments, but you can also configure Axerve Ecommerce Solutions to work with alternative payment methods (like PayPal), so that your users can choose the payment method they prefer.

You can choose to send to Axerve Ecommerce Solutions the buyer e-mail and name, a language parameter, and even some custom parameters.

Besides the options already described for Axerve Ecommerce Solutions Starter, here’s a description for Axerve Ecommerce Solutions Professional settings:

Field
Description

Buyer e-mail

Check if you wish to send to Axerve Ecommerce Solutions the buyer’s e-mail.

Buyer name

Check if you wish to send to Axerve Ecommerce Solutions the buyer’s name.

Language

Checking this option you can change the language of the payment page.
The languages available in Axerve Ecommerce Solutions are italian, english, french, german and spanish.
To use this functionality you have to enable a multilingual plugin: GestAxerve Ecommerce Solutionspay for WooCommerce is compatible with qTranslate-Xexternal link and with WPMLexternal link.
If you prefer to replicate the same website in many languages, you can define the constant WPLANG in wp-config.php, for example define ('WPLANG', 'it\_IT');.

Custom info

Here you can insert custom data in the form of parameter=value, one per row. The following characters, together with the space character, are not admitted: & § ( ) \* , ; : \*P1\* / /\* [] ? = % ~. Remember to enable the custom parameter in the Merchant Back-Office.

Payment Types

Check if you want to redirect your users directly to a specific payment method.

Alternative Payments

Here you can enable other systems, like PayPal, Sella Personal Credit, etc.

Axerve Ecommerce Solutions Professional On Site

Axerve Ecommerce Solutions Professional On Site allows the user to pay directly from your website, without redirects. On page /checkout the user will be able to insert, along with the shipping address, his payment details.

With Professional On Site you can also memorize a masked version of the credit card that you can later use to simplify the shopping process, or to enable subscriptions (see the subscriptions paragraph).

Professional On Site adds some new parameters to the settings page, besides the ones already described for Starter and Professional.

Field
Description

Store Tokens

if enabled, a token is requested to Axerve Ecommerce Solutions and stored in the database. With tokens you can enable recurrent payments; a logged user can also pay without inserting credit card data.

CVV

Send the CVV field to Axerve Ecommerce Solutions, when requesting a Token. Note: the field must be set as input in the Merchant Back office, otherwise you’ll receive an error.

3D Secure

if checked, the 3D Secure must is enabled for this shop (default).

default

3D Secure is a security protocol. If the card supports 3D Secure, the user is temporarly redirected on the cardholder website to enter a personal code. This guarantees that the transaction is non disputable; However, for subscriptions or automatic payments this feature must be disabled (ask the customer care for this), otherwise the payments will fail.

Axerve Ecommerce Solutions Professional iFrame

Axerve Ecommerce Solutions professional iFrame is very similar to Professional On site; however, after the checkout phase the user is redirected to checkout/order-pay/:id/, where :id is the order number.

Aviable settings are the same of the previous versions. The differences are that with iFrame version the buyer cannot choose his tokenized credit card; however, the site can still sell subscriptions and recurring payments using this method.

Subscription

Axerve Ecommerce Solutions for WooCommerce supports subscriptions and recurrent payments, by using the WooCommerce Subscriptionsexternal link plugin (not included).

To start, create a subscription product in your shop. To do this, setup the pricing as this:

In WooCommerce Subscriptions documentationexternal link you will find detailed tutorials and guides to setup a subscription product.

Your products will show like this (your theme might change the graphics):

To enable recurring payments:

  • You must choose one of Axerve Ecommerce Solutions Professional iFrame or On-Site.

  • Store Tokens checkbox must be selected

  • 3D Secure checkbox must not be selected. If 3D secure is enabled, the payment will block waiting for the user PIN. Contact Axerve Ecommerce Solutions Customer support to disable 3D Secure verification.

Once the payment is performed, you’ll see the recurring payments in WooCommerce -> Orders page:

To test subscriptions, please refer to WooCommerce Subscriptions docsexternal link.

Be aware that a recurrent transaction can fail, for example if the card is elapsed or if the aviable amount on the card is negative; when this occours, the subscription stops and the buyer must pay manually from his account page. To automatically retry failed payments, you can choose the option Retry Failed Payments from WooCommerce Subscriptions.

For more details about failed payments, checkout this pageexternal link.

Deactivating subscriptions on WooCommerce

Beside the deactivation of the module, it is necessary to clean the tail of the pending subscriptions. Axerve plugin engages with the Subscriptions functionalities and in case of scheduled actions, it makes a call on the planned date anyway. Therefore, it is necessary to check and, if needed, manually cancel the still active scheduled actions.

To complete the deactivation it is necessary to follow the operations indicated at this link: https://docs.woocommerce.com/document/subscriptions/disabling-subscriptions/external link

Refund - Settle - Delete

By clicking on the order number you the order details, plus a section with three buttons RefundSettleDelete (left bottom): their actions depend on your M.O.T.O. configuration. Let’s see this in action.

  • Refund : When a transaction is already settled, you can refund it partially or totally by clicking this button. Clicking on it will show you a box like the following:

default

The button Refund X,XX€ manually is a default button and does not perform a real refund: with this button you are telling WooCommerce that you have already performed (or you will perform) a refund from Gestpay Backoffice.

default

Using Refund X,XX€ via Axerve Ecommerce Solutions will perform the refund operation directly, using Axerve Ecommerce Solutions APIs.

  • Settle: if your MOTO configuration is set to separation of the authorization and the transaction process, after an order your transaction is only authorized; by clicking this button, you settle it.

  • Delete: if your MOTO configuration is set to separation of the authorization and the transaction process, your transaction is authorized but not settled. By clicking this button you delete the authorized transaction.

At the right of the page you can also see a log of every action occurred to your transaction. This is extremely useful for debugging and to get a sense of what’s going on.

Acyivate Gestpay for WooCommerce

Once you have set up your plugin with the Axerve Ecommerce Solutions account, move to WooCommerce > Settings and select the Checkout tab.

Here you’ll see the Axerve Ecommerce Solutions menu enabled. Depending on the configured alternative payments, you might find other payment methods. For example, in the image below you’ll see Gestpay Pro PayPal.

Clicking on Gestpay, you can:

  • Enable/disable the payment method

  • Set a Title and a description (that will be shown to the user on checkout)

  • Choose the icons that will be shown to the user.

Configuration for custom alternative payments enabled is similar.

Configure the Merchant Back Office

A merchant can configure the Merchant Back Office to receive requests from WooCommerce plugin. There are two environments available:

To request a test account, go to the registration page.

Configure Authentication

Axerve Ecommerce Solutions will identify the merchant by comparing his IP address with the ones that are configured in the Merchant Back-Office. To insert your address or addresses, go to Configuration > Environment and click on IP Address.

Configure redirect addresses

Axerve Ecommerce Solutions will notify the transaction status redirecting the browser to pages that are set up by the merchant (for example, success.php o error.php).

In Configuration > Environment click on Response Address and set the relevant data for customer care, fraud prevention, etc.

Then, set the Url for positive answer and the URL for negative answer. If your website address is http://yoursite.com, you have to set http://yoursite.com/?wc-api=WC_Gateway_Gestpay in both fields.

warning

It is very important that ?wc-api=WC_Gateway_Gestpay is appended to your website address. With this code, the plugin will understand that the call is from Axerve Ecommerce Solutions and will do decrypt the call. Then, the user is redirected to WooCommerce’s configured Order Received page.

warning

It is important that all the three URLs have that string appended.

LOG files

There are two ways to reach the plugin logs:

  1. Woocommerce > Stato > Log and selecting the Gestpay log related to the interested day, e.g.: gestpay-for-woocommerce-2021-03-02-137cd59a529d112ba849c25a34b429fc.log (2 Marzo 2021 alle 16:17)

  2. Alternatively, it is possible to access the file from path-di-base-del-sito/wp-content/uploads/wc-logs/ within which all the logs are identified by “gestpay-for-woocommerce-2021-ecc…”

For further information, a guide on how to activate logs in WooCommerce is available. https://pagely.com/blog/wordpress-logs-track-errors-guide/external link

Functionality

Functionality
Functions to be contracted and/or configured on the Backoffice

iFRAME

iFrame

Card saving and token use

  • Tokenization

  • Authorisation S2S

  • Enable TOKENTOKENEXPMONTH e TOKENEXPYEAR fields in “Fields & Parameters” section of Backoffice

Settle payments

Cancel and settle S2S

Cancel payments

Cancel and settle S2S

Refund

Refund S2S

MyBank on mobile divices

To use MyBank on mobile devices, activate the method in the control panel:

Then enable the payment component in the “payments” tab:

And then check the ”Mandatory bank selection” field:

In the checkout page, the option to select your desired bank will now be visible:

This option works with the three contract options (Professional, On-Site and iFrame).

Previous
prevPossible MOTO Configuration
Next
Salesforcenext

Create your test account to try the service!

Register
© 2007-2024 Axerve S.p.A. Company with Single Shareholder belonging to the Maurizio Sella S.a.a. VAT Group with VAT no. 02675650028 – Tax Code 02686620028 – Biella Court registration no. 71524 – Piazza Gaudenzio Sella 1, 13900 Biella – Share Capital € 4,000,000.00 fully paid-in – Registered in the Reg. Impr. C.C.I.A.A. Monte Rosa Laghi Alto Piemonte – Registered in the Register of Payment Institutions.