> For the complete documentation index, see [llms.txt](https://docs.paratika.com.tr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.paratika.com.tr/entegrasyon/tarim-kart-entegrasyonu.md).

# Tarım Kart Entegrasyonu

Tarım Kart işlemleri; **DenizBank, İş Bankası, Kuveyt Türk, Şekerbank, TEB ve VakıfBank** tarafından sunulan tarımsal kartlar ile yapılan, **ödemesi ileri tarihli (ötelemeli)** satış işlemlerini kapsamaktadır.

Tarım Kart ile işlem gerçekleştirebilmek için öncelikle satış temsilciniz ile iletişime geçerek **üye işyerinizin “Tarım Üye İşyeri” olarak tanımlanması** gerekmektedir. Bu tanımlama tamamlandıktan sonra:

* **HPP (Hosted Payment Page)**
* **Web Servis (API)**

entegrasyonları üzerinden Tarım Kart işlemleri gerçekleştirilebilir.

> 📌 Desteklenen öteleme ay seçenekleri banka bazında değişiklik gösterebilir. Kullanılabilir öteleme süreleri için **<destek@paratika.com.tr>** adresi ile iletişime geçilmelidir.

***

### Satış İşlemi (SALE)

Satış işlemi, müşterinin Tarım Kartı ile gerçekleştirdiği ve ödemesi **belirlenen vade sonunda tahsil edilen** işlemdir. Bankaya göre aşağıdaki `EXTRA` parametreleri gönderilmelidir.

***

#### DenizBank

DenizBank Tarım Kart işlemleri için aşağıdaki parametreler zorunludur:

* `DenizbankAgriculture.AgricultureTxnFlag` → **Sabit olarak `T` gönderilmelidir**
* `DenizbankAgriculture.PaymentFrequency` → Öteleme ay sayısı
* `DenizbankAgriculture.MaturityPeriod` → Öteleme ay sayısı

```json
EXTRA: {
  "DenizbankAgriculture.PaymentFrequency": "3",
  "DenizbankAgriculture.MaturityPeriod": "3",
  "DenizbankAgriculture.AgricultureTxnFlag": "T"
}
```

***

#### İş Bankası

İş Bankası Tarım Kart işlemlerinde:

* `IMCKOD` → Ürün tipi
* `FDONEM` → Öteleme ay sayısı

`IMCKOD` aşağıdaki değerlerden biri olarak gönderilmelidir:

| IMCKOD | Ürün Adı  |
| ------ | --------- |
| 1      | Gübre     |
| 2      | Akaryakıt |
| 3      | İlaç      |
| 4      | Tohum     |
| 5      | Diğer     |

```json
EXTRA: {
  "IMCKOD": "5",
  "FDONEM": "1"
}
```

***

#### Kuveyt Türk

Kuveyt Türk Tarım Kart işlemlerinde:

* `KUVEYTURK.DEFERRINGCOUNT` → Öteleme ay sayısı

```json
EXTRA: {
  "KUVEYTURK.DEFERRINGCOUNT": "3"
}
```

***

#### Şekerbank

Şekerbank Hasat Kart işlemleri için aşağıdaki alanlar gönderilmelidir:

| Parametre  | Açıklama                               |
| ---------- | -------------------------------------- |
| URUNKODU   | Maks. 2 karakter                       |
| PLASIYERNO | Satış temsilcisi no (maks. 6 karakter) |
| FATURANO   | Fatura no (maks. 10 karakter)          |
| VADEKODU   | Sabit `01`                             |
| VADEADEDI  | Öteleme ay sayısı                      |

```json
EXTRA: {
  "HASATKARTSATIS": "",
  "VADEKODU": "01",
  "VADEADEDI": "5",
  "URUNKODU": "B0",
  "PLASIYERNO": "123456",
  "FATURANO": "0000012345"
}
```

***

#### TEB

TEB **Harman Kart** işlemleri için **herhangi bir ekstra parametre gönderilmesine gerek yoktur.**

***

#### VakıfBank

VakıfBank Tarım Kart işlemleri için:

* `TransactionType` → **TKSale**
* `MaturityPeriod` → Öteleme ay sayısı
* `Frequency` → Öteleme ay sayısı

```json
EXTRA: {
  "VakifbankAgriculture.TransactionType": "TKSale",
  "VakifbankAgriculture.CustomInstallments": {
    "VakifbankAgriculture.MaturityPeriod": "2",
    "VakifbankAgriculture.Frequency": "2"
  }
}
```

***

### Satış İşlemi – Örnek İstek

```
ACTION:SALE
MERCHANT:[MERCHANT]
MERCHANTUSER:[MERCHANTUSER]
MERCHANTPASSWORD:[MERCHANTPASSWORD]
AMOUNT:100
CURRENCY:TRY
MERCHANTPAYMENTID:{{$randomUUID}}
CUSTOMER:[CUSTOMER]
CUSTOMEREMAIL:[CUSTOMEREMAIL]
CUSTOMERNAME:[CUSTOMERNAME]
CUSTOMERPHONE:[CUSTOMERPHONE]
CUSTOMERIP:[CUSTOMERIP]
CARDPAN:4410777076266435
CARDEXPIRY:08.27
CARDCVV:000
NAMEONCARD:[NAMEONCARD]
EXTRA:{"IMCKOD":"5","FDONEM":"1"}
```

***

### Satış İşlemi – Örnek Cevap

```json
{
  "action": "SALE",
  "merchant": "10005448",
  "amount": 100.00,
  "currency": "TRY",
  "pgTranReturnCode": "00",
  "responseCode": "00",
  "responseMsg": "Approved"
}
```

***

### Oturum (SESSIONTOKEN)

Tarım Kart işlemleri **HPP entegrasyonunda** da desteklenmektedir. Oturum anahtarı;

* Tarayıcı bazlı
* API bazlı

entegrasyonlarda kullanılabilir.

Oturum anahtarı aşağıdaki koşullarda aynı `MERCHANTPAYMENTID` ile tekrar kullanılabilir:

* İşlem henüz tamamlanmamışsa
* Oturum süresi dolmamışsa
* Tutar, müşteri, para birimi gibi ana değişkenler değişmemişse

#### Oturum – Örnek İstek

```
ACTION:SESSIONTOKEN
SESSIONTYPE:PAYMENTSESSION
MERCHANT:[MERCHANT]
MERCHANTUSER:[MERCHANTUSER]
MERCHANTPASSWORD:[MERCHANTPASSWORD]
RETURNURL:https://test.merchantsafeunipay.com/merchant/index.jsp
MERCHANTPAYMENTID:[MERCHANTPAYMENTID]
AMOUNT:150
CURRENCY:TRY
CUSTOMER:[CUSTOMER]
CUSTOMEREMAIL:[CUSTOMEREMAIL]
CUSTOMERIP:[CUSTOMERIP]
EXTRA:{"IMCKOD":"5","FDONEM":"4"}
```

***

### İade (REFUND)

Tarım Kart işlemlerinde **iade işlemleri için ekstra parametre gönderilmesine gerek yoktur.**

***

### İptal (VOID)

Tarım Kart işlemlerinde **iptal işlemleri için ekstra parametre gönderilmesine gerek yoktur.**