Request Tokens

With Tokenization, a merchant will be able to remotely store credit card data in Gestpay archives and receive a Token in answer; the merchant will save the received Token in its system instead of the credit card data.

For the next purchases, the merchants will send to Gestpay the Token instead of the credit card number.

Gestpay will retrieve the credit card number from its archives starting from the Token and it will complete the transaction.

This operation provides the generation of a new Token during a transaction passing the requestToken field, so they will obtain a Token in response.

The correct WSs2s web service method to use for this purpose is callRequestTokens2S.

A group of merchants can share a set of tokens.

So if a merchant belongs to a group, it can use all the tokens of the other merchants of the same group.

Merchants cannot directly define and manage groups. Groups are managed only by Banca Sella operators, who will take care of the requests coming from merchants.

The available options are:

These are the mandatory informations to send to Gestpay:

The callRequestTokens2S method sends to Gestpay all previously assigned data, if the flag withAuth is set to Y then Gestpay uses these data to make a transaction request without affecting the account and returns the result of the operation; otherwise only the information about the card are returned back.

After the callRequestTokens2S request has been performed, it is possible to know the outcome of the operation by using the values in the relevant XML return:

See the description for other fields in the API section.