Knowledge Base

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

6.3.2 Card Details Removal

Note that SecureCard MerchantRef's cannot be re-used after deletion. This is because they are tied to existing transactions in our system and are retained internally for data integrity and future refund functionality.

Card details removal format:

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


Fields description:

Filter:

Field Name Required Description
MERCHANTREF Y Unique Merchant Reference. Length is limited to 48 chars.
CARDREFERENCE Y System-Generated Card Reference (Secure Card).
TERMINALID Y A Terminal ID provided by Worldnet.
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+CARDREFERENCE+secret


2. Card detail successful deletion response format:

<SECURECARDREMOVALRESPONSE>
	<DATETIME>31-12-2008:23:59:59:002</DATETIME>
	<HASH>d04c3bab519095ecb046eff91722e8df</HASH>
</SECURECARDREMOVALRESPONSE>


The following fields will be returned in the response:

Field Name Description
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+DATETIME+secret



Errors handling

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

<ERROR>
	<ERRORCODE>E08</ERRORCODE>
	<ERRORSTRING>INVALID MERCHANTREF</ERRORSTRING>
</ERROR>


There is a list of error codes and corresponding messages:

Filter:

Error Code Description
E01 SYSTEM ERROR - TRY AGAIN
E03 OPERATION NOT ALLOWED
E04 INVALID REFERENCE DETAILS
E06 INVALID TERMINALID
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.2._secure_card_removal.txt · Last modified: 2016/07/26 12:04 (external edit)