# İşlem Detay

Yapılan bir kredi kartı işleminin detaylı bilgisini döner. Ödeme sırasında kullandığınız referans numarası ya da paynet işlem numarası ile sorgulama yapabilirsiniz. &#x20;

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

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

| Parametre İsmi    | Tip    | Zorunlu | Açıklama                                                                                                    |
| ----------------- | ------ | ------- | ----------------------------------------------------------------------------------------------------------- |
| **id**            | string | Evet\*  | Şifrelenmemiş Paynet işlem ID'si                                                                            |
| **xact\_id**      | string | Evet\*  | Paynet işlem ID’si                                                                                          |
| **xact**          | string | Evet\*  | Şifrelenmemiş Paynet işlem ID'si                                                                            |
| **reference\_no** | string | Evet\*  | Ödeme işleminde kullandığınız referans numaranız. Her işlemde unique bir numara göndermeniz tavsiye edilir. |
| **user\_id**      | string | Hayır   | Paynet Kullanıcı kodu                                                                                       |
| {% endtab %}      |        |         |                                                                                                             |

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

| Parametre İsmi                   | Tip      | Açıklama                                                                                                                        |
| -------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Data\[]**                      |          |                                                                                                                                 |
| =>id                             | string   | İşlemin id'si                                                                                                                   |
| =>xact\_id                       | string   | İşlemin id’si                                                                                                                   |
| =>xact\_date                     | datetime | İşlemin tarihi                                                                                                                  |
| =>transaction\_type              | char     | Sales:1/ Reversal:2/ PreAuth:3 /Capture:4/ PreAuthReversal:5 /CaptureReversal:6 /Query:7/ Credit:9/ PointUse:10/ PointReturn:11 |
| =>xact\_type\_desc               | string   | İşlem tipi açıklaması                                                                                                           |
| =>channel\_id                    | string   | İşlemin yapıldığı kanal id'si                                                                                                   |
| =>pos\_type                      | char     | 5: Paynet POS / 1: Süpürmeli POS                                                                                                |
| =>pos\_type\_desc                | string   | Pos tipi açıklaması                                                                                                             |
| =>is\_tds                        | bool     | İşlem 3D’li ise true                                                                                                            |
| =>agent\_id                      | string   | İşlemi yapan bayinin Paynet cari hesap kodu                                                                                     |
| =>agent\_name                    | string   | Bayi Adı                                                                                                                        |
| =>company\_name                  | string   | Ana firma adı                                                                                                                   |
| =>company\_code                  | string   | Ana firma kodu                                                                                                                  |
| =>user\_name                     | string   | Ödeme sırasındaki kullanıcı bilgisi                                                                                             |
| =>note                           | string   | Ödeme sırasında kullandığınız açıklama (data-description)                                                                       |
| =>ratio                          | float    | Ödeme sırasında kullanılan oran                                                                                                 |
| =>ratio\_code                    | string   | Ödeme sırasında kullanılan oran kodu                                                                                            |
| =>ratio\_code\_method            | string   | Ödeme sırasında kullanılan oran kodu metodu                                                                                     |
| =>end\_user\_ratio               | string   | Son kullanıcı oranı                                                                                                             |
| =>agent\_reference               | string   | Ödeme işleminde kullandığınız referans numaranız                                                                                |
| =>bank\_id                       | char     | Bankanın Paynet sistemindeki kodu                                                                                               |
| =>bank\_name                     | string   | Banka adı                                                                                                                       |
| =>instalment                     | int      | Taksit sayısı. [Bakınız](https://doc.paynet.com.tr/genel-bilgiler/taksit-kodlari)                                               |
| =>instalment\_text               | string   | Taksit açıklaması                                                                                                               |
| =>payment\_string                | string   | Ödeme planı                                                                                                                     |
| =>short\_name                    | string   | Kısa ad                                                                                                                         |
| =>is\_from\_mail\_order          | bool     | Ödeme işlemi Paylink'den geçmişse true, geçmemişse false'tur                                                                    |
| =>mail\_order\_user\_name        | string   | Paylink'den geçen ödeme işlemindeki kullanıcı adı                                                                               |
| =>campaign\_url                  | string   | İşlem sırasında yararlanılan herhangi bir artı taksit kampanyasının url'i                                                       |
| =>campaign\_text                 | string   | Kampanya açıklaması                                                                                                             |
| =>cancel\_status                 | string   | İptal/İade durumu                                                                                                               |
| =>plus\_installment              | string   | Artı taksit sayısı                                                                                                              |
| =>card\_no                       | string   | Maskeli kart numarası                                                                                                           |
| =>card\_holder                   | string   | Kart sahibi                                                                                                                     |
| =>card\_type                     | char     | Kredi kartı. [Bakınız](https://doc.paynet.com.tr/genel-bilgiler/veri-tipleri/kart-tipi)                                         |
| =>card\_brand\_name              | string   | Kart bankası markası (VISA, MASTERCARD, AMEX)                                                                                   |
| =>amount                         | decimal  | Kredi kartından çekilen tutar                                                                                                   |
| =>netAmount                      | decimal  | Hizmet bedeli hariç tutar                                                                                                       |
| =>comission                      | decimal  | Hizmet bedeli tutarı                                                                                                            |
| =>end\_user\_comission           | string   | Son kullanıcı hizmet bedeli                                                                                                     |
| =>comission\_tax                 | decimal  | Hizmet bedeli vergisi                                                                                                           |
| =>currency                       | char     | Para birimi                                                                                                                     |
| =>authorization\_code            | string   | Banka onay kodu                                                                                                                 |
| =>reference\_code                | string   | Banka referans kodu                                                                                                             |
| =>order\_id                      | string   | Banka sipariş no                                                                                                                |
| =>is\_succeed                    | bool     | İşlemin başarılı olup olmadığını gösterir.                                                                                      |
| =>reversed                       | bool     | True/False işlem iptal edilmiş ise true döner                                                                                   |
| =>reversed\_xact\_id             | string   | İşlem tipi iptal olan işlemlerde hangi işlemin iptal olduğunu belirtir.                                                         |
| =>reversal\_available            | bool     | İade yapabilme yetkisi kontrolü                                                                                                 |
| =>reversal\_remain\_amount       | decimal  | İptal/İade edildikten sonra kalan tutar                                                                                         |
| =>xact\_transaction\_id          | guid     | Paynet işlem takip numarası                                                                                                     |
| =>email                          | string   | Ödeme ile ilgili mail bilgisi                                                                                                   |
| =>phone                          | string   | Ödeme ile ilgili telefon bilgisi                                                                                                |
| =>domain                         | string   | İşlemin yapıldığı uygulamanın domain bilgisi ( örn: [www.acme.com](http://www.acme.com))                                        |
| =>company\_amount                | decimal  | Bu işlem sonucunda Ana Firma Brüt alacak                                                                                        |
| =>company\_commission            | decimal  | Bu işlem sonucunda ana firmaya kesilecek hizmet bedeli tutarı                                                                   |
| =>company\_commission\_with\_tax | decimal  | Bu işlem sonucunda ana firmaya kesilecek KDV'li hizmet bedeli tutarı                                                            |
| =>company\_net\_amount           | decimal  | Bu işlem sonucunda ana firmaya ödenecek net tutar                                                                               |
| =>agent\_amount                  | decimal  | Bu işlem sonucunda Bayi Brüt alacağı                                                                                            |
| =>agent\_commission              | decimal  | Bu işlem sonucunda bayi hizmet bedeli                                                                                           |
| =>agent\_commission\_with\_tax   | decimal  | Bu işlem sonucunda bayi KDV'li hizmet bedeli                                                                                    |
| =>agent\_net\_amount             | decimal  | Bu işlem sonucunda bayiye ödenecek net tutar                                                                                    |
| =>company\_cost\_ratio           | float    | Ana firma hizmet bedeli değeri                                                                                                  |
| =>company\_pay\_ratio            | float    | Ana firma / Bayi Arasındaki ödeme oranı                                                                                         |
| =>company\_vdate                 | datetime | Ana firma vade tarihi                                                                                                           |
| =>agent\_vdate                   | datetime | Bayi vade tarihi                                                                                                                |
| =>ipaddress                      | string   | İşlemin yapıldığı ip adresi                                                                                                     |
| =>client\_id                     | guid     | İşlemin yapıldığı client id’si                                                                                                  |
| =>object\_name                   | string   | transaction                                                                                                                     |
| =>code                           | string   | Sistem sonuç kodu. [Bakınız](https://doc.paynet.com.tr/genel-bilgiler/hata-kodlari/doenues-kodlari)                             |
| =>message                        | string   | Sistem mesajı                                                                                                                   |
| **object\_name**                 | string   | transaction                                                                                                                     |
| **code**                         | string   | Sistem sonuç kodu. [Bakınız](https://doc.paynet.com.tr/genel-bilgiler/hata-kodlari/doenues-kodlari)                             |
| **message**                      | string   | Sistem mesajı                                                                                                                   |
| {% endtab %}                     |          |                                                                                                                                 |

{% tab title="Request" %}

```javascript
{  
   xact_id:"xk_EAAAAAh7VYf9HG4+GR9ezqiMWAA8PY6P4eroE4BUUHRCLxGO"
}
```

{% endtab %}

{% tab title="Response" %}

```javascript
{
    "Data": [
        {
            "xact_id": "xk_EAAAAANMxo5L9mbloNAKOlBvthIjsE8xFTyR1zno4TQag7tP",
            "xact_date": "2020-02-26T15:44:42.157",
            "transaction_type": 1,
            "pos_type": 5,
            "agent_id": "1001",
            "is_tds": true,
            "bank_id": "MAXM",
            "bank_name": "İş bankası",
            "instalment": 0,
            "card_no": "435508******4358",
            "card_brand_name": "Maximum",
            "card_holder": "Paynet",
            "card_type": "cc",
            "ratio": 0.0159,
            "end_user_ratio": 0,
            "amount": 21.13,
            "netAmount": 20.79,
            "comission": 0.34,
            "end_user_comission": 0,
            "comission_tax": 0,
            "currency": "TRY",
            "authorization_code": "638201",
            "reference_code": "005715421739",
            "order_id": "9C37AF7821AC4CFC8EE923EBA7DE33C9",
            "is_succeed": true,
            "reversed": false,
            "reversed_xact_id": "xk_EAAAANxxw5/89flAlvE6PHF8CtjyOp4K6cXObjuNUIau8t/i",
            "reversal_available": true,
            "reversal_remain_amount": 21.13,
            "xact_transaction_id": "9C37AF78-21AC-4CFC-8EE9-23EBA7DE33C9",
            "email": "",
            "phone": "          ",
            "note": "Kart bilgilerinizi girip ödemeyi tamamla butonuna tıklayınız",
            "agent_reference": "",
            "company_amount": 0,
            "company_commission": 0,
            "company_commission_with_tax": 0,
            "company_net_amount": 0,
            "agent_amount": 21.13,
            "agent_commission": 0.34,
            "agent_commission_with_tax": 0.34,
            "agent_net_amount": 20.79,
            "company_cost_ratio": 0,
            "company_pay_ratio": 0,
            "company_vdate": "0001-01-01T00:00:00",
            "agent_vdate": "2020-02-28T00:00:00",
            "xact_type_desc": "Satış",
            "payment_string": "Maximum  Tek çekim",
            "pos_type_desc": "Paynet POS",
            "agent_name": "Paynet Ödeme Hizmetleri",
            "company_name": "PAYNET PF ÜYE FİRMA",
            "instalment_text": "Tek Çekim",
            "ipaddress": "127.0.0.0",
            "client_id": "                                    ",
            "ratio_code": "S1SNWPGC",
            "ratio_code_method": "D",
            "domain": "https://paynet.com.tr",
            "user_name": "PaynetApi",
            "company_code": "1001",
            "id": 7453380,
            "channel_id": 2,
            "short_name": "İş bankası",
            "is_from_mail_order": false,
            "mail_order_user_name": "",
            "api_file": "",
            "campaign_url": "",
            "campaign_txt": "",
            "cancel_status": null,
            "plus_installment": 0,
            "object_name": "transaction",
            "code": 0,
            "message": "Başarılı İşlem"
        }
    ],
    "object_name": "transaction",
    "code": 0,
    "message": "Başarılı İşlem"
}
```

{% endtab %}

{% tab title="Service Url" %}

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

{% hint style="info" %}
**id**, **xact\_id** , **xact** veya **reference\_no** 'dan en az birini göndermeniz gerekmektedir.
{% endhint %}
