# Tekrarlı Ödeme İşlemleri
Tekrarlı ödeme planları, belirli bir tutarın önceden tanımlanmış sıklık ve tekrar sayısına göre otomatik olarak tahsil edilmesini sağlar. Bu yapı özellikle abonelik, üyelik, taksitli hizmet bedelleri ve periyodik ödemeler için kullanılır.
API üzerinde bu işlemler aşağıdaki aksiyonlar ile gerçekleştirilir:
* **RECURRINGPLANADD** – Tekrarlı ödeme planı oluşturma
* **RECURRINGPLANEDIT** – Mevcut tekrarlı ödeme planını veya ödemeyi güncelleme
* **QUERYRECURRINGPLAN** – Tekrarlı ödeme planı sorgulama
***
### Tekrarlı Ödeme Planı Ekleme
#### Aksiyon
`RECURRINGPLANADD`
Bu aksiyon, belirli bir tutar için farklı zamanlarda çalışacak planlanmış ödemeler grubunu oluşturmak için kullanılır.
**RECURRINGPLANADD** isteği aşağıdaki istek alanlarını beklemektedir.
`POST` `https://entegrasyon.paratika.com.tr/paratika/api/v2`
| Parametre | Açıklama |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| MERCHANT | Bilgilerim sekmesi altından temin ettiğiniz üye iş yeri numaranız gönderilmelidir. |
| MERCHANTUSER | Oluşturduğunuz Merchant Api User kullanıcısının e-posta adresi gönderilmelidir. |
| MERCHANTPASSWORD | Oluşturduğunuz Merchant Api User kullanıcısının şifresi gönderilmelidir. |
| ACTION | Bu istek tipi için **RECURRINGPLANADD** olarak gönderilmelidir. |
| INSTANTPAYMENT |
Tekrarlı ödeme planı ekleme esnasında anlık çekim yapılmak isteniyor ise bu değer "YES" olarak gönderilmelidir. Default değeri "NO"dur.
Tekrarlı çekim yapılmak istenen kredi kartının son kullanım tarihi bilgisi.
mm.yy
|
| NAMEONCARD | Tekrarlı çekim yapılmak istenen kredi kartı üzerindeki isim bilgisi. |
| CUSTOMER | Tekrarlı çekim planı eklenmek istenen müşteriniz için tekil ayıraç. |
| CUSTOMEREMAIL | Tekrarlı çekim planı eklenmek istenen müşterinizin e-posta adresi. |
| RECURRINGPLANCODE | Eklemek istediğiniz tekrarlı çekim planı için tekil ayıraç kodunu. |
| RECURRINGAMOUNT | Tekrarlı çekim tutarı. |
| RECURRENCECOUNT | Tekrarlı çekim sayısı. |
| FREQUENCY |
Tekrarlı çekim sıklığı.
Gün için D, ay için M, yıl için Y kullanılmalıdır. (Örn.: 5D, 3M, 1Y)
|
| CURRENCY | Tekrarlı çekim para birimi. |
***
***
### Tekrarlı Ödeme Planı Güncelleme
#### Aksiyon
`RECURRINGPLANEDIT`
Bu aksiyon ile;
* Tekrarlı ödeme planının durumu
* Kart bilgileri
* Ödeme tutarı
* Ödeme sistemi
* Tekil bir tekrarlı ödemenin başlangıç tarihi veya tutarı
güncellenebilir.
***
**RECURRINGPLANEDIT** isteği aşağıdaki istek alanlarını beklemektedir.
`POST` `https://entegrasyon.paratika.com.tr/paratika/api/v2`
| Parametre | Açıklama |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------- |
| MERCHANT | Bilgilerim sekmesi altından temin ettiğiniz üye iş yeri numaranız gönderilmelidir. |
| MERCHANTUSER | Oluşturduğunuz Merchant Api User kullanıcısının e-posta adresi gönderilmelidir. |
| MERCHANTPASSWORD | Oluşturduğunuz Merchant Api User kullanıcısının şifresi gönderilmelidir. |
| ACTION | Bu istek tipi için **RECURRINGPLANEDIT** olarak gönderilmelidir. |
| RECURRINGPLANCODE | Güncellenmek istenen tekrarlı çekim planının tekil ayıraç kodu gönderilmelidir. |
| RECURRINGSTATUS | Deaktif edilmek isteniyor ise "**INACTIVE**" olarak gönderilmelidir. |
| CARDPAN | Güncellenmek istenen tekrarlı çekim planının kredi kartı numarası. |
| CARDEXPIRY |
Güncellenmek istenen tekrarlı çekim planı kredi kartının son kullanım tarihi bilgisi.
mm.yy
|
| NAMEONCARD | Güncellenmek istenen tekrarlı çekim planı kredi kartı üzerindeki isim bilgisi. |
***
***
### Tekrarlı Ödeme Planı Sorgulama
#### Aksiyon
`QUERYRECURRINGPLAN`
**QUERYRECURRINGPLAN** isteği aşağıdaki istek alanlarını beklemektedir.
`POST` `https://entegrasyon.paratika.com.tr/paratika/api/v2`
| Parametre | Açıklama |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| MERCHANT | Bilgilerim sekmesi altından temin ettiğiniz üye iş yeri numaranız gönderilmelidir. |
| MERCHANTUSER | Oluşturduğunuz Merchant Api User kullanıcısının e-posta adresi gönderilmelidir. |
| MERCHANTPASSWORD | Oluşturduğunuz Merchant Api User kullanıcısının şifresi gönderilmelidir. |
| ACTION | Bu istek tipi için **QUERYRECURRINGPLAN** olarak gönderilmelidir. |
| RECURRINGPLANCODE | Sorgulanmak istenen tekrarlı çekim planının tekil ayıraç kodu gönderilmelidir. |
| STARTDATE |
Tek bir plan yerine, tarih aralığındaki tüm planlar sorgulanmak istendiğinde başlangıç ve bitiş tarihi verilmelidir.
Örnek: 01-12-2025 00:00
|
| ENDDATE |
Tek bir plan yerine, tarih aralığındaki tüm planlar sorgulanmak istendiğinde başlangıç ve bitiş tarihi verilmelidir.
Örnek: 31-12-2025 00:00
|
| CARDPAN | Sorgulanmak istenen tekrarlı çekim planı kredi kartı numarası. |
| NAMEONCARD | Bir müşteriye tanımlanmış olan tekrarlı çekim planlarını sorgulamak için, müşterinin tekil ayıraç kodu gönderilmelidir. |
***
***
* **RECURRINGPLANCODE** ve **CUSTOMER** alanları sistem genelinde tekil olmalıdır.
***
---
# 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.paratika.com.tr/entegrasyon/api-istekleri/tekrarli-odeme-islemleri.md?ask=
```
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.