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 13:04 (external edit)