6.3.1. Secure Card Registration And Update

Knowledge Base

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

6.3.1 Secure Card Details Registration and Updating

The following is an example of a Secure Card Details Registration request for a terminal:

<?xml version="1.0" encoding="UTF-8"?>
<SECURECARDREGISTRATION>
	<MERCHANTREF>77001</MERCHANTREF>
	<TERMINALID>6491002</TERMINALID>
	<DATETIME>31-12-2008:23:59:59:001</DATETIME>
	<CARDNUMBER>4444333322221111</CARDNUMBER>
	<CARDEXPIRY>1208</CARDEXPIRY>
	<CARDTYPE>VISA</CARDTYPE>
	<CARDHOLDERNAME>Joe Bloggs<CARDHOLDERNAME>
	<HASH>d04c3bab519095ecb046eff91722e8df</HASH>
	<PERMITTEDTERMINALS>
		<TERMINALID>77002</TERMINALID>
		<TERMINALID>77003</TERMINALID>
	</PERMITTEDTERMINALS>
</SECURECARDREGISTRATION>


The following is an example of a Secure Card Details Updating request:

<?xml version="1.0" encoding="UTF-8"?>
<SECURECARDUPDATE>
	<MERCHANTREF>77001</MERCHANTREF>
	<TERMINALID>6491002</TERMINALID>
	<DATETIME>31-12-2008:23:59:59:001</DATETIME>
	<CARDEXPIRY>1208</CARDEXPIRY>
	<CARDTYPE>VISA</CARDTYPE>
	<HASH>d04c3bab519095ecb046eff91722e8df</HASH>
	<PERMITTEDTERMINALS>
		<TERMINALID>77002</TERMINALID>
		<TERMINALID>77003</TERMINALID>
	</PERMITTEDTERMINALS>
</SECURECARDUPDATE>


Fields description:

Filter:

Field Name Required to Register Required to Update Description
MERCHANTREF Y Y Unique Merchant Reference. Length is limited to 48 chars.
TERMINALID Y Y A Terminal ID provided by Worldnet.
DATETIME Y Y Format: DD-MM-YYYY:HH:MM:SS:SSS.
CARDNUMBER Y N The payment card number.
CARDEXPIRY Y N 4 digit expiry field (MMYY).
CARDTYPE Y Y Card type supported by terminal.
CARDHOLDERNAME Y N Cardholder name.
HASH Y Y An MD5 HASH. See note 1 below.
CVV N N The security code entered by the card holder. If sent (and “DONTCHECKSECURITY” not “Y”) then Worldnet will perform an authorisation for 1 major unit of the terminal currency. If authorised Worldnet will void the transaction so that it is not charged to the cardholder and add the SecureCard. If declined or referred Worldnet will return an error to the SecureCard registration request.
ISSUENO N N The issue no. of the card (Solo).
PERMITTEDTERMINALS N N List of permitted TERMINALID nodes. See example. (see section 6.1 above)


Notes:

1. If permitted terminals are not used, the MD5 HASH is generated using the following as an input string:

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


2. If permitted terminals are used, the MD5 HASH is generated using the following as an input string:

TERMINALID+MERCHANTREF+DATETIME+CARDNUMBER+CARDEXPIRY+CARDTYPE+CARDHOLDERNAME+PERMITTEDTERMINALS+secret


n.b. For updates where some of the fields are not sent they should just be omitted from the hash calculation.
If the card was successfully registered, response for registration request would be:

<SECURECARDREGISTRATIONRESPONSE>
	<MERCHANTREF>77001</MERCHANTREF>
	<CARDREFERENCE>2999990000000001</CARDREFERENCE>
	<DATETIME>31-12-2008:23:59:59:002</DATETIME>
	<HASH>d04c3bab519095ecb046eff91722e8df</HASH>
</SECURECARDREGISTRATIONRESPONSE>


Example of a successful card updating response:

<SECURECARDUPDATERESPONSE>
	<MERCHANTREF>77001</MERCHANTREF>
	<CARDREFERENCE>2999990000000001</CARDREFERENCE>
	<DATETIME>31-12-2008:23:59:59:002</DATETIME>
	<HASH>d04c3bab519095ecb046eff91722e8df</HASH>
</SECURECARDUPDATERESPONSE>


The following fields will be returned in the response:

Filter:

Field Name Description
MERCHANTREF Original Merchant Reference sent in registration request.
CARDREFERENCE System-Generated Card Reference (Secure Card).
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+DATETIME+secret



Error handling

If card was not registered or updated, error code and error message will be returned:

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


There is list of error codes and corresponding messages:

Filter:

Error Code Description
E01 SYSTEM ERROR - TRY AGAIN
E03 OPERATION NOT ALLOWED
E04 INVALID REFERENCE DETAILS
E05 INVALID CARD TYPE
E06 INVALID TERMINAL ID
E07 METHOD NOT SUPPORTED
E08 INVALID MERCHANTREF
E09 INVALID DATETIME
E10 INVALID CARDNUMBER
E11 INVALID CARDEXPIRY
E12 INVALID CARDHOLDERNAME
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.1._secure_card_registration_and_update.txt · Last modified: 2016/07/26 12:04 (external edit)