Knowledge Base

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

7.2.2 Stored Subscription Deletion Request

Note that Stored Subscription 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 issue tracing.

To delete stored subscription following XML Gateway request should be send:

<?xml version="1.0" encoding="UTF-8"?>
<DELETESTOREDSUBSCRIPTION>
	<MERCHANTREF>13231</MERCHANTREF>
	<TERMINALID>6491002</TERMINALID>
	<DATETIME>31-07-2009:20:49:34:798</DATETIME>
	<HASH>efc5a04b5a98be9bd59ec5383abb9161</HASH>
</DELETESTOREDSUBSCRIPTION>


Field description:

Field Name Required Description
MERCHANTREF Y Unique merchant identifier per terminal. Length is limited to 48 chars.
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+secret


Example of a successful stored subscription deletion response:

<DELETESTOREDSUBSCRIPTIONRESPONSE>
	<MERCHANTREF>13231</MERCHANTREF>
	<DATETIME>31-07-2009:20:49:35:381</DATETIME>
	<HASH>8a8f462278c730e9de5561d8f186d7dc</HASH>
</DELETESTOREDSUBSCRIPTIONRESPONSE>


The following fields will be returned in the response:

Field Name Description
MERCHANTREF Original Merchant Reference sent in registration request.
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 stored subscription 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:

Error Code Description
E01 SYSTEM ERROR - TRY AGAIN
E03 OPERATION NOT ALLOWED
E06 INVALID TERMINALID
E07 METHOD NOT SUPPORTED
E08 INVALID MERCHANTREF
E09 INVALID DATETIME
E13 INVALID HASH
Copyright © 2017 Worldnet Knowledge Base | Powered by DokuWiki
developer/integrator_guide/7._subscriptions/7.2._xml_subscriptions/7.2.2._stored_subscription_deletion.txt · Last modified: 2016/07/26 13:04 (external edit)