Knowledge Base

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

7.2.4 Subscription Updating Request

The following is an example of a Subscription Updating request:

<?xml version="1.0" encoding="UTF-8"?>
<UPDATESUBSCRIPTION>
	<MERCHANTREF>MR001</MERCHANTREF>
	<TERMINALID>6491002</TERMINALID>
	<SECURECARDMERCHANTREF>8328</SECURECARDMERCHANTREF>
	<DATETIME>30-07-2009:09:59:38:921</DATETIME>
	<NAME>Animal Life</NAME>
	<DESCRIPTION>Magazine membership</DESCRIPTION>
	<LENGTH>12</LENGTH>
	<RECURRINGAMOUNT>15.87</RECURRINGAMOUNT>
	<STARTDATE>23-08-2009</STARTDATE>
	<ENDDATE>22-08-2010</ENDDATE>
	<EDCCDECISION>Y</EDCCDECISION>
	<HASH>53b6917aac8eb179e8b80f754c4afd5c</HASH>
	<CUSTOMFIELD NAME=”ACCOUNTID”>132453462</CUSTOMFIELD>
	<CUSTOMFIELD NAME=”EVENTID”>FG00001</CUSTOMFIELD>
</UPDATESUBSCRIPTION>


Field description

Filter:

Field Name Required Description
MERCHANTREF Y Merchant Ref of subscription which should be updated.
TERMINALID Y A TerminalID provided by Worldnet.
SECURECARDMERCHANTREF N Merchant Reference of a Secure Card which will be used to do recurring payments. (Only one of SECURECARDMERCHANTREF OR CARDREFERENCE must be present)
CARDREFERENCE N System-Generated Secure Card reference (Only one of SECURECARDMERCHANTREF OR CARDREFERENCE must be present)
DATETIME Y Format: DD_MM_YYYY:HH:MM:SS:SSS.
NAME N Subscription Name.
DESCRIPTION N Subscription Description.
LENGTH N Subscription Length.
RECURRINGAMOUNT N New Recurring Amount.
STARTDATE N Subscription Start Date.
ENDDATE N Subscription End Date, if it is not set subscription will continue until manually cancelled or length reached (if it is set).
EDCCDECISION N This field is supported by a eDCC-enabled terminals only and will be ignored if terminal doesn`t supports eDCC. Can be “Y” or “N”.
HASH Y An MD5 HASH. See note 1 below.


Notes:

1. If “SECURECARDMERCHANTREF” is used, The MD5 HASH is generated using the following as an input string:

TERMINALID+MERCHANTREF+SECURECARDMERCHANTREF+DATETIME+STARTDATE+secret


2. If “CARDREFERENCE” is used, the MD5 HASH is generated using the following as an input string:

TERMINALID+MERCHANTREF+CARDREFERENCE+DATETIME+STARTDATE+secret


Example of a successful subscription updating response:

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


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 subscription was not updated, 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.4._subscription_updating.txt · Last modified: 2016/07/26 12:04 (external edit)