> 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/api-istekleri/tekrarli-odeme-islemleri.md). # 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.

| | FIRSTAMOUNT | Anlık çekim yapılmak istenen ödeme tutarı. | | CARDPAN | Tekrarlı çekim yapılmak istenen kredi kartı numarası. | | CARDEXPIRY |

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