This operation makes it possible to check the card’s validity, like
CallVerifyCardS2S, and to also get other info regarding the card.
It consists in sending data about the card (such as the account number and the expiration date) to the bank’s server and in receiving the result after processing by the bank’s server.
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
Ywill try to authorize the card;
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 is returned back (like
callCheckCartaS2S method has been performed, it is possible to know the outcome of the operation by using the values in the relevant fields:
- First it is possible to use the
TransactionResultmethod which will return the string
OKif the check has been performed or the string
KOif not. In the fields
TransactionErrorDescriptionthere are the detailed information in case of error.
AuthorizationResultmethod which will return the string
OKif the transaction was authorised or the string
KOif the transaction was not authorised
AuthorizationResultreturns 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
AuthorizationErrorCodereturns 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
AuthorizationErrorDescriptionmethod will return a description of the reason for the failure (in the language set within the Back Office environment).
AuthorizationErrorCodereturns the value
0, the transaction did not fail due to technical problems. The description of the error will be shown in the language set within the Back Office environment by using the
AuthorizationResultreturns the value
OK, the transaction was authorised and the card is considered valid.
See the description for other fields in the API section.