Knowledge Base

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

5.1.3 Pre-Auth Completion Request

Example of a Pre-Auth completion request:

<?xml version="1.0" encoding="UTF-8"?>
<PREAUTHCOMPLETION>
	<UNIQUEREF>JJCVGCTOV3</UNIQUEREF>
	<TERMINALID>6491002</TERMINALID>
	<AMOUNT>12.31</AMOUNT>
	<DATETIME>19-12-2008:14:47:51:307</DATETIME>
	<CVV>785</CVV>
	<HASH>ff2e84856d7debbf07d3dfeffad5898c</HASH>
</PREAUTHCOMPLETION>


For testing, this XML isn posted to:

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

A response for this transaction would be:

<?xml version="1.0" encoding="UTF-8"?>
<PREAUTHCOMPLETIONRESPONSE>
	<RESPONSECODE>A</RESPONSECODE>
	<RESPONSETEXT>APPROVAL</RESPONSETEXT>
	<APPROVALCODE>515658</APPROVALCODE>
	<DATETIME>2008-12-18T14:47:51</DATETIME>
	<HASH>93527dbb00534a4b33546161aefe5222</HASH>
</PREAUTHCOMPLETIONRESPONSE>


Pre-Auth Completion request fields description:

Filter:

Field Name Required Description
UNIQUEREF Y A unique identifier for the order created by the merchant. (Max 12 characters). The UNIQUEREF for the original authorisation.
TERMINALID Y A Terminal ID provided by Worldnet.
AMOUNT Y The amount of the transaction as a 2 digit decimal or an integer value for JPY amounts.
FOREIGNCURRENCY INFORMATION N Tag contains Dynamic Currency Conversion information. It is required when completing out of the 15% margin eDCC transaction. See XML Payments with eDCC.
DESCRIPTION N An optional description, overrides original pre-auth description if available.
DATETIME Y Format DD-MM-YYYY:HH:SS:SSS.
CVV N The security code entered by the card holder. It should be available when CVV is enabvled for the terminal and completing out of the 15% margin transaction.
HASH Y An MD5 HASH (See note 1 below).


The following fields are returned in the response:
Filter:

Field Name Description
RESPONSECODE A or D or R (Approved or Declined or Referral).
RESPONSETEXT The text of the authorization
APPROVALCODE Six digit AuthCode.
DATETIME The time of the transaction created by the bank. Format: YYYY-MM-DDTHH:MM:SS. Note that this is intentionally in a different format to the request timestamp to highlight the fact that it is a different time.
AVSRESPONSE The result of the AVS check. See Appendix A for more information.
CVVRESPONSE The result of the CVV check. See Appendix A for more information.
PROCESSINGTERMINAL If the transaction was performed on a “routing terminal” then this is populated with processing terminal ID that the system selected to process the transaction.
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

For multi-currency Terminal IDs (see section 3.3 above) this should be:

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


Errors handling

If there is an error processing the transaction, the error string is returned in an XML message with the simple:

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