5.2. Transaction Status Updates

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 10:08 by elizas