# İş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](/authentication.md#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](/genel-bilgiler/taksit-kodlari.md)                                                                     |
| =>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](/genel-bilgiler/veri-tipleri/kart-tipi.md)                                                               |
| =>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](/genel-bilgiler/hata-kodlari/doenues-kodlari.md)                                                   |
| **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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.paynet.com.tr/servisler/islem/islem-detay.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
