Pos Listing Service

Android Pos Listing Service

The Android Pos Listing method is used to list the information of the POS that can pay.

Method	API URL	Parameter
POST	https://posservice.esnekpos.com/api/services/ListPhysicalPos	JSON File

Android Pos Listing Service Request Model;

The parameters to be sent to the service are as follows;

Common Checkout Page Service Request Message Parameters

Parameters	Type	Compulsory	Description
MERCHANT	string	Yes	It is a unique credential created specifically for the merchant.
MERCHANT_KEY	string	Yes	It is the key information created specifically for the merchant.

Here is a sample JSON file to send to the service;

  {
    "MERCHANT": " TEST1234",
    "MERCHANT_KEY": " 4oK26hK8MOXrIV1bzTRVPA=="
  }

Android Pos Listing Service Answer Model

The parameters of the reply message sent from the service after the transaction are as follows;

Secure Payment Page Service Response Message Parameters

Parameters	Type	Compulsory	Description
RETURN_CODE	string	Yes	Inquiry operation result status code information.
RETURN_MESSAGE	string	Yes	Status message information as a result of the query process.
POST_LIST	Array	Yes	List of active android pos.

POST LIST

Parameters	Type	Compulsory	Description
ID	Int	Evet	Android pos number.
TITLE	String	Evet	Android pos title information
CONNECTED	Boolean	Evet	Android pos connection status.

                                            
                                    
 {
       
    "RETURN_CODE": "0",
    "RETURN_MESSAGE": null,
    "POS_LIST": [
        {
            "ID": 3,
            "TITLE": "testtitle1",
            "CONNECTED": false
        },
        {
            "ID": 5,
            "TITLE": "testtitle2",
            "CONNECTED": false
        }
    ]
 
 }
                                            
                                        

Returning the RETURN_CODE field as 0 indicates that the query was successful.

Android Pos Listing Service Status Codes and Explanations;

The details of the RETURN_CODE statements returned from the Android Pos Listing Service are as follows;

STATUS_ID	STATUS_NAME	DESCRIPTION
0	SUCCESS	Success transaction.
100	ERROR	Incorrect transaction
102	AUTHENTICATION_ERROR	authentication error
999	UNKNOWN_ERROR	An unexpected error has occurred.