Knowledge Base

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

7.2.5 Subscription Deletion Request

Note that 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.
The following is an example of a Subscription Deletion request:

<?xml version="1.0" encoding="UTF-8"?>
<DELETESUBSCRIPTION>
	<MERCHANTREF>MR002</MERCHANTREF>
	<TERMINALID>6491002</TERMINALID>
	<DATETIME>31-07-2009:11:03:42:328</DATETIME>
	<HASH>53b6917aac8eb179e8b80f754c4afd5c</HASH>
</DELETESUBSCRIPTION>


Field description:

Field Name Required Description
MERCHANTREF Y Merchant Ref of subscription which should be deleted.
TERMINALID Y A TerminalID provided by Worldnet.
DATETIME Y Format:DD-MM-YYYY:HH:MM:SS:SSSS
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 subscription deletion response:

<DELETESUBSCRIPTIONRESPONSE>
	<MERCHANTREF>MR02-02</MERCHANTREF>
	<DATETIME>30-07-2009:15:34:24:305</DATETIME>
	<HASH>8bb39be67a1f05bf73fe334e12037257</HASH>
</DELETESUBSCRIPTIONRESPONSE>


The following fields will be returned in the response:

Field Name description
MERCHANTREF Original Merchant Reference sent in registration request.
DATETIME 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 subscription was not deleted, error code and error message will be returned:

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


Possible error codes are covered in the Subscription creation and updating error codes.

Copyright © 2017 Worldnet Knowledge Base | Powered by DokuWiki
developer/integrator_guide/7._subscriptions/7.2._xml_subscriptions/7.2.5._subscription_deletion.txt · Last modified: 2016/07/26 12:04 (external edit)