> For the complete documentation index, see [llms.txt](https://developer.esnekpos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.esnekpos.com/hoppa-gelistirici-ortami/android-pos-web-api/pos-listeleme-servisi.md).

# Pos Listeleme Servisi

**Android Pos Listeleme Servisi**

Android Pos Listeleme metodu ödeme yapabilecek posların bilgilerinin listelenmesi için kullanılır.

<table><thead><tr><th>Metod</th><th width="511.3333333333333">API URL</th><th>Parametreler</th></tr></thead><tbody><tr><td>POST</td><td>https://base-url/api/services/ListPhysicalPos</td><td>JSON File</td></tr></tbody></table>

**Android Pos Listeleme Servisi İstek Modeli;**

Servise gönderilmesi gereken parametreler şu şekildedir;

Ortak Ödeme Sayfası Servisi İstek Mesajı Parametreleri

<table><thead><tr><th width="178">Parametre</th><th width="90">Tip</th><th width="80">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>MERCHANT</td><td>string</td><td>Evet</td><td>Üye işyerine özel oluşturulan eşsiz kimlik bilgisidir.</td></tr><tr><td>MERCHANT_KEY</td><td>string</td><td>Evet</td><td>Üye işyerine özel oluşturulan anahtar bilgisidir</td></tr></tbody></table>

Servise gönderilecek örnek bir JSON dosyası şu şekildedir;

&#x20;                                 &#x20;

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

**ndroid Pos Listeleme Servisi Cevap Modeli**

Servisten işlem sonrasında gönderilen cevap mesajına ait parametreler şu şekildedir;

Güvenli Ödeme Sayfası Servisi Cevap Mesajı Parametreleri

<table><thead><tr><th width="209">Parametre</th><th width="88">Tip</th><th width="77">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>RETURN_CODE</td><td>string</td><td>Evet</td><td>Sorgulama işlemi sonucu durumu kod bilgisi.</td></tr><tr><td>RETURN_MESSAGE</td><td>string</td><td>Evet</td><td>Sorgulama işlemi sonucu durum mesajı bilgisi.</td></tr><tr><td>POST_LIST</td><td>Array</td><td>Evet</td><td>Aktif olan android posların listesi.</td></tr></tbody></table>

<br>

**POST LIST**

<table><thead><tr><th width="157">Parametre</th><th width="96">Tip</th><th width="106">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>ID</td><td>Int</td><td>Evet</td><td>Android pos numarası.</td></tr><tr><td>TITLE</td><td>String</td><td>Evet</td><td>Android pos başlık bilgisi.</td></tr><tr><td>CONNECTED</td><td>Boolean</td><td>Evet</td><td>Android pos bağlantı durumu.</td></tr></tbody></table>

* [JSON](https://developer.esnekpos.com/Home/androidposlistelemeservisi#m_tabs_1_1)

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

`RETURN_CODE` alanı 0 olarak dönmesi, sorgulama işleminin başarılı olarak gerçekleştiğini belirtmektedir.

**Android Pos Listeleme Servisi Durum Kodları ve Açıklamaları;**

Android Pos Listeleme Servisinden dönen `RETURN_CODE` açıklamalarının detayları şu şekildedir;

| STATUS\_ID | STATUS\_NAME          | Açıklama                          |
| ---------- | --------------------- | --------------------------------- |
| 0          | SUCCESS               | Başarılı işlemdir.                |
| 100        | ERROR                 | Hatalı İşlemdir.                  |
| 102        | AUTHENTICATION\_ERROR | Kimlik doğrulama hatası.          |
| 999        | UNKNOWN\_ERROR        | Beklenmeyen bir hata gerçekleşti. |