> For the complete documentation index, see [llms.txt](https://docs.iyzico.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iyzico.com/ek-servisler/sftp.md).

# 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.