# SFTP

Üye işyerleri, yerleşik raporları ve SFTP'yi kullanarak iyzico hesap finansal bilgilerini takip edebilir.

### **Bağlantı Kurma**

Bir SFTP bağlantısıyla, tüm satıcı raporlarınızı içeren kök klasöre erişebileceksiniz. Örneğin; işlem, cut-off ve para gönderim raporları.

#### **Sandbox ( Test Ortamı )**

| Ayar ismi | Değer                                       |
| --------- | ------------------------------------------- |
| Address   | sandbox-report.iyzipay.com                  |
| Protocol  | SFTP                                        |
| Port      | 22                                          |
| Username  | Hesap yöneticiniz tarafından size sağlanır. |
| Password  | Hesap yöneticiniz tarafından size sağlanır. |

####  **Canlı Ortam**

| Ayar ismi | Değer                                       |
| --------- | ------------------------------------------- |
| Address   | report.iyzipay.com                          |
| Protocol  | SFTP                                        |
| Port      | 22                                          |
| Username  | Hesap yöneticiniz tarafından size sağlanır. |
| Password  | Hesap yöneticiniz tarafından size sağlanır. |

{% hint style="info" %}
**NOT :** Sandbox ve Canlı ortam SFTP ENV'lerinin belirli terimlerle farklılık gösterebileceğini unutmayınız.
{% endhint %}

### **Rapor Türleri**

İki farklı şablona sahip 3 tür rapor vardır. Bir şablon işlem raporları içindir. Diğer bir şablon ise hem kesim hem de kapatma raporları içindir.

Kesim/uzlaştırma raporu şablonunun, işlem raporu şablonu raporunun gösterdiğini göstermediğini (preauth) unutmayın. Ayrıca, kesim/uzlaştırma raporu şablonunda, işlem raporu şablonunda sunulmayan 2 sütun daha olduğunu unutmayınız.

* settlementReferenceCode
* settlementResolveDate

Ayrıca özet alanında bir sütun daha vardır.

* totalMerchantPayoutAmount

**İşlem Raporu :**  İşlem raporları her üye iş yeri için günlük olarak oluşturulur ve CSV formatında işlem düzeyine ilişkin detaylı bilgileri içerir. Şunları içerir (auth, preauth, postauth, cancel, iade)\
Dosyanın kökü ve adı /transaction/transaction-MID-20160917.csv olacaktır.

**Cut-off** **Raporu** : Cut-off raporları her üye iş yeri için günlük olarak oluşturulur ve CSV formatında işlem düzeyi ile ilgili detaylı bilgileri içerir. (auth, postauth, cancel, iade) içerir. Dosyanın kökü ve adı /cutoff/cutoff-MID-20160917.csv olacaktır.

Cut-off ile işlem raporu arasındaki temel fark, kesimin yalnızca nihai olan ve size kapatılacağı onaylanan işlemleri göstermesidir. Bu kesim raporuna ek olarak, kapatılacak tutarın bir özetini gösterir.

**Para Gönderim Raporu :** Para gönderim raporları dosyaları her satıcı ödemesi için oluşturulur ve işlem düzeyinde CSV biçiminde ayrıntılı bilgiler içerir. Günlük, haftalık veya aylık olarak üretilebilir ayrıca (auth, postauth, cancel, iade) içerir.

### **Alanlar**

#### **Main**

| Parametre ismi            | Tip     | Açıklama                                                          |
| ------------------------- | ------- | ----------------------------------------------------------------- |
| transactionDate           | date    | işlem tarihi                                                      |
| transactionType           | string  | type of the transaction (auth, preauth, postauth, refund,cancel)  |
| isAfterSettlement         | integer | işlemin türü (auth, preauth, postaauth, iade, iptal)              |
| paymentTxId               | long    | ödeme öğe kimliği                                                 |
| paymentId                 | long    | iyzico tarafından sağlanan sipariş kimliği                        |
| conversationId            | string  | satıcı tarafından sağlanan sipariş kimliği                        |
| paymentPhase              | string  | ödeme aşaması (AUTH, PREAUTH, POSTAUTH)                           |
| paymentGroup              | string  | ödeme grubu (ÜRÜN, ABONELİK, LİSTELEME, DİĞER)                    |
| price                     | decimal | toplam ürün tutarı                                                |
| paidPrice                 | decimal | nihai ödeme tutarı (taksit ücreti, vergi, makbuz.. dahil)         |
| transactionCurrency       | ISO     | satış para birimi                                                 |
| installment               | integer | taksit sayısı                                                     |
| binNumber                 | string  | kartın ilk 6 hanesi                                               |
| cardFamily                | string  | kart ailesi                                                       |
| cardAssociation           | string  | kart kuruluşu (VISA, MASTERCARD, AMEX, vb.)                       |
| cardType                  | string  | kart türü (CREDIT, DEBIT..)                                       |
| isThreeDs                 | boolean | 3D ödeme durumu                                                   |
| buyerName                 | string  | alıcının adı                                                      |
| buyerSurname              | string  | alıcının soyadı                                                   |
| buyerEmail                | string  | alıcının e-postası                                                |
| paymentBuyerId            | string  | alıcı kimliği                                                     |
| iyziCommissionRateAmount  | decimal | iyico komisyon oranı tutarı                                       |
| iyziCommissionFee         | decimal | iyzico komisyon ücreti tutarı                                     |
| parity                    | decimal | parite                                                            |
| settlementCurrency        | decimal | raporun para birimi                                               |
| iyziConversionRateAmount  | decimal | iyzico çevrim oranı tutarı (başka bir para birimi kullanılıyorsa) |
| merchantPayoutAmount      | decimal | üye işyeri ödeme tutarı işlem                                     |
| connectorType             | string  | modal tanımlayıcı                                                 |
| posOrderId                | string  | gate modeli için geçerli                                          |
| posName                   | string  | gate modeli için geçerli                                          |
| subMerchantKey            | string  | pazaryeri modeli için geçerli                                     |
| subMerchantEmail          | string  | pazaryeri modeli için geçerli                                     |
| subMerchantName           | string  | pazaryeri modeli için geçerli                                     |
| subMerchantPayoutAmount   | decimal | pazaryeri modeli için geçerli                                     |
| settlementReferenceCode   | decimal | yerleşim referans kodu                                            |
| settlementResolveDate     | decimal | ödeme tarihini çözmek                                             |
| authCode                  | integer | altı haneli işlem yetkilendirme kodu.                             |
| refundConversationId      | string  | geri ödeme ve iptal isteğinin konuşma kimliği                     |
| basketId                  | string  | ödeme talebinin basketid parametresi                              |
| lastFourDigits            | integer | kartın son dört hanesi                                            |
| chargeType                | string  | ücret türü                                                        |
| chargeId                  | integer | ödemenin benzersiz kimliği                                        |
| disputeReferenceCode      | string  | anlaşmazlığın referansı                                           |
| disputeReasonCategoryCode | integer | anlaşmazlık kategorisi                                            |

#### Summary

cut-off ve para gönderim raporları için kullanılabilir.

<table><thead><tr><th>Parametre ismi</th><th width="135.33333333333331">Tip</th><th>Açıklama</th></tr></thead><tbody><tr><td>transactionCurrency</td><td>ISO</td><td>işlemlerin para birimi</td></tr><tr><td>totalPayments</td><td>decimal</td><td>tüm ödeme olaylarının toplamı</td></tr><tr><td>totalPaymentAmount</td><td>decimal</td><td>toplam ödeme tutarları</td></tr><tr><td>totalCancels</td><td>decimal</td><td>tüm iptal etkinliklerinin toplamı</td></tr><tr><td>totalCancelAmount</td><td>decimal</td><td>toplam iptal tutarları</td></tr><tr><td>totalRefunds</td><td>decimal</td><td>toplam geri ödeme olayı</td></tr><tr><td>totalRefundAmount</td><td>decimal</td><td>toplam geri ödeme tutarları</td></tr><tr><td>totalCharges</td><td>decimal</td><td>toplam geri ödeme tutarları</td></tr><tr><td>totalChargeAmount</td><td>decimal</td><td>toplam geri ödeme tutarları</td></tr><tr><td>totalDisputes</td><td>decimal</td><td>toplam geri ödeme tutarları</td></tr><tr><td>totalDisputeAmount</td><td>decimal</td><td>toplam geri ödeme tutarları</td></tr><tr><td>netAmount</td><td>decimal</td><td>toplam dosya miktarı.</td></tr><tr><td>settlementCurrency</td><td>decimal</td><td>ödeme para birimi</td></tr><tr><td>totalMerchantPayoutAmount</td><td>decimal</td><td>satıcıya toplam ödeme</td></tr><tr><td>bankName</td><td>string</td><td>hesabın banka adı</td></tr><tr><td>bankAccountNumber</td><td>string</td><td>hesabın IBAN numarası</td></tr><tr><td>bankReferenceCode</td><td>string</td><td>iyzico tarafından oluşturulan benzersiz referans kodu</td></tr><tr><td>reportVersion</td><td>string</td><td>yerleşimin rapor versiyonu Örn: 120</td></tr></tbody></table>

### <mark style="color:blue;">**Notlar**</mark>

Satıcılar, bağlantı izni için IP adreslerini paylaşmalıdır. Zamanlama hakkında daha fazla bilgi, ilgili iyzico ekibi tarafından iletilecektir.

**İşlem ve Cut-off Raporları :**

* Sandbox ortamında dosya oluşturma saat 00:00'da başlar ve saat 01:00'de (GMT +3) çekmek güvenlidir.
* Canlı ortamda dosya oluşturma saat 00:00'da başlar ve saat 01:00'de güvenle alınabilir (GMT +3)

**Para Gönderim Raporları :**

* Sandbox ortamında dosya oluşturma saat 11:00'de başlar ve saat 17:00'de (GMT +3) çekmek güvenlidir.
* Canlı ortamda dosya oluşturma saat 11:00'de başlar ve saat 17:00'de (GMT +3) çekmek güvenlidir.


---

# 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://docs.iyzico.com/ek-servisler/sftp.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.