Knowledge Base

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

5.2 Transaction Status Updates

Transaction updates allow you to update the status of a transaction in the Open Batch. You need to know the existing status of the transactions in order to update it.

Attention: Transactions' statuses can be updated as long as the change respect the following constraints.

Changing FROMSTATUS to TOSTATUS READY PENDING DECLINED
READY NO YES NO
PENDING YES NO NO
REFERRAL YES YES NO
REVIEW YES YES YES

The following code is a simple example of an status update request via an XML POST.

<?xml version="1.0" encoding="UTF-8"?>
<TRANSACTIONUPDATE>
	<UNIQUEREF>Q8F40S2V</UNIQUEREF>
	<TERMINALID>6491002</TERMINALID>
	<OPERATOR>Test Operator</OPERATOR>
	<FROMSTATUS>PENDING</FROMSTATUS>
	<TOSTATUS>READY</TOSTATUS>
	<DATETIME>20-06-2006:12:28:02:171</DATETIME>
	<HASH>cfa094f53a508d2031c7895f9f766cbb</HASH>
</TRANSACTIONUPDATE>


For testing purposes, this piece of XML code can be posted to:

https://testpayments.worldnettps.com/merchant/xmlpayment


A response for this transaction would look like the following piece of XML code.

<?xml version="1.0" encoding="UTF-8"?>
<TRANSACTIONUPDATERESPONSE>
	<RESPONSECODE>A</RESPONSECODE>
	<RESPONSETEXT>SUCCESS</RESPONSETEXT>
	<UNIQUEREF>JJCVGCTOV3</UNIQUEREF>
	<TERMINALID>6491002</TERMINALID>
	<DATETIME>20-06-2006:12:28:03:875</DATETIME>
	<HASH>6a06aa6f14fe539f4dedd305465811ab</HASH>
</TRANSACTIONUPDATERESPONSE>


The Worldnet payment system then handles subsequent transaction settlement and storage.



The following is a description of each field:

Filter:

Field Name Required Description
UNIQUEREF Y The UNIQUREF for the transaction being updated.
TERMINALID Y A Terminal ID provided by Worldnet. NB- Please contact Worldnet to be issued with a test terminal ID.
OPERATOR Y An identifier for who executed this update.
FROMSTATUS Y The current status of the transaction. Can be READY, PENDING, REVIEW or REFERRAL.
TOSTATUS Y The status the transaction is going to assume. Can be READY, PENDING or DECLINED. The changes that can be made are limited.
AUTHCODE N The approval code of the referral. Only required if changing a REFERRAL to PENDING or READY.
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+UNIQUEREF+OPERATOR+FROMSTATUS+TOSTATUS+APPROVALCODE+DATETIME+secret



The following fields are returned in the response:

Filter:

Field Name Description
RESPONSECODE Updated transaction response code.
RESPONSETEXT Updated transaction response text.
UNIQUEREF The UNIQUEREF for this transaction.
TERMINALID A Terminal ID provided by Worldnet. NB - Please contact Worldnet to be issued with a test terminal ID.
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+RESPONSECODE+RESPONSETEXT+UNIQUEREF+DATETIME+secret
Copyright © 2017 Worldnet Knowledge Base | Powered by DokuWiki
developer/integrator_guide/5._xml_integration/5.2._transaction_status_updates.txt · Last modified: 2017/10/26 13:21 by tleite