6.3.3. Secure Card Search

Knowledge Base

Get help for payment solutions. Search our articles or browse by category below.

6.3.3 Card Details Search

Secure Card search by Merchant Reference can be performed as needed:

<?xml version="1.0" encoding="UTF-8"?>
<SECURECARDSEARCH>
	<MERCHANTREF>77001</MERCHANTREF>
	<TERMINALID>6491002</TERMINALID>
	<DATETIME>31-12-2008:23:59:59:001</DATETIME>
	<HASH>d04c3bab519095ecb046eff91722e8df</HASH>
</SECURECARDSEARCH>


Field description:

Field Name Required Description
MERCHANTREF Y Unique Merchant Reference. Length is limited to 48 chars.
TERMINALID Y A Terminal ID provided by Worldnet.
PERMITTEDTERMINALSREQUIRED N Should a list of permitted terminals be included in the response? Y or N.
DATETIME Y Format: DD-MM-YYYY:HH:MM:SS:SSS.
HASH Y An MD5 HASH. See note 1 below.


Notes:

1. The MD5 HASH is generated using the following as an input string:

TERMINALID+MERCHANTREF+DATETIME+secret


Secure Card details successful deletion response format:

<SECURECARDSEARCHRESPONSE>
	<MERCHANTREF>77001</MERCHANTREF>
	<CARDREFERENCE>2967532702149716</CARDREFERENCE>
	<CARDTYPE>VISA</CARDTYPE>
	<CARDEXPIRY>1208</CARDEXPIRY>
	<CARDHOLDERNAME>Joe Bloggs<CARDHOLDERNAME>
	<DATETIME>31-12-2008:23:59:59:001</DATETIME>
	<HASH>d04c3bab519095ecb046eff91722e8df</HASH>
</SECURECARDSEARCHRESPONSE>


The following fields will be returned in the response:

Field Name Description
MERCHANTREF Unique Merchant Reference.
CARDREFERENCE Card Reference.
CARDTYPE Card type supported by terminal.
CARDEXPIRY 4 digit expiry field (MMYY).
CARDHOLDERNAME Cardholder name.
PERMITTEDTERMINALS List of permitted TERMINALID nodes. (see section 6.1 above)
DATETIME Format: DD-MM-YYYY:HH:MM:SS:SSS.
HASH An MD5 HASH. See note 1 below.


Notes:

1. The MD5 HASH is generated using the following as an input string:

TERMINALID+MERCHANTREF+CARDREFERENCE+CARDTYPE+CARDEXPIRY+CARDHOLDERNAME+DATETIME+secret



Errors handling

If request was not successful, error code and error message will be returned:

<ERROR>
	<ERRORCODE>E04</ERRORCODE>
	<ERRORSTRING>INVALID REFERENCE DETAILS</ERRORSTRING>
</ERROR>


There is a list of error codes and corresponding messages:

Error Code Description
E01 SYSTEM ERROR - TRY AGAIN
E03 OPERATION NOT ALLOWED
E04 INVALID REFERENCE DETAILS
E06 INVALID TERMINAL ID
E07 METHOD NOT SUPPORTED
E08 INVALID MERCHANTREF
E13 INVALID HASH
Copyright © 2017 Worldnet Knowledge Base | Powered by DokuWiki
developer/integrator_guide/6._secure_card_storage/6.3._xml_secure_card_integration/6.3.3._secure_card_search.txt · Last modified: 2016/07/26 12:04 (external edit)