Chapter 8 - Re-Initiation | Nuvei Technologies

Re-Initiation process involves re-processing of initially approved transactions that have been identifed as NSF.

There are 2 ways to process such transactions:

Automatic – A job is run at a set time which will process Re-Initiations automatically.
Manual – Re-Initiation can be processed manually via Selfcare.

Example of a Re-Initiation request:

XML

<?xml verson="1.0" encodng="UTF-8"?>
	<ACHJHREINITIATION>
	<UNIQUEREF>LS2O5CO1XB</UNIQUEREF>
	<TERMINALID>2366006</TERMINALID>
	<DATETIME>24-01-2017:15:43:04:334</DATETIME>
	<HASH>1ecafefa8fead5c9db18daf8f6e75ba8</HASH>
</ACHJHREINITIATION>

Fields description:

Field Name	Required	Description
UNIQUEREF	Y	Generated reference that should be stored for tracking and remote XML refunding.
TERMINALID	Y	A TerminalID provided by Nuvei. NB – Please contact Nuvei to be issued with a test terminal ID.
DATETIME	Y	Format: DD-MM-YYYY:HH:MM:SS:SSS
HASH	Y	An SHA-512 HASH. See Note 1 below.

Notes:
1. The SHA-512 HASH is generated using the following as an input string:

TERMINALID:UNIQUEREF:DATETIME:secret

Example of a successful Re-Initiation response:

XML

<ACHREINITIATIONRESPONSE>
	<RESPONSECODE>A</RESPONSECODE>
	<RESPONSETEXT>SUCCESS</RESPONSETEXT>
	<UNIQUEREF>LS2O5CO1XB</UNIQUEREF>
	<DATETIME>24-01-2017:14:43:05:940</DATETIME>
	<HASH>...</HASH>
</ACHREINITIATIONRESPONSE>

The following felds are returned in the response:

Field Name	Description
UNIQUEREF	Generated reference that should be stored for tracking and remote XML refunding.
RESPONSECODE	A or D or R(Approved or Declined or Referral).
RESPONSETEXT	The text of the authorization.
DATETIME	The time of the transaction created by the bank. Format: DD-MMYYYY: HH:MM:SS:SSS.
HASH	An SHA-512 HASH. See Note 1 below.

Notes:
1. The SHA-512 HASH is generated using the following as an input string:

TERMINALID:RESPONSECODE:RESPONSETEXT:UNIQUEREF:DATETIME:secret

Developers

Chapter 8 - Re-Initiation

Need Help?