AdjustTransaction Method

Sends Level 3 transaction requests.

Syntax

tsyshclevel3.adjustTransaction([callback])

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for this method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

This method allows you to add Level 3 data to a previously authorized transaction. If the adjustment request was successful, the ResponseCode property will contain "200". Response will contain additional details about the authorization request.

Minimum required properties:

• GenKey
• MerchantId
• RoutingId
• OriginalAmount
• RetrievalNumber

If you wish to also add LineItems data, the following properties are required to do so:

• LineItemQuantity
• LineItemTotal

When adding LineItems data, the class will send a separate adjustment request for each line item. If a line item request fails to adjust successfully, the class fails with an error. The error message will contain the index of the failed line item. ResponseCode and ResponseText will contain additional details about why the line item failed.

If a timeout occurs during the adjustment request, you will want to use the TSYSHCTransactionDetails class to issue a GetDetails request. If the request was received by the TSYS server, the GetDetails response will contain the adjusted values and no other steps are necessary. If the request was not received by the TSYS server, the GetDetails response will show that the adjusted values were not updated. Therefore the adjustment request should be resent.