# İşlem Listesi

Paynet ’ten yapılan işlemlerin listesini almak için kullanılır.

{% hint style="warning" %}
İşlem listesi 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/transaction/list>
{% endhint %}

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

| Parametre İsmi      | Tip    | Zorunlu | Açıklama                                                                                                                                                                           |
| ------------------- | ------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **agent\_id**       | string | Hayır   | Paynet bayi kodu                                                                                                                                                                   |
| **bank\_id**        | char   | Hayır   | Banka kodu                                                                                                                                                                         |
| **user\_id**        | string | Hayır   | İşlemi yapan kullanıcı bilgisi                                                                                                                                                     |
| **datab**           | date   | Evet    | Başlangıç Tarihi                                                                                                                                                                   |
| **datbi**           | date   | Evet    | Bitiş Tarihi                                                                                                                                                                       |
| **show\_unsucceed** | bool   | Hayır   | Bu parametre “true” ise başarılı işlemler ile birlikte başarısız işlemleride getirir. Default değeri “false”                                                                       |
| **untransferred**   | bool   | Hayır   | mark\_transferred servisi ile transfer edilmiş olarak işaretlediğiniz işlemleri hariç tutmak için bu parametreyi kullanabilirsiniz.                                                |
| **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. |
| {% endtab %}        |        |         |                                                                                                                                                                                    |

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

| Parametre İsmi                       | Tip      | Açıklama                                                                                                                                                                    |
| ------------------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **companyCode**                      | string   | Ana firma kodu                                                                                                                                                              |
| **companyName**                      | string   | Ana firma adı                                                                                                                                                               |
| **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.                                                                                          |
| **Data\[]**                          |          |                                                                                                                                                                             |
| =>xact\_date                         | datetime | İşlem tarihi dd.mm.yyyy formatında                                                                                                                                          |
| =>xact\_time                         | datetime | İşlemin zamani dd.mm.yyyy HH:SS:ss                                                                                                                                          |
| => merchant\_id                      | string   | İşlemin yapıldığı üye iş yeri numarası                                                                                                                                      |
| =>companyCode                        | string   | Ana firma kodu                                                                                                                                                              |
| =>companyName                        | string   | Ana firma adı                                                                                                                                                               |
| => agent\_id                         | string   | Paynet Bayi kodu                                                                                                                                                            |
| => user\_id                          | string   | Paynet Kullanici kodu                                                                                                                                                       |
| =>xact\_note                         | string   | İşlem yapılırken gönderilen description                                                                                                                                     |
| => xact\_agent\_reference            | string   | İşlem yapılırken girilen referans numarası                                                                                                                                  |
| => agent\_referans\_no               | string   | Ana Firma Bayi Kodu. Bayinin ana firmadaki kodu                                                                                                                             |
| => agent\_name                       | string   | Bayi Adı                                                                                                                                                                    |
| =>id                                 | string   | İşlem id'si. xact\_id'nin şifrelenmiş halidir                                                                                                                               |
| =>xact\_id                           | string   | Paynet işlem numarası                                                                                                                                                       |
| => is\_tds                           | bool     | İşlemin 3D secure ile yapılıp / yapılmadığı                                                                                                                                 |
| =>bank\_id                           | char     | Banka kodu                                                                                                                                                                  |
| =>bank\_name                         | string   | Banka adı                                                                                                                                                                   |
| => card\_no                          | string   | Kart numarası                                                                                                                                                               |
| => card\_holder                      | string   | Kart sahibinin adı                                                                                                                                                          |
| => card\_type                        | char     | Kart tipi                                                                                                                                                                   |
| =>card\_type\_name                   | string   | Kart tipi açıklaması                                                                                                                                                        |
| => authorization\_code               | string   | Banka onay kodu                                                                                                                                                             |
| => reference\_code                   | string   | Banka referans kodu                                                                                                                                                         |
| => order\_id                         | string   | Banka sipariş numarası                                                                                                                                                      |
| => postype\_desc                     | string   | Pos tipi açıklaması                                                                                                                                                         |
| => xact\_type                        | char     | İşlem tipi. [Bakınız](https://doc.paynet.com.tr/genel-bilgiler/veri-tipleri/islem-tipi)                                                                                     |
| => xacttype\_desc                    | string   | İşlem açıklaması                                                                                                                                                            |
| => fiscal\_period\_id                | char     | İşlemin yapıldığı mali dönem yyyyMM şeklinde.                                                                                                                               |
| => sector\_id                        | char     | Sektör id’si                                                                                                                                                                |
| => sectorid\_desc                    | string   | Sektör açıklaması                                                                                                                                                           |
| => channel\_name                     | string   | İşlemin yapıldığı kanalın açıklaması                                                                                                                                        |
| => ipaddress                         | string   | İşlemin yapıldığı ip adresi                                                                                                                                                 |
| => client\_id                        | guid     | İşlemin yapıldığı client                                                                                                                                                    |
| => xact\_transaction\_id             | guid     | Paynet takip kodu                                                                                                                                                           |
| => terminal\_id                      | string   | İşlemin yapıldığı terminal numarası                                                                                                                                         |
| => is\_succeed                       | bool     | İşlemin başarılı ya da başarısız olduğu. İşlem başarılı ile kredi kartından ilgili tutar çekilmiş demektir. Başarısız ise bir nedenden dolayı karttan çekim yapılamamıştır. |
| => reversed                          | bool     | İşlemin iptal edilip edilmediği                                                                                                                                             |
| => is\_reconcile                     | bool     | Banka mutabakat yapılıp yapılmadığı anlamına gelir                                                                                                                          |
| => is\_payup                         | bool     | Ödemesinin firmaya yapılıp yapılmadığı                                                                                                                                      |
| => is\_onchargeback                  | bool     | İşlemde chargeback talebi yapılıp yapılmadığı                                                                                                                               |
| => is\_transferred                   | bool     | İşlemin cari hesabınıza aktarılıp aktarılmadığı.                                                                                                                            |
| => reversed\_xact\_id                | string   | İptal kayıtlarında hangi kaydın iptali olduğunu belirler                                                                                                                    |
| => reversed\_id                      | string   | İptal kayıtlarında hangi kaydın iptali olduğunu belirler                                                                                                                    |
| => channel\_id                       | int      | İşlemin yapıldığı kanalın id’si                                                                                                                                             |
| => pos\_type                         | char     | Pos tipi                                                                                                                                                                    |
| => instalment                        | int      | Taksit sayısı                                                                                                                                                               |
| => amount                            | decimal  | Kredi kartından çekilen tutar                                                                                                                                               |
| => net\_amount                       | decimal  | Hizmet bedeli hariç tutar                                                                                                                                                   |
| => comission                         | decimal  | Hizmet bedeli tutarı                                                                                                                                                        |
| => comission\_tax                    | decimal  | Hizmet bedeli vergisi                                                                                                                                                       |
| => currency                          | char     | Para birimi                                                                                                                                                                 |
| =>currency\_type                     | string   | Para birimi tipi                                                                                                                                                            |
| => ratio                             | float    | Hizmet bedeli oranı                                                                                                                                                         |
| => company\_pay\_ratio               | float    | Ana firmaya ödeme dağılımı oranı %50 için 50 gelir.                                                                                                                         |
| => company\_cost\_ratio              | float    | Ana Firma Hizmet Bedeli %                                                                                                                                                   |
| => ana\_firma\_komisyonu             | decimal  | Ana Firma Hizmet Bedeli TL (KDV Hariç)                                                                                                                                      |
| => ana\_firma\_komisyonu\_kdv\_dahil | decimal  | Ana Firma Komisyonu TL (KDV Dahil)                                                                                                                                          |
| => ana\_firma\_odenecek\_net\_tutar  | decimal  | Ana Firma Ödenecek Net Tutar                                                                                                                                                |
| => cp\_mfi\_vdate\_day               | int      | Ana Firma Ödeme Blokajı (Gün)                                                                                                                                               |
| => cp\_mfi\_vdate                    | date     | Ana Firmaya Ödeme Vadesi                                                                                                                                                    |
| => ana\_firma\_brut\_alacak          | decimal  | Ana Firma Brüt Alacak                                                                                                                                                       |
| => bayi\_brut\_alacak                | decimal  | Bayi Brüt Alacak                                                                                                                                                            |
| => bayi\_komisyonu                   | decimal  | Bayi Hizmet Bedeli TL (KDV Hariç)                                                                                                                                           |
| => bayi\_komisyonu\_kdv\_dahil       | decimal  | Bayi Hizmet Bedeli TL (KDV Dahil)                                                                                                                                           |
| => bayiye\_odenecek\_net\_tutar      | decimal  | Bayiye Ödenecek Net Tutar                                                                                                                                                   |
| => ap\_mfi\_vdate\_day               | int      | Bayi Ödeme Blokajı (Gün)                                                                                                                                                    |
| => ap\_mfi\_vdate                    | int      | Bayiye Ödeme Vadesi                                                                                                                                                         |
| =>referans\_1                        | string   | İşlem referans bilgisi                                                                                                                                                      |
| =>plus\_installment                  | int      | Artı taksit sayısı.                                                                                                                                                         |
| => postpone\_installment             | int      | Taksit erteleme. Ertelenen taksit sayısı                                                                                                                                    |
| => add\_commission\_to\_amount       | bool     | True/false. İşlemde hizmet bedelinin eklenip eklenmediği bilgisi.                                                                                                           |
| {% endtab %}                         |          |                                                                                                                                                                             |

{% tab title="Request" %}

```javascript
{  
   "datab":"2015-04-04",
   "datbi":"2015-05-05"
}
```

{% endtab %}

{% tab title="Response" %}

```javascript
{
    "companyCode": "1001",
    "companyName": "PAYNET ÖDEME HİZMETLERİ A.Ş.",
    "total": 616,
    "total_count": 11,
    "total_amount": "830.114,84",
    "limit": 10,
    "ending_before": 0,
    "starting_after": 0,
    "object_name": "transaction_list",
    "has_more": true,
    "Data": [
        {
            "merchant_id": "100100000",
            "companyCode": "1001",
            "companyName": "PAYNET ÖDEME HİZMETLERİ A.Ş.",
            "agent_id": "10",
            "agent_referans_no": "101023",
            "agent_name": "TEST1 BAYI",
            "id": 2527054,
            "xact_id": "xk_EAAAABjNNQXkp5xN4RyKCdjOn*WlCyAZUfIh7tvswL7Sxnol",
            "xact_date": "27.02.2020",
            "is_tds": false,
            "bank_id": "AXSS",
            "bank_name": "Akbank",
            "card_no": "435508******4358",
            "card_holder": "SCSDF",
            "card_type": "bc",
            "card_type_name": "Ticari Kart",
            "authorization_code": "aut-4923",
            "reference_code": "ref-4923",
            "order_id": "order-4923",
            "postype_desc": "Paynet POS",
            "xact_type": "S",
            "xacttype_desc": "Satış",
            "fiscal_period_id": "202002",
            "sector_id": "0000",
            "sectorid_desc": "Paynet PF Grubu",
            "channel_name": "Paynet Api",
            "ipaddress": "91.93.43.114",
            "client_id": "                                    ",
            "xact_transaction_id": "6FA9F0CE-9D3D-4625-B985-DE390F72E78F",
            "terminal_id": "",
            "is_succeed": true,
            "reversed": false,
            "is_reconcile": false,
            "is_payup": false,
            "is_onchargeback": false,
            "is_transferred": true,
            "reversed_xact_id": "",
            "reversed_id": 0,
            "channel_id": 2,
            "pos_type": 5,
            "instalment": 0,
            "amount": "20,00",
            "net_amount": "19,30",
            "comission": "0,70",
            "comission_tax": "0,00",
            "currency": "TRY",
            "currency_type": "TRY",
            "ratio": "3,50",
            "user_id": "PaynetApi",
            "xact_time": "27.02.2020 11:00:19",
            "xact_note": "test 2",
            "xact_agent_reference": "test",
            "company_pay_ratio": "35,00",
            "company_cost_ratio": "",
            "ana_firma_brut_alacak": "7,00",
            "ana_firma_komisyonu": "",
            "ana_firma_komisyonu_kdv_dahil": "",
            "ana_firma_odenecek_net_tutar": "",
            "bayi_brut_alacak": "13,00",
            "bayi_komisyonu": "0,70",
            "bayi_komisyonu_kdv_dahil": "0,70",
            "bayiye_odenecek_net_tutar": "12,30",
            "cp_mfi_vdate": "",
            "cp_mfi_vdate_day": 0,
            "ap_mfi_vdate": "06.03.2020",
            "ap_mfi_vdate_day": 7,
            "referans_1": "",
            "plus_installment": 2,
            "postpone_installment": 1,
            "add_commission_to_amount": false
        
        }
    ]
}
```

{% endtab %}

{% tab title="Service Url" %}

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