RequestStatus Property

Used with enhanced BatchInquiry s to retrieve the next set of transaction data.

Syntax

 ptechhostsettle.getRequestStatus([callback])
 ptechhostsettle.setRequestStatus( requestStatus, [callback])

Possible Values

  0 (rsInitialRequest), 
  1 (rsSubsequentRequest)

Default Value

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 the getRequestStatus([callback]) method is defined as:

function(err, data){ }

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

'data' is the value returned by the method.

The callback for the setRequestStatus([callback]) 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 property is used when submitting a BatchInquiry transaction with enhanced reporting. Additional transaction data will be returned for any BatchInquiry submitted with an InquiryType other than iSimpleInquiry.

If the Paymentech server cannot return all of the data requested in a single response, the MoreData property will be true. You should then set the RequestStatus to rsSubsequentRequest and re-submit the BatchInquiry. Continue this until MoreData is False. If at any time you wish to start over at the beginning, set RequestStatus to rsInitialRequest and call BatchInquiry again.

Data Type

Integer