Subscription

iyzico subscription API, online ödeme alabilen üye işyerlerine hızlıca abonelik oluşturma imkanı sağlar. Kart saklama, ödeme takibi gibi ekstra kaynak ve development gerektiren sürece girmeden tekrarlı ödemeler alınabilir. Eğer iş modeliniz tekrarlı ödeme almaya uygunsa örneğin premium, gold üyelik sunan bir servis sağlayıcısı, spor salonu hizmetleri, dergi aboneliği vs. subscription API size hızlı ve güvenilir bir çözüm sunar.

Abonelik sistemi temelde 3 aşamadan oluşur.

1. ÜRÜN
2. PLAN
3. ABONELİK

Örneğin yayınladığınız 2 farklı dergi için abonelik süreci başlatmak isterseniz, A dergisi ve B dergisi olarak iki ürün oluşturmanız, dergilerin basım zamanına göre ödeme planı oluşturmanız yeterlidir. A dergisinin her ay, B dergisinin her hafta basıldığını varsayarsak, A dergisine ait plan aylık 50 TL, B dergisine ait plan haftalık 30 TL olarak belirlenebilir. iyzico her plan için size bir referans kodu verir. Bir ödeme isteğinde bu referans kodunu göndermeniz, son kullanıcıyı o plana abone yapmak için yeterlidir.

Ürün ve planlar iyzico merchant panelinden veya API istekleri ile saniyeler içinde oluşturulabilir, güncellenebilir veya silinebilir. Aboneliği başlatmak için API üzerinden bir ödeme isteği gönderilmelidir. Ödeme, checkout form veya direk API isteği ile gerçekleştirilebilir.

Bu sayfada subscription API temel bilgileri anlatılmaktadır. Detaylı API dökümantasyonu linkten indirilebilir. Destek için entegrasyon@iyzico.com adresine yazabilirsiniz.

NOT: Abonelik çözümü sadece kredi kartları ile kullanılabilmektedir.

1- ÜRÜN

Subscription API ödeme planlarına göre tekrarlı ödeme alır ve her ödeme planı en az bir ürüne bağlıdır. Ürün sayısında herhangi bir sınırlama yoktur ve sadece isim bilgisi gönderilerek bir ürün oluşturulabilir.

iyzico merchant panelinden veya API üzerinden aşağıdaki işlemler gerçekleştirilebilir.

• Ürün oluşturma
• Ürün güncelleme
• Ürün silme
• Ürün detaylarını görme
• Ürün listeleme

Servise gönderilmesi gereken parametreler şu şekildedir:

Servisten dönen parametreler şu şekildedir:

Ürün güncelleme, ürün silme, ürün detayı getirme ve ürün listeleme servisleri ayrıntılı dökümantasyonda gösterilmektedir.

2- PLAN

Ödeme planı müşterilerinizin hangi tutarda, hangi aralıkta ve ne kadar süre ödeme yapacağını belirler. Bir ürüne dilediğiniz kadar farklı fiyat ve ödeme sıklığında ödeme planı ekleyebilirsiniz.

iyzico merchant panelinden veya API üzerinden aşağıdaki işlemler gerçekleştirilebilir.

• Plan oluşturma
• Plan güncelleme
• Plan silme
• Plan detaylarını görme
• Plan listeleme

Servise gönderilmesi gereken parametreler şu şekildedir:

Servisten dönen parametreler şu şekildedir:

Plan güncelleme, ürün silme, ürün detayı getirme ve ürün listeleme servisleri ayrıntılı dökümantasyonda paylaşılmıştır.

3- ABONELİK

Genel hatlarıyla abonelik süreci

• Müşterilerinizden günlük, haftalık, aylık veya yıllık tekrarlayan ödemeler alabilirsiniz.
• Aboneliğe konu olacak ürünün ya da hizmetin adı, açıklaması, fiyatı, tekrarlı ödeme sıklığı gibi parametreler hem iyzico kontrol paneli hem de API üzerinden ayarlanabilmektedir.
• iyzico'nun POS ürünü gibi hem API ile hem de check-out form ile ödeme alma imkanı vardır.
• Kredi kartı saklama ile ilgili tüm süreç ve gereksinimlerin karşılanması iyzico tarafındadır. Kolay ödeme formu ile müşterinin girdiği kart bilgisi iyzico tarafında güvenle saklanarak tekrarlayan ödemeler bu karttan tahsil edilir.
• Tekrarlayan ödemeler iyzico tarafından günü geldiğinde müşterinizin kayıtlı kredi kartından tahsil edilir. Başarılı ve başarısız tahsilat işlemlerini kontrol panelinizden ve API üzerinden sorgulayabilirsiniz. Başarısız ödemelerin tekrar tetiklenmesini API ya da panel üzerinden yapabilirsiniz.
• Ödeme planınıza opsiyonel olarak ekleyebileceğiniz "Otomatik abonelik sonlandırma" ile müşterinizin aboneliği önceden belirlediğiniz tekrarlı ödeme sayısına ulaşınca abonelik otomatik olarak sonlanır.
• Her bir ödeme planı için deneme süresi tanımlayabilirsiniz. Kredi kartı bilgisi deneme süresi başlangıcında, yani ilk aşamada kaydedildiği için Abonelik, tanımladığınız deneme süresi sonunda tahsilatı otomatik yapılarak başlatılacaktır.
• Müşterilerinizin aboneliğini dilediğiniz bir anda API veya panel üzerinden iptal edebilirsiniz. İptal edilen abonelikler için bir sonraki ve takip eden dönemlerde hiç bir tahsilat yapılmaz.
• Abonelik yalnızca kredi kartına yapılabilmektedir, debit kartlar kabul edilmemektedir.
• Web-hook yöntemi ile sizin vereceğiniz bir endpoint'e her tahsilat denemesinin sonucu hakkında bilgilendirme isteği gönderilebilir.

ABONELİK BAŞLATMA

CHECKOUT FORM OLUŞTURULLMASI

Bu sayfada yalnızca checkout form ile abonelik oluşturma bilgisi verilmiştir. Direk API ile abonelik oluşturmak için dökümanı inceleyebilir veya destek ekibimizle(entegrasyon@iyzico.com) iletişime geçebilirsiniz

iyzico'nun standart ödemelerde sunduğu checkout form çözümü, abonelik için benzer yapıda kullanılabililir

Checkout form oluşturulması için gerekli bilgiler şunlardır:

• Plan referans kodu
• Müşteri bilgisi
• Abonelik durumu
• CallBack adresi

Servise gönderilmesi gereken parametreler şu şekildedir:

    Servisten dönen parametreler şu şekildedir:

Dönen cevap içerisindeki checkoutFormContent parametresi iyzico ödeme formunu oluşturmak için gerekli HTML kodunu içermektedir. chekoutFormContent parametresini bastırdığınız sayfada aşağıdaki "div" satırını eklediğiniz alanda ödeme formu oluşacaktır.

Responsive kullanım <div id="iyzipay-checkout-form" class="responsive"></div>

Pop-up kullanım <div id="iyzipay-checkout-form" class="popup"></div>

CHECKOUT FORM SONUCU KONTROLÜ

Abonelik için oluşturulan ödeme formuna kart bilgileri girilip "X TL Öde" butonuna basıldığında; karttan 1 TL çekilerek kartın geçerliliği kontrol edilir. Bu tutar hemen iade edilir ve kullanıcı ödeme formunu oluştururken belirlenen callbackUrl adresine yönlenir. Bu adrese bir token değeri post edilir. Üye iş yeri bu token değeri ile ikinci bir sorgu yapıp abonelik sonucunu öğrenmelidir. Bu sorguda kullanacağınız token değerini ödeme formunu oluşturduğunuz anda ya da callbackUrl adresinize iyzico tarafından post edildiğinde alabilirsiniz.

Cevapta dönecek status success ve subscriptionStatus ACTIVE veya PENDING ise abonelik başarıyla oluşturulmuş demektir.

Servise gönderilmesi gereken parametreler şu şekildedir:

    Servisten dönen parametreler şu şekildedir:

İlerleyen aylarda tekrar eden ödeme sonuçlarını alabilmek için subscription url tanımlamanız gerekmektedir.Subscription url’i entegrasyon@iyzico.com mail adresine göndererek ilgili ekibimizin tanımlama yapmasını sağlayabilirsiniz .