5.1.4. Standard Refund

Knowledge Base

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

5.1.4 Standard Refunds

Standard refunds can be be performed on any authorised transactions in the Worldnet system, either in the Open Batch or Closed Batch. By default you can refund any amount up to 100% of the original transaction value. If multiple partial refunds are performed then the sum total of them cannot exceed 100% either. This is to prevent fraud. This 100% value is configurable at a Terminal level and if you wish to alter it please contact support@worldnettps.com with a reason why you need it altered.

The following is a simple example of a refund via an XML POST:

<?xml version="1.0" encoding="UTF-8"?>
<REFUND>
	<UNIQUEREF>Q8F40S2V</UNIQUEREF>
	<TERMINALID>6491002</TERMINALID>
	<AMOUNT>10.00</AMOUNT>
	<DATETIME>20-06-2006:12:28:02:171</DATETIME>
	<HASH>cfa094f53a508d2031c7895f9f766cbb</HASH>
	<OPERATOR>Test Operator</OPERATOR>
	<REASON>Faulty Goods</REASON>
</REFUND>


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"?>
<REFUNDRESPONSE>
	<RESPONSECODE>A</RESPONSECODE>
	<RESPONSETEXT>SUCCESS</RESPONSETEXT>
	<UNIQUEREF>JJCVGCTOV3</UNIQUEREF>
	<TERMINALID>6491002</TERMINALID>
	<AMOUNT>10.00</AMOUNT>
	<DATETIME>20-06-2006:12:28:03:875</DATETIME>
	<HASH>6a06aa6f14fe539f4dedd305465811ab</HASH>
</REFUNDRESPONSE>


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 UNIQUEREF for the original authorisation.
TERMINALID Y A Terminal ID provided by Worldnet. NB - Please contact Worldnet to be issued with a test terminal ID.
AMOUNT Y The amount of the transaction as a 2 digit decimal or an integer value for JPY amounts.
DATETIME Y Format: DD-MM-YYYY:HH:MM:SS:SSS.
HASH Y An MD5 HASH. See note 1 below.
OPERATOR Y An identifier for who executed this transaction.
REASON Y The reason for the refund.


The following fields are returned in the response:
Filter:

FIELD NAME DESCRIPTION
RESPONSECODE A or D (Approved or Declined).
RESPONSETEXT The text of the authorisation.
UNIQUEREF The UNIQUEREF for this refund.
TERMINALID A Terminal ID provided by %CompnayName. NB - Please contact Worldnet to be issued with a test terminal ID.
AMOUNT The amount of the transaction as a 2 digit decimal or an integer value for JPY amounts.
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+AMOUNT+DATETIME+secret

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

TERMINALID+UNIQUEREF+AMOUNT+DATETIME+RESPONSECODE+RESPONSETEXT+secret

(n.b. the response UNIQUEREF is to be used here)

Copyright © 2017 Worldnet Knowledge Base | Powered by DokuWiki
developer/integrator_guide/5._xml_integration/5.1._request_types/5.1.4._standard_refund.txt · Last modified: 2016/07/26 12:04 (external edit)