This operation makes it possible to check the card’s validity. It consists in sending the card data (such as the primary account number and the expiration date) to Gestpay and receiving the result after the checks.
CallVerifycardS2S will also try to authorize the card using a very small amount.
However, before using this method, it is necessary to assign all the information required through the valorisation of the following parameters:
shopLogin- merchant code
shopTransactionID- transaction identification code
cardNumber- credit card account number
expMonth- card expiration month
expYear- card expiration Year
CVV2- String containing the Card Verification Value printed on the credit card, as specified in the chapter Handling of CVV field.
CallVerifyCardS2S method sends to GestPay all previously assigned data, which GestPay uses to make a transaction request without affecting the account and returns the result of the operation.
CallVerifyCardS2S method has been performed, it is possible to know the outcome of the operation by using the values in the relevant XML return:
- First it is possible to use the
TransactionResultfield which will return the string
OKif the transaction was authorised or the string
KOif the transaction was not authorised.
TransactionResultreturns the string
KO, then it is possible to know whether the failure was due to a negative response from the credit card network, using the
ErrorCodereturns a value which is
<> 0, the transaction was denied due to technical problems; the value returned will vary according to the specific reason for the failure. The
ErrorDescriptionmethod will return a description of the reason for the failure (in the language set within the Back Office environment).
ErrorCodereturns the value 0, the transaction did not fail due to technical problems. By using the
ErrorCodeit is possible to know the error code associated with the failure; the description of the error will be shown in the language set within the Back Office environment by using the
TransactionResultreturns the value
OK, the transaction was authorised and the card is considered valid.