Knowledge Base

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

5.1.4 Standard Refunds

Standard refunds can 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.
ADDITIONAL_FIELD This field is used to send back data of interest of the merchant received by the gateway during the transaction. Currently two fields are possible to be returned (see note 3): ACQUIRER_RESPONSE_CODE and ACQUIRER_RESPONSE_TEXT, containing the original code and text from the acquirer's response to the authorization transaction.


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)

3. This data is going to be retrieved when the Terminal executing the transaction is configured to do so. This configuration can be activated on the Terminal settings, enabling the “Integration” option “Enable original response in XML”.

Copyright © 2018 Worldnet Knowledge Base | Powered by DokuWiki
developer/integrator_guide/5._xml_integration/5.1._request_types/5.1.4._standard_refund.txt · Last modified: 2017/12/08 11:17 by tleite