Additional functionality

The functionality described here is not specifically related to transactions.

Administrative operations

API reference

ApiResult RequestAdministrativeOperation(AdminOperation operation, out AdminResponse response)

An administrative operation is one that has a very specific purpose in the terminal.

In all cases, if the request returns ApiResult.OK then the response from the terminal is found in the response parameter.

The operations currently supported are:

• HostLogin

• UpdateParameters

The AdminResponse class contains the result of the administrative operation request.

Example:

/// <summary>
/// Download any configuration updates that are available
/// </summary>
public void DoConfigUpdate()
{
    AdminResponse response;
    ApiResult result = mEpas.RequestAdministrativeOperation(AdminOperation.UpdateParameters, out response);
    LogApiResult(result, "Configuration update: " + response?.ToString());
}

SendRawXml

API reference

ApiResult SendRawXml(string xml)

EpasClient.RawMessageHandler gives the ECR the option, if required, to handle raw EPAS XML message as they are received from the terminal. This method is the counterpart to that functionality, and it provides the ECR with a way to send a raw EPAS XML message to the terminal.

This is very much for advanced usage only, since it requires a thorough knowledge of the EPAS protocol.