This message is intended to request an update of the terminal, it allows to:
drop terminal logs on our server;
retrieve latest parameters;
retrieve latest application updates requested.
Overnight, terminal turned on with an internet connection automatically calls the server;
If you are turning off your terminal or internet overnight, you should implement this update function to trigger it once a day.
The Message response returns a status of the connection:
0 => OK
not 0 => error
erform SaleToPOIRequest
Below you will find a description of the SaleToPOIRequest message, which is used to initiate a payment transaction from an Electronic Cash Register system.
Request MessageHeader
Elements | Required | Description |
---|---|---|
ProtocolVersion | 3.1 | |
MessageClass | Service | |
MessageCategory | Admin | |
MessageType | Request | |
ServiceID | 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 | identifier of the ECR initiating the request (e.g., ECR001") | |
POIID | identifier of the Terminal receiving the request (e.g., 456) |
Request body
Elements | Attributes | Required | Description |
---|---|---|---|
AdminRequest | |||
ServiceIdentification |
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="Admin" MessageType="Request" ServiceID="3916" SaleID="ECR001" POIID="456"></MessageHeader>
<AdminRequest>
<ServiceIdentification>PFJlcXVlc3Q+CiAgICA8QWN0aW9uPlVwZGF0ZTwvQWN0aW9uPgogICAgPFRpbWVvdXQ+NTAwMDwvVGltZW91dD4KPC9SZXF1ZXN0Pgo=</ServiceIdentification>
</AdminRequest>
</SaleToPOIRequest>
Receive SaleToPOIResponse
Example of SaleToPOIResponse
<SaleToPOIResponse>
<AdminResponse>
<Response Result="Success">
<AdditionalResponse>PFJlc3BvbnNlPgogICA8QWN0aW9uPlVwZGF0ZTwvQWN0aW9uPgogICA8U3VjY2Vzcz50cnVlPC9TdWNjZXNzPgo8L1Jlc3BvbnNlPg==</AdditionalResponse>
</Response>
</AdminResponse>
<MessageHeader MessageCategory="Admin" MessageClass="Service" MessageType="Response" POIID="456" ProtocolVersion="3.1" SaleID="ECR001" ServiceID="3916"/>
</SaleToPOIResponse>