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.


Last updated