open menu
axerve docs
Payments/Credit card payments/Card verification

Card verification

SOAP

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 Axerve Ecommerce Solutions and receiving the result after the checks.

The WSs2sapi link web service method to use for this purpose is CallVerifycardS2Sapi link.

CallVerifycardS2S will also try to authorize the card using a very small amount.

This is the list of mandatory fields needed to verify the card:

  • 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.

The CallVerifyCardS2S method sends to Axerve Ecommerce Solutions all previously assigned data, which uses to make a transaction request without affecting the account and returns the result of the operation.

After the 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 TransactionResult field which will return the string OK if the transaction was authorised or the string KO if the transaction was not authorised.

  • If TransactionResult returns 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 ErrorCode method:

    • If ErrorCode returns 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 ErrorDescription method will return a description of the reason for the failure (in the language set within the Back Office environment).

    • If ErrorCode returns the value 0, the transaction did not fail due to technical problems. By using the ErrorCode it 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 ErrorDescription method.

  • If TransactionResult returns the value OK, the transaction was authorised and the card is considered valid.

Previous
prevCard check
Next
CVV field managementnext

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.