> For the complete documentation index, see [llms.txt](https://docs.iyzico.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iyzico.com/on-hazirliklar/api-reference-beta/abonelik/abonelik/abonelik-baslatma.md).

# Abonelik Başlatma

## Abonelik Başlatma (NON3D)

> Hazır ödeme formu olmadan, Tarafınıza ait ödeme formu ile NON3D servisi üzerinden abonelik başlatabilirsiniz.

```json
{"openapi":"3.0.3","info":{"title":"Subscription - Abonelik Başlatma","version":"1.0.0"},"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/v2/subscription/initialize":{"post":{"summary":"Abonelik Başlatma (NON3D)","description":"Hazır ödeme formu olmadan, Tarafınıza ait ödeme formu ile NON3D servisi üzerinden abonelik başlatabilirsiniz.","tags":["Abonelik"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartSubscriptionNon3DRequest"}}}},"responses":{"200":{"description":"Başarılı yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartSubscriptionNon3DResponse"}}}},"400":{"description":"Başarısız yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir."},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string"},"description":"İstek içeriğinin formatı."}},"schemas":{"StartSubscriptionNon3DRequest":{"type":"object","required":["pricingPlanReferenceCode","customer","paymentCard","subscriptionInitialStatus"],"properties":{"pricingPlanReferenceCode":{"type":"string","description":"Aboneliğin başlatılacağı planın referans kodu."},"conversationId":{"type":"string","description":"İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi yapmak için kullanılabilir."},"subscriptionInitialStatus":{"type":"string","enum":["ACTIVE","PENDING"],"description":"Abonelik başlangıç durumu. PENDING gönderilirse abonelik başlamaz ve tekrar aktif edilmesi gerekir."},"customer":{"$ref":"#/components/schemas/SubscriptionCustomer"},"paymentCard":{"description":"Kart bilgileri.","$ref":"#/components/schemas/PaymentCard"}}},"SubscriptionCustomer":{"description":"Alıcı Bilgileri","type":"object","required":["name","surname","email","gsmNumber","identityNumber","billingAddress"],"properties":{"name":{"type":"string","description":"Kullanıcı Adı."},"surname":{"type":"string","description":"Kullanıcı Soyadı."},"email":{"type":"string","description":"Kullanıcı Email Bilgisi."},"gsmNumber":{"type":"string","description":"GSM Numarası. +90'lı bir numara kullanılmalıdır."},"identityNumber":{"type":"string","description":"TCKN Bilgisi"},"billingAddress":{"$ref":"#/components/schemas/SubscriptionBillingAddress"},"shippingAddress":{"$ref":"#/components/schemas/SubscriptionShippingAddress"}}},"SubscriptionBillingAddress":{"type":"object","description":"Fatura Bilgileri","required":["address","contactName","city","country"],"properties":{"address":{"description":"Fatura Adresi","type":"string"},"zipCode":{"type":"string","description":"Zip Kodu."},"contactName":{"description":"İletişim kuralacak isim.","type":"string"},"city":{"description":"Şehir","type":"string"},"country":{"description":"Ülke","type":"string"}}},"SubscriptionShippingAddress":{"type":"object","description":"Kargo Adres Bilgileri","required":false,"properties":{"address":{"description":"Fatura Adresi","type":"string"},"zipCode":{"type":"string","description":"Zip Kodu."},"contactName":{"description":"İletişim kuralacak isim.","type":"string"},"city":{"description":"Şehir","type":"string"},"country":{"description":"Ülke","type":"string"}}},"PaymentCard":{"type":"object","required":["cardHolderName","cardNumber","expireMonth","expireYear","cvc"],"properties":{"cardHolderName":{"description":"Kart Sahibi Adı.","type":"string"},"cardNumber":{"description":"Kart Numarası","type":"string"},"expireMonth":{"description":"Geçerlilik Tarihi (AY)","type":"string"},"expireYear":{"description":"Geçerlilik Tarihi (YIL)","type":"string"},"cvc":{"description":"CVC/CVV Bilgisi","type":"string"}}},"StartSubscriptionNon3DResponse":{"type":"object","properties":{"status":{"description":"Yapılan isteğin sonucunu belirtir. İşlem başarılı ise success değeri döner.","type":"string","enum":["success","failure"]},"systemTime":{"description":"Dönen sonucun o anki unix timestamp değeridir.","type":"integer"},"data":{"type":"object","properties":{"referenceCode":{"type":"string","description":"Oluşturulan aboneliğin referans kodu."},"parentReferenceCode":{"type":"string","description":"Abonelik güncellemelerinde üye işeyerinin eşleştirme yapılabileceği eşsiz referans kodu."},"customerReferenceCode":{"type":"string","description":"Müşteri bilgilerine istinaden oluşturulmuş eşsiz müşteri kodu. Bu kod email ve gsmNumber adresi baz alınarak oluşturulur ve müşteri işlemleri bu kod ile de yapılabilir."},"subscriptionStatus":{"type":"string","description":"Abonelik durumu","enum":["ACTIVE","PENDING"]},"pricingPlanReferenceCode":{"type":"string"},"trialDays":{"type":"integer","description":"Ödeme planında belirlenen deneme süresidir. Bu süreç boyunca karttan ödeme alınmaz."},"trialStartDate":{"type":"integer","description":"Deneme süresinin başlangıç tarihini gösteren unix timestamp değeridir."},"trialEndDate":{"type":"integer","description":"Deneme süresinin bitiş tarihini gösteren unix timestamp değeridir."},"createdDate":{"type":"integer","description":"Abonelik oluşturulma tarihinin unix timestamp değeridir."},"startDate":{"type":"integer","description":"Abonelik başlangıç tarihinin unix timestamp değeridir."},"endDate":{"type":"integer","description":"Abonelik bitiş tarihinin unix timestamp değeridir."}}}}},"ErrorResponse":{"type":"object","properties":{"status":{"description":"İstek sonucunu ifade eder.","type":"string","enum":["failure"]},"errorCode":{"description":"Error Kod","type":"string"},"errorMessage":{"description":"Error Mesajı","type":"string"},"systemTime":{"description":"Dönen sonucun o anki unix timestamp değeridir.","type":"integer"}}}}}}
```

## Abonelik Başlatma (iyzico Ödeme Formu)

> iyzico Ödeme formu (Checkout Form) ile abonelik başlatmak için kullanılır. Ödeme formuna ait content ve token değeri döner.

```json
{"openapi":"3.0.3","info":{"title":"Subscription - Abonelik Başlatma","version":"1.0.0"},"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/v2/subscription/checkoutform/initialize":{"post":{"summary":"Abonelik Başlatma (iyzico Ödeme Formu)","description":"iyzico Ödeme formu (Checkout Form) ile abonelik başlatmak için kullanılır. Ödeme formuna ait content ve token değeri döner.","tags":["Abonelik"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartSubscriptionCheckoutFormInitializeRequest"}}}},"responses":{"200":{"description":"Başarılı yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartSubscriptionCheckoutFormInitializeResponse"}}}},"400":{"description":"Başarısız yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir."},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string"},"description":"İstek içeriğinin formatı."}},"schemas":{"StartSubscriptionCheckoutFormInitializeRequest":{"type":"object","required":["callbackUrl","pricingPlanReferenceCode","subscriptionInitialStatus","customer"],"properties":{"locale":{"type":"string","description":"Dil kodu. Varsayılan; tr. Ödeme formunun İngilizce oluşturulması için \"en\" gönderilmelidir.","enum":["tr","en"]},"callbackUrl":{"type":"string","description":"Ödeme sonucunun gönderileceği callback adresi."},"pricingPlanReferenceCode":{"type":"string","description":"Aboneliğin başlatılacağı planın referans kodu."},"subscriptionInitialStatus":{"type":"string","enum":["ACTIVE","PENDING"],"description":"Abonelik başlangıç durumu. PENDING gönderilirse abonelik başlamaz ve tekrar aktif edilmesi gerekir."},"conversationId":{"type":"string","description":"İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi yapmak için kullanılabilir."},"customer":{"$ref":"#/components/schemas/SubscriptionCustomer"}}},"SubscriptionCustomer":{"description":"Alıcı Bilgileri","type":"object","required":["name","surname","email","gsmNumber","identityNumber","billingAddress"],"properties":{"name":{"type":"string","description":"Kullanıcı Adı."},"surname":{"type":"string","description":"Kullanıcı Soyadı."},"email":{"type":"string","description":"Kullanıcı Email Bilgisi."},"gsmNumber":{"type":"string","description":"GSM Numarası. +90'lı bir numara kullanılmalıdır."},"identityNumber":{"type":"string","description":"TCKN Bilgisi"},"billingAddress":{"$ref":"#/components/schemas/SubscriptionBillingAddress"},"shippingAddress":{"$ref":"#/components/schemas/SubscriptionShippingAddress"}}},"SubscriptionBillingAddress":{"type":"object","description":"Fatura Bilgileri","required":["address","contactName","city","country"],"properties":{"address":{"description":"Fatura Adresi","type":"string"},"zipCode":{"type":"string","description":"Zip Kodu."},"contactName":{"description":"İletişim kuralacak isim.","type":"string"},"city":{"description":"Şehir","type":"string"},"country":{"description":"Ülke","type":"string"}}},"SubscriptionShippingAddress":{"type":"object","description":"Kargo Adres Bilgileri","required":false,"properties":{"address":{"description":"Fatura Adresi","type":"string"},"zipCode":{"type":"string","description":"Zip Kodu."},"contactName":{"description":"İletişim kuralacak isim.","type":"string"},"city":{"description":"Şehir","type":"string"},"country":{"description":"Ülke","type":"string"}}},"StartSubscriptionCheckoutFormInitializeResponse":{"type":"object","properties":{"status":{"type":"string","enum":["success","failure"],"description":"İşlem sonucu."},"locale":{"type":"string","enum":["tr","en"],"description":"Yanıt dili."},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."},"conversationId":{"description":"İstek sırasında gönderilen değer aynen geri döner.","type":"string"},"token":{"type":"string","description":"Ödeme formuna ait token değeri."},"checkoutFormContent":{"type":"string","description":"Ödeme formuna ait htmlContent değeri."},"tokenExpireTime":{"type":"integer","description":"Token geçerlilik süresi (saniye)."}}},"ErrorResponse":{"type":"object","properties":{"status":{"description":"İstek sonucunu ifade eder.","type":"string","enum":["failure"]},"errorCode":{"description":"Error Kod","type":"string"},"errorMessage":{"description":"Error Mesajı","type":"string"},"systemTime":{"description":"Dönen sonucun o anki unix timestamp değeridir.","type":"integer"}}}}}}
```

## Ödeme Formu Sonucunu Alma

> Checkout form akışı tamamlandıktan sonra ödeme formuna token ile abonelik başlatma sonucunu sorgulanır.

```json
{"openapi":"3.0.3","info":{"title":"Subscription - Abonelik Başlatma","version":"1.0.0"},"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/v2/subscription/checkoutform/{token}":{"get":{"summary":"Ödeme Formu Sonucunu Alma","description":"Checkout form akışı tamamlandıktan sonra ödeme formuna token ile abonelik başlatma sonucunu sorgulanır.","tags":["Abonelik"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"},{"name":"token","in":"path","required":true,"schema":{"type":"string"},"description":"Checkout form initialize ile dönen, ilgili işleme ait token."},{"name":"conversationId","in":"query","required":false,"schema":{"type":"string"},"description":"İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi yapmak için kullanılabilir."}],"responses":{"200":{"description":"Başarılı yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartSubscriptionCheckoutFormResultResponse"}}}},"400":{"description":"Başarısız yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir."},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string"},"description":"İstek içeriğinin formatı."}},"schemas":{"StartSubscriptionCheckoutFormResultResponse":{"type":"object","properties":{"status":{"type":"string","enum":["success","failure"]},"locale":{"type":"string","enum":["tr","en"]},"systemTime":{"description":"Dönen sonucun o anki unix timestamp değeridir.","type":"integer"},"conversationId":{"type":"string","description":"İstek esnasında gönderilen veri aynen geri döner."},"token":{"type":"string","description":"Ödeme formuna ait token değeri."},"data":{"type":"object","properties":{"referenceCode":{"type":"string","description":"Oluşturulan aboneliğin referans kodu."},"parentReferenceCode":{"type":"string","description":"Abonelik güncellemelerinde üye işeyerinin eşleştirme yapılabileceği eşsiz referans kodu."},"customerReferenceCode":{"type":"string","description":"Müşteri bilgilerine istinaden oluşturulmuş eşsiz müşteri kodu. Bu kod email ve gsmNumber adresi baz alınarak oluşturulur ve müşteri işlemleri bu kod ile de yapılabilir."},"subscriptionStatus":{"type":"string","description":"Abonelik durumu","enum":["ACTIVE","PENDING"]},"pricingPlanReferenceCode":{"type":"string"},"trialDays":{"type":"integer","description":"Ödeme planında belirlenen deneme süresidir. Bu süreç boyunca karttan ödeme alınmaz."},"trialStartDate":{"type":"integer","description":"Deneme süresinin başlangıç tarihini gösteren unix timestamp değeridir."},"trialEndDate":{"type":"integer","description":"Deneme süresinin bitiş tarihini gösteren unix timestamp değeridir."},"createdDate":{"type":"integer","description":"Abonelik oluşturulma tarihinin unix timestamp değeridir."},"startDate":{"type":"integer","description":"Abonelik başlangıç tarihinin unix timestamp değeridir."},"endDate":{"type":"integer","description":"Abonelik bitiş tarihinin unix timestamp değeridir."}}}}},"ErrorResponse":{"type":"object","properties":{"status":{"description":"İstek sonucunu ifade eder.","type":"string","enum":["failure"]},"errorCode":{"description":"Error Kod","type":"string"},"errorMessage":{"description":"Error Mesajı","type":"string"},"systemTime":{"description":"Dönen sonucun o anki unix timestamp değeridir.","type":"integer"}}}}}}
```

## Abonelik Başlatma (Existing Customer)

> Abonelik başlatılmak istenen kullanıcının hali hazırda aktif bir aboneliği bulunuyorsa, customerReferenceCode ile yeni bir abonelik başlatılabilir. Eğer kullanıcının aktif bir aboneliği bulunmuyorsa custormerReferenceCode ile yeni bir abonelik başlatılmamaktadır.<br>

```json
{"openapi":"3.0.3","info":{"title":"Subscription - Abonelik Başlatma","version":"1.0.0"},"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/v2/subscription/initialize/with-customer":{"post":{"summary":"Abonelik Başlatma (Existing Customer)","description":"Abonelik başlatılmak istenen kullanıcının hali hazırda aktif bir aboneliği bulunuyorsa, customerReferenceCode ile yeni bir abonelik başlatılabilir. Eğer kullanıcının aktif bir aboneliği bulunmuyorsa custormerReferenceCode ile yeni bir abonelik başlatılmamaktadır.\n","tags":["Abonelik"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartSubscriptionWithCustomerRequest"}}}},"responses":{"200":{"description":"Başarılı yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartSubscriptionWithCustomerResponse"}}}},"400":{"description":"Başarısız yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir."},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string"},"description":"İstek içeriğinin formatı."}},"schemas":{"StartSubscriptionWithCustomerRequest":{"type":"object","required":["subscriptionInitialStatus","pricingPlanReferenceCode","customerReferenceCode"],"properties":{"subscriptionInitialStatus":{"type":"string","enum":["ACTIVE","PENDING"],"description":"Abonelik başlangıç durumu. PENDING gönderilirse abonelik başlamaz ve tekrar aktif edilmesi gerekir."},"pricingPlanReferenceCode":{"type":"string","description":"Aboneliğin başlatılacağı planın referans kodu."},"customerReferenceCode":{"type":"string","description":"Mevcut müşterinin referans kodu. Aktif bir aboneliği olmalıdır."}}},"StartSubscriptionWithCustomerResponse":{"type":"object","properties":{"status":{"type":"string","enum":["success","failure"],"description":"İşlem sonucu."},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."},"data":{"type":"object","properties":{"referenceCode":{"type":"string","description":"Oluşturulan aboneliğin referans kodu."},"parentReferenceCode":{"type":"string","description":"Abonelik güncellemelerinde üye işyerinin eşleştirme yapabileceği referans kodu."},"pricingPlanReferenceCode":{"type":"string","description":"Oluşturulan aboneliğe bağlı ödeme planının referans kodu."},"customerReferenceCode":{"type":"string","description":"İlgili kullanıcıya ait referans kodu."},"subscriptionStatus":{"type":"string","enum":["ACTIVE","PENDING"],"description":"Abonelik durumu."},"trialDays":{"type":"integer","description":"Planın deneme süresi (gün)."},"trialStartDate":{"type":"integer","description":"Deneme başlangıç zamanı (epoch ms)."},"trialEndDate":{"type":"integer","description":"Deneme bitiş zamanı (epoch ms)."},"createdDate":{"type":"integer","description":"Abonelik oluşturulma zamanı (epoch ms)."},"startDate":{"type":"integer","description":"Abonelik başlangıç zamanı (epoch ms)."},"endDate":{"type":"integer","description":"Abonelik bitiş zamanı (epoch ms)."}}}}},"ErrorResponse":{"type":"object","properties":{"status":{"description":"İstek sonucunu ifade eder.","type":"string","enum":["failure"]},"errorCode":{"description":"Error Kod","type":"string"},"errorMessage":{"description":"Error Mesajı","type":"string"},"systemTime":{"description":"Dönen sonucun o anki unix timestamp değeridir.","type":"integer"}}}}}}
```