Setup the merchant profile

Each merchant can configure his/her profile by accessing the Gestpay Back Office environment at:

Authentication configuration

GestPay identifies the merchant requesting the encryption service through the WSCryptDecrypt web service by comparing the calling server IP address to the IP addresses configured in the profile associated with the Shop Login used for the call. If the calling server is not recognised, the transaction process ends and a specific error is returned.

In the Configuration - IP Addresses section of the Back Office environment, the merchant can enter the IP addresses of its servers (if calls to Gestpay originate from a server farm). There is no limit in the number of insertable IPs.

Configuration of response url and e-mail

GestPay communicates the transaction result with a server-to-server call to a page specifically prepared by the merchant and by directing the buyer’s browser to the pages configured by the merchant (different pages for positive or negative results).

In Configuration > Responses section in the Back Office environment, it is possible to specify the URLs used by the system to communicate the transaction result.

In this section it is also possible to specify the addresses that will be used for e-mail notifications.

M.O.T.O. : what happens after a transaction

M.O.T.O. stands for Mail Order - Telephone Order. Long before internet, the only way to pay without exhibiting the credit card was by telephone, or by mail.

In Gestpay, M.O.T.O. means that a transaction is carried out without physically handling the credit card.

M.O.T.O. is intended as the way the system should behave when receiving transactions. There are two options:

If the transaction is not carried out in 25 days (configurable), Gestpay will automatically cancel the transaction and the money will be returned to the buyer. 25 days is the maximum number of days that a transaction can be authorized before being cancelled.

M.O.T.O. settings are valid for all credit card transactions, including MasterPass, ApplePay, Hype, or token transactions.

M.O.T.O. settings are valid for every Gestpay plan. Your settings will be used to determine the transaction next state, weather you’re using Gestpay payment page, or the iFrame solution, or server-to-server calls.

Configuration of Fields & Parameters

Mechants may want to display or not some fields in the payment page, or in the email response, depending on their needs; think of the buyer’s email or the buyers name. In Configuration > Fields & Parameters you can decide which parameters to show, and when.

Sending Custom Parameters to Gestpay

During the Encrypt call you can also pass user-defined parameters. This is completely optional and can be useful for attaching some additional data (a sessionId, a variable, etc.) that you want to receive back when the payment is completed (or failed).

From the page Payment Page -> Fields & Parametrs, create the custom parameter by clicking on Add parameter in the Merchant Back-Office:

Then fillout the box with your parameter’s name:

A description of the fields:

Once you have set up a new parameter (in the examples the parameter is called MYPARAM) you can send it via the webservice method Encrypt.

You can code your custom parameters inside the field customInfo, paying attention to the syntax:

<customInfo>datum1=value1*P1*datum2=value2*P1* ... *P1*datumN=valueN</customInfo>

Formally, it is a string containing couples of key=value separated by the special string *P1*.

Here is an example of customInfo:


Once the Encrypt request has been received, and the payment processed, the Decrypt result will contain the same parameters back in another customInfo field.

For more informations about customInfo, check out the API.