# Düzenli Ödeme Oluşturma Bu servis ile müşterinize bir düzenli ödeme talebi oluşturabilirsiniz. Servisten dönen "url" , müşterinizin düzenli ödeme için kart bilgilerini girebileceği ve düzenli ödemenin şartlarına onay verebileceği sayfanın erişim linkidir.İsterseniz müşterinizden kart bilgilerini ve onayı alacağınız sayfayı kendi web siteniz içine düzenli ödeme custom form entegrasyonu ile entegre edebilirsiniz. Bununla ilgili daha detay bilgiyi **** mail adresinden alabilirsiniz. {% hint style="success" %} {% endhint %} {% tabs %} {% tab title="İstek Parametreleri" %} | Parametre İsmi | Tip | Zorunlu | Açıklama | | ------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **name\_surname** | string | Evet | İsim ve soyisim bilgisi | | **amount** | decimal | Evet | Düzenli ödeme tutarı | | **interval** | int | Evet | Ödeme periyodu( 0:Günlük, 1:Haftalık, 2:Aylık, 3:Yıllık) | | **interval\_count** | int | Evet | Toplam çekim adedi. interval aylık(2) ise interval\_count 12 ise bir yıl boyunca her ay çekim yapar. | | **begin\_date** | datetime | Evet | Düzenli ödeme başlangıç tarihi | | **reference\_no** | string | Evet | Referans numarası bilgisi | | **end\_user\_email** | string | Evet | Son kullanıcı email bilgisi | | **end\_user\_gsm** | string | Evet | Son kullanıcı gsm bilgisi | | **agent\_id** | string | Hayır | Paynet bayi kodu | | **agent\_amount** | decimal | Evet | Ödeme çekildikten sonra burada belirtilen tutar bayi hesabına aktarılır.Tutar belirtilmezse default ayarlar geçerlidir. | | **company\_amount** | decimal | Evet | Ödeme çekildikten sonra burada belirtilen tutar Ana Firma hesabına aktarılır. Tutar belirtilmezse default ayarlar geçerlidir. | | **end\_user\_desc** | string | Evet | Son kullanıcıya gösterilecek açıklama. " xxx aidatınız için düzenli ödeme onayı istiyoruz " gibi | | **addcomission\_to\_amount** | string | Hayır | True/False. Default: false. Komisyon tutarının ödeme tutarına eklenip eklenmeyeceği belirlenir. True olduğunda komisyon tutarı kredi kartından çekilecek tutara eklenir. | | **currency** | string | Hayır | Para birimi. Sadece TL destekleniyor. | | **period** | int | Hayır | Ödemenin hangi periyotta olacağını belirler. (Default:0), interval ve interval\_count ile birlikte kullanılır. Örn: 12 adetli aylık ödemeli düzenli ödeme talimatında periyod 2 girilirse; 2 ayda bir çekim yapılır ve toplam 24 ayda tamamlanır. | | **user\_name** | string | Hayır | Düzenli ödeme talebini oluşturan kullanıcının adı | | **agent\_note** | string | Hayır | Düzenli ödeme talebini oluşturan bayinin kendisine notu. Sadece bayi görür. | | **confirmation\_webhook** | string | Hayır | Düzenli ödeme talebi son kullanıcı tarafından onaylanırsa , burada belirleyeceğiniz URL'e request gönderilir. | | **suceed\_webhook** | string | Hayır | Düzenli ödeme onaylandıktan sonra karttan ödeme çekimleri başarılı olduğunda burada belirleyeceğiniz URL'e request gönderilir. | | **error\_webhook** | string | Hayır | Düzenli ödeme onaylandıktan sonra karttan ödeme çekimleri hatalı olduğunda burada belirleyeceğiniz URL'E request gönderilir. | | **confirmation\_redirect\_url** | string | Hayır | Düzenli ödeme talebi son kullanıcı tarafından onaylandığında redirect edilecek sayfanın URL'ini burada gönderilir. | | **send\_mail** | bool | Hayır | Email gönderilsin mi? True ise düzenli ödeme talebi oluşturulduktan sonra son kullanıcının email adresine düzenli ödemeyi onaylaması için gerekli link mail olarak gönderilir. | | **send\_sms** | bool | Hayır | Sms gönderilsin mi?True ise düzenli ödeme talebi oluşturulduktan sonra son kullanıcın telefonuna düzenli ödemeyi onaylaması için gerekli link sms olarak gönderilir. | | **is\_fixed\_price** | bool | Hayır | Sabit tutar mı? True ise tüm ödemeler amount alanında belirtilen tutar kadar çekilir. False ise invoince\_create servisi ile her bir ödeme için çekilecek tutarı vade bilgisi ile göndermelisiniz. | | **auto\_renew** | bool | Hayır | Düzenli ödeme emri bitince tekrarlansın mı? | | **agent\_logo** | string | Hayır | Bayi logo linki | | **attempt\_day\_count** | int | Hayır | Ödeme çekim deneme gün sayısı. Default 3 gündür. 3 gün boyunca tanımlı kartlardan ödeme çekilmeye çalışılır. 3 günün sonunda hala çekim yapılamaz ise sözleşmeyi durdurur. | | **daily\_attempt\_count** | int | Hayır | Ödeme gün içerisinde çekim denemesi sayısı. Default 3 gündür. Gün içerisinde karttan en fazla 3 kez çekim denemesi yapılır. | | {% endtab %} | | | | {% tab title="Dönüş Parametreleri" %} | Parametre İsmi | Tip | Açıklama | | -------------------- | ------ | ------------------------------- | | **object\_name** | string | Dönüş yapılan API'nin nesne adı | | **code** | string | Dönüş sonucunun kodu | | **message** | string | Dönüş sonuç kodunun açıklaması | | **url** | string | Düzenli ödeme URL'i | | **subscription\_id** | string | Düzenli ödeme ID | | **status** | string | Düzenli ödeme durumu | | {% endtab %} | | | {% tab title="Request" %} ```javascript { "name_surname":"Ozan Manav", "amount":2000, "interval":2, "interval_count":12, "reference_no":"90000543", "begin_date":"2017-08-14T16:44:49.9405776+03:00", "end_user_email":"ozan.manav@arena.com.tr", "end_user_gsm":"5452838997", "agent_id":"48811", "send_mail":false, "send_sms":false, "is_fixed_price":false, "attempt_day_count":"5", "suceed_webhook":"http://test.com/successpage", "error_webhook":"http://test.com/errorpage", "confirmation_webhook":"http://test.com/confirmationpage", "end_user_desc":"90000543 numaralı üyelik" } ``` {% endtab %} {% tab title="Response" %} ``` { "object_name":"subscription_create", "code":0, "message":"Başarılı Islem" } ``` {% endtab %} {% tab title="Service Url" %} | Sistem | URL | | ---------------- | ---------------------------------------------------------------------------------------------------------- | | **Canlı Sistem** | | | **Test Sistemi** | /[v1/subscription/create](https://api.paynet.com.tr/v1/subscription/create) | | {% endtab %} | | | {% endtabs %} | |