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.

The following is a simple example of an update 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, this XML is posted to:

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

A response for this transaction would be:

<?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 or REFERRAL.
TOSTATUS Y New status for the transaction. Can go from:
- REFERRAL to PENDING or READY
- PENDING to READY
- READY to PENDING
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.



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 2 below.



Notes:

1. The MD5 HASH is generated using the following as an input string:

TERMINALID+UNIQUEREF=OPERATOR+FROMSTATUS+TOSTATUS+APPROVALCODE+DATETIME+secret

2. 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: 2016/07/27 11:08 (external edit)