Test Connection

The main purpose of this function is to:

  • test the connection between the ECR and the Terminal;

  • get the Terminal Serial Number;

  • get the total pending transactions (offline).

No specific field is required to call this function.

The Test connection Message returns a status of the connection:

  • 0 => OK

  • not 0 => error

This function does not inform if the terminal is correctly connected to server;

Perform Test Connection

Request MessageHeader

Elements

Required

Description

ProtocolVersion

Yes

3.1

MessageClass

Yes

Service

MessageCategory

Yes

Diagnosis

MessageType

Yes

Request

ServiceID

Yes

Your unique ID for this request, consisting of 1-10 alphanumeric characters. Must be unique within the last 48 hours for the terminal (POIID) being used.

SaleID

Yes

identifier of the ECR initiating the request (e.g., ECR001")

POIID

Yes

identifier of the Terminal receiving the request (e.g., 456)

Request body

Elements

Attributes

Required

Description

DiagnosisRequest

POIID

MessageCategory

Yes

identifier of the Terminal receiving the request (e.g., 456)

Example of SaleToPOIRequest

<?xml version="3.1" encoding="UTF-8"?>
<SaleToPOIRequest xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
	<MessageHeader MessageClass="Service" MessageCategory="Diagnosis" MessageType="Request" ServiceID="3914" SaleID="ECR001" POIID="456"></MessageHeader>
	<DiagnosisRequest POIID="456"></DiagnosisRequest>
</SaleToPOIRequest>

Receive Test Connection response

<SaleToPOIResponse>
   <DiagnosisResponse>
      <MarketpayPaymentExtensions StoreCode="a0WKG0000027TX42AM"/>
      <PendingTransactionsCount>0</PendingTransactionsCount>
      <POISerialNumber>1760317010</POISerialNumber>
      <POIStatus GlobalStatus="OK"/>
      <Response Result="Success"/>
   </DiagnosisResponse>
   <MessageHeader MessageCategory="Diagnosis" MessageClass="Service" MessageType="Response" POIID="456" ProtocolVersion="3.1" SaleID="ECR001" ServiceID="3914"/>
</SaleToPOIResponse>