# PayLink Listeleme

Oluşturduğunuz PayLink'leri listelemek ve durumlarını kontrol etmek için bu servisi kullanabilirsiniz.

{% hint style="warning" %}
Ödeme servisini kullanabilmeniz için secret\_key ile basic authentication yapmalısınız. [Bakınız](https://doc.paynet.com.tr/authentication#secret-key)
{% endhint %}

{% hint style="success" %}
<https://api.paynet.com.tr/v1/mailorder/list>
{% endhint %}

{% tabs %}
{% tab title="İstek Parametreleri" %}

| Parametre İsmi      | Tip    | Zorunlu | Açıklama                                                                                                                                                                          |
| ------------------- | ------ | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **agent\_id**       | string | Hayır   | Paynet bayi kodu                                                                                                                                                                  |
| **datab**           | Date   | Evet    | Başlangıç Tarihi                                                                                                                                                                  |
| **datbi**           | Date   | Evet    | Bitiş Tarihi                                                                                                                                                                      |
| **limit**           | int    | Hayır   | Döndürülecek veri sayısı. Default 10 kayıt döner.                                                                                                                                 |
| **ending\_before**  | int    | Hayır   | Belirtilen index’den önceki limit sayısı kadar kayıt getirir. Eğer ending\_before 90 gönderildi, limit olarak 15 gönderildi. 75. İle 90. Kayıtları arasındaki kayıtları gönderir. |
| **starting\_after** | int    | Hayır   | Belirtilen index’den sonraki limit sayısı kadar kayıt getirir. Eğer starting after 15 gönderildi, limit olarak 15 gönderildi. 15. İle 30. Kayıtları arasındaki kayıtları gönderir |
| **user\_id**        | string | Hayır   | İşlemi yapan kullanıcı bilgisi                                                                                                                                                    |
| {% endtab %}        |        |         |                                                                                                                                                                                   |

{% tab title="Dönüş Parametreleri" %}

| Parametre İsmi             | Tip         | Açıklama                                                                                                                                                                                                        |
| -------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Data \[]**               |             |                                                                                                                                                                                                                 |
| =>company\_code            | string      | Ana firma kodu                                                                                                                                                                                                  |
| =>agent\_id                | string      | Bayi kodu                                                                                                                                                                                                       |
| =>email                    | string      | Ödeme emrinin gönderildiği e-mail adresi                                                                                                                                                                        |
| =>user\_name               | string      | Ödeme emri oluşturan kullanıcı bilgisi                                                                                                                                                                          |
| =>name\_surname            | string      | Ödeme alınan kişinin adı soyadı                                                                                                                                                                                 |
| =>expire\_date             | double      | Ödeme URL’inin geçerlilik süresini belirlemek için kullanılır.                                                                                                                                                  |
| =>create\_date             | double      | Ödeme emrinin oluşturulduğu tarih                                                                                                                                                                               |
| =>xact\_id                 | string      | Paynet işlem numarası                                                                                                                                                                                           |
| =>bank\_id                 | char(4)     | Banka kodu                                                                                                                                                                                                      |
| =>bank\_name               | string(100) | Banka adı                                                                                                                                                                                                       |
| =>reference\_no            | string(50)  | Banka referans kodu                                                                                                                                                                                             |
| =>installment              | int         | Taksit sayısı                                                                                                                                                                                                   |
| =>amount                   | decimal     | Kredi kartından çekilen tutar                                                                                                                                                                                   |
| =>currency                 | char(3)     | Para birimi                                                                                                                                                                                                     |
| =>phone                    | string      | Ödeme emrinin SMS ile bilgilendirilmesi için SMS’in gönderileceği telefon numarası                                                                                                                              |
| =>send\_sms                | bool        | Ödeme emrinin SMS ile gönderilip gönderilmeyeceğini belirler. True ise phone parametresi zorunlu. Default false.                                                                                                |
| =>note                     | string      | Ödeme sayfasında ödeme yapacak kişiye gösterilen açıklama.                                                                                                                                                      |
| =>agent\_note              | string      | Ödeme işlemi yapıldığında raporlarda görünen açıklama bilgisi.                                                                                                                                                  |
| =>succeed\_url             | string      | İşlem başarılı ise bu parametrede gönderilen url’in sonuna işlem numarası(xact\_id) parametresini ekleyerek yönlendirme yapılır. Boş olarak gönderilirse Paynet’in default ödeme sonuç sayfası gösterilir.      |
| =>error\_url               | string      | İşlem başarısız ise bu parametrede gönderilen url’in sonuna işlem numarası(xact\_id) parametresini ekleyerek yönlendirme yapılır. Boş olarak gönderilirse Paynet’in default ödeme başarısız sayfası gösterilir. |
| =>confirmation\_url        | string      | Eğer işlem başarılı ise burada belirtilen url’e aşağıda confirmation\_url adresine post edilen parametreler’de belirtiğimiz parametreler json formatında post edilir.                                           |
| =>status                   | char(1)     | 0:ODEME\_BEKLENIYOR 1:ODEME\_ALINDI 2:SURE\_ASIMI 3:PASIF\_EDILDI                                                                                                                                               |
| =>send\_confirmation\_mail | bool        | Ana firmanın Paynet’te tanımlı mail adresine ödeme başarılı ise mail gönderir.                                                                                                                                  |
| =>send\_mail               | bool        | Ödeme emrinin mail ile gönderilip gönderilmeyeceğini belirler. True ile email parametresi zorunlu.                                                                                                              |
| =>multi\_payment           | decimal     | Ödemeyi birden fazla kart ile yapmasına olanak tanıyor.                                                                                                                                                         |
| **total**                  | int         | Toplam satır sayısı                                                                                                                                                                                             |
| **total\_count**           | int         | Toplam gösterilen satır sayısı                                                                                                                                                                                  |
| **total\_amount**          | int         | Toplam işlem tutar                                                                                                                                                                                              |
| **limit**                  | int         | Gönderilen limit bilgisi                                                                                                                                                                                        |
| **ending\_before**         | int         | Gönderilen ending\_before bilgisi                                                                                                                                                                               |
| **starting\_after**        | int         | Gönderilen starting\_after bilgisi                                                                                                                                                                              |
| **object\_name**           | string      | transaction\_list                                                                                                                                                                                               |
| **has\_more**              | bool        | True ise Belirtilen kriterlerde gönderilen satırlardan daha olduğu anlamına gelir.                                                                                                                              |
| {% endtab %}               |             |                                                                                                                                                                                                                 |

{% tab title="Request" %}

```javascript
{  
   "agent_id":"20008",
   "datab":"2015-04-04",
   "datbi":"2016-05-05",
   "ending_before":0,
   "starting_after":0
}
```

{% endtab %}

{% tab title="Response" %}

```javascript
{  
   "total":306,
   "total_count":10,
   "total_amount":2.441,00",
   "limit":10,
   "ending_before":0,
   "starting_after":0,
   "has_more":true,
   "Data":[  
      {  
         "company_code":"10031",
         "agent_id":"20008",
         "xact_id":"işlem no",
         "referenceNo":"",
         "email":"hakan.kocaturk@arena.com.tr",
         "user_name":"",
         "amount":200.0000,
         "currency":"TL",
         "installment":3,
         "phone":"",
         "bank_id":"AXSS",
         "expire_date":"2015-06-17T01:52:00",
         "create_date":"2015-06-16T13:53:18.933",
         "note":null,
         "agent_note":"",
         "succeed_url":"",
         "error_url":null,
         "confirmation_url":"",
         "bank_name":"Axess",
         "status":2,
         "sendConfirmation_mail":false,
         "send_sms":false,
         "send_mail":false,
         "multi_payment":false
      },
        ...
   ],
   "object_name":"mailorderlist",
   "code":0,
   "message":"Başarılı İşlem"
}
                       
```

{% endtab %}

{% tab title="Service Url" %}

| Sistem           | URL                                               |
| ---------------- | ------------------------------------------------- |
| **Canlı Sistem** | <https://api.paynet.com.tr/v1/mailorder/list>     |
| **Test Sistemi** | <https://pts-api.paynet.com.tr/v1/mailorder/list> |
| {% endtab %}     |                                                   |
| {% endtabs %}    |                                                   |
