# Ürün

## Ürün Oluşturma

> Yeni bir abonelik ürünü oluşturur. 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.

```json
{"openapi":"3.0.3","info":{"title":"Subscription Product","version":"1.0.0"},"tags":[{"name":"Subscription Product","description":"Abonelik ürün yönetimi servisleri."}],"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/v2/subscription/products":{"post":{"summary":"Ürün Oluşturma","operationId":"createSubscriptionProduct","description":"Yeni bir abonelik ürünü oluşturur. 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.","tags":["Subscription Product"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionProductCreateRequest"}}}},"responses":{"200":{"description":"Başarılı yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionProductCreateSuccess"}}}},"400":{"description":"Hatalı istek","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.","schema":{"type":"string"}},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"description":"İstek gövdesinin içerik tipi.","schema":{"type":"string"}}},"schemas":{"SubscriptionProductCreateRequest":{"type":"object","properties":{"locale":{"type":"string","description":"iyzico yanıt metinlerinin dili. Varsayılan **tr**; **en** desteklenir."},"conversationId":{"type":"string","description":"İstek/yanıt eşleşmesi için kullanılabilecek referans değeri."},"name":{"type":"string","description":"Ürün adı."},"description":{"type":"string","description":"Ürün açıklaması."}},"required":["name"]},"SubscriptionProductCreateSuccess":{"type":"object","properties":{"status":{"type":"string","description":"İşlem sonucu.","enum":["success","failure"]},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."},"data":{"$ref":"#/components/schemas/ProductResource"}}},"ProductResource":{"type":"object","description":"Ürün detayları.","properties":{"referenceCode":{"type":"string","description":"Ürüne ait eşsiz referans kodu."},"createdDate":{"type":"string","description":"Ürün oluşturulma tarihi (`YYYY-MM-DD hh:mm:ss`)."},"name":{"type":"string","description":"Ürün adı."},"description":{"type":"string","description":"Ürün açıklaması."},"status":{"type":"string","description":"Ürün durumu (varsayılan ACTIVE)."},"pricingPlans":{"type":"array","description":"Ürüne bağlı planlar listesi.","items":{"$ref":"#/components/schemas/PricingPlanBrief"}}}},"PricingPlanBrief":{"type":"object","description":"Ürüne bağlı plan bilgisinin özet görünümü.","properties":{"referenceCode":{"type":"string","description":"Planın eşsiz referans kodu."},"createdDate":{"type":"string","description":"Plan oluşturulma tarihi (`YYYY-MM-DD hh:mm:ss`)."},"name":{"type":"string","description":"Plan adı."},"price":{"type":"number","format":"decimal","description":"Plan ücreti (Decimal)."},"paymentInterval":{"type":"string","enum":["WEEKLY","MONTHLY","DAILY","YEARLY"],"description":"Ödeme sıklığı."},"paymentIntervalCount":{"type":"integer","description":"Ödeme aralığının tekrar sayısı."},"trialPeriodDays":{"type":"integer","description":"Deneme süresi (gün)."},"currencyCode":{"type":"string","description":"Para birimi (örn. TRY)."},"productReferenceCode":{"type":"string","description":"Planın bağlı olduğu ürün referans kodu."},"planPaymentType":{"type":"string","description":"Plan ödeme tipi (RECURRING)."},"status":{"type":"string","description":"Planın durumu (örn. ACTIVE)."},"recurrenceCount":{"type":"integer","description":"Planın toplam tekrar sayısı (varsa)."}}},"ErrorResponse":{"type":"object","properties":{"status":{"type":"string","description":"İşlem sonucu.","enum":["success","failure"]},"errorCode":{"type":"string","description":"Hata kodu."},"errorMessage":{"type":"string","description":"Hata mesajı."},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."}}}}}}
```

## Ürün Güncelleme

> Abonelik ürününü günceller. Bir ürünün isim ve açıklama bilgileri hem API hem de iyzico merchant paneli üzerinden düzenlenebilir. API üzerinden bu işlemi yapabilmek için, ürüne ait eşsiz referans kodu kullanılmalıdır.

```json
{"openapi":"3.0.3","info":{"title":"Subscription Product","version":"1.0.0"},"tags":[{"name":"Subscription Product","description":"Abonelik ürün yönetimi servisleri."}],"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/v2/subscription/products/{productReferenceCode}":{"post":{"summary":"Ürün Güncelleme","operationId":"updateSubscriptionProduct","description":"Abonelik ürününü günceller. Bir ürünün isim ve açıklama bilgileri hem API hem de iyzico merchant paneli üzerinden düzenlenebilir. API üzerinden bu işlemi yapabilmek için, ürüne ait eşsiz referans kodu kullanılmalıdır.","tags":["Subscription Product"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"},{"name":"productReferenceCode","in":"path","required":true,"schema":{"type":"string"},"description":"Ürüne ait eşsiz referans kodu."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionProductUpdateRequest"}}}},"responses":{"200":{"description":"Başarılı yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionProductGetSuccess"}}}},"400":{"description":"Hatalı istek","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.","schema":{"type":"string"}},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"description":"İstek gövdesinin içerik tipi.","schema":{"type":"string"}}},"schemas":{"SubscriptionProductUpdateRequest":{"type":"object","properties":{"locale":{"type":"string","description":"Yanıt dili (**tr**/**en**)."},"conversationId":{"type":"string","description":"İstek/yanıt eşleştirme değeri."},"name":{"type":"string","description":"Ürüne verilecek yeni isim."},"description":{"type":"string","description":"Ürüne verilecek yeni açıklama."}},"required":["name"]},"SubscriptionProductGetSuccess":{"type":"object","properties":{"status":{"type":"string","description":"İşlem sonucu.","enum":["success","failure"]},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."},"data":{"$ref":"#/components/schemas/ProductResource"}}},"ProductResource":{"type":"object","description":"Ürün detayları.","properties":{"referenceCode":{"type":"string","description":"Ürüne ait eşsiz referans kodu."},"createdDate":{"type":"string","description":"Ürün oluşturulma tarihi (`YYYY-MM-DD hh:mm:ss`)."},"name":{"type":"string","description":"Ürün adı."},"description":{"type":"string","description":"Ürün açıklaması."},"status":{"type":"string","description":"Ürün durumu (varsayılan ACTIVE)."},"pricingPlans":{"type":"array","description":"Ürüne bağlı planlar listesi.","items":{"$ref":"#/components/schemas/PricingPlanBrief"}}}},"PricingPlanBrief":{"type":"object","description":"Ürüne bağlı plan bilgisinin özet görünümü.","properties":{"referenceCode":{"type":"string","description":"Planın eşsiz referans kodu."},"createdDate":{"type":"string","description":"Plan oluşturulma tarihi (`YYYY-MM-DD hh:mm:ss`)."},"name":{"type":"string","description":"Plan adı."},"price":{"type":"number","format":"decimal","description":"Plan ücreti (Decimal)."},"paymentInterval":{"type":"string","enum":["WEEKLY","MONTHLY","DAILY","YEARLY"],"description":"Ödeme sıklığı."},"paymentIntervalCount":{"type":"integer","description":"Ödeme aralığının tekrar sayısı."},"trialPeriodDays":{"type":"integer","description":"Deneme süresi (gün)."},"currencyCode":{"type":"string","description":"Para birimi (örn. TRY)."},"productReferenceCode":{"type":"string","description":"Planın bağlı olduğu ürün referans kodu."},"planPaymentType":{"type":"string","description":"Plan ödeme tipi (RECURRING)."},"status":{"type":"string","description":"Planın durumu (örn. ACTIVE)."},"recurrenceCount":{"type":"integer","description":"Planın toplam tekrar sayısı (varsa)."}}},"ErrorResponse":{"type":"object","properties":{"status":{"type":"string","description":"İşlem sonucu.","enum":["success","failure"]},"errorCode":{"type":"string","description":"Hata kodu."},"errorMessage":{"type":"string","description":"Hata mesajı."},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."}}}}}}
```

## Ürün Detayı

> Bir ürünün detaylarına API isteği ile ulaşılabilir. Bunun için gönderilen istekte ürün refereans kodunu belirtmek yeterlidir.

```json
{"openapi":"3.0.3","info":{"title":"Subscription Product","version":"1.0.0"},"tags":[{"name":"Subscription Product","description":"Abonelik ürün yönetimi servisleri."}],"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/v2/subscription/products/{productReferenceCode}":{"get":{"summary":"Ürün Detayı","operationId":"getSubscriptionProduct","description":"Bir ürünün detaylarına API isteği ile ulaşılabilir. Bunun için gönderilen istekte ürün refereans kodunu belirtmek yeterlidir.","tags":["Subscription Product"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"},{"name":"productReferenceCode","in":"path","required":true,"schema":{"type":"string"},"description":"Ürüne ait eşsiz referans kodu."}],"responses":{"200":{"description":"Başarılı yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionProductGetSuccess"}}}},"400":{"description":"Hatalı istek","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.","schema":{"type":"string"}},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"description":"İstek gövdesinin içerik tipi.","schema":{"type":"string"}}},"schemas":{"SubscriptionProductGetSuccess":{"type":"object","properties":{"status":{"type":"string","description":"İşlem sonucu.","enum":["success","failure"]},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."},"data":{"$ref":"#/components/schemas/ProductResource"}}},"ProductResource":{"type":"object","description":"Ürün detayları.","properties":{"referenceCode":{"type":"string","description":"Ürüne ait eşsiz referans kodu."},"createdDate":{"type":"string","description":"Ürün oluşturulma tarihi (`YYYY-MM-DD hh:mm:ss`)."},"name":{"type":"string","description":"Ürün adı."},"description":{"type":"string","description":"Ürün açıklaması."},"status":{"type":"string","description":"Ürün durumu (varsayılan ACTIVE)."},"pricingPlans":{"type":"array","description":"Ürüne bağlı planlar listesi.","items":{"$ref":"#/components/schemas/PricingPlanBrief"}}}},"PricingPlanBrief":{"type":"object","description":"Ürüne bağlı plan bilgisinin özet görünümü.","properties":{"referenceCode":{"type":"string","description":"Planın eşsiz referans kodu."},"createdDate":{"type":"string","description":"Plan oluşturulma tarihi (`YYYY-MM-DD hh:mm:ss`)."},"name":{"type":"string","description":"Plan adı."},"price":{"type":"number","format":"decimal","description":"Plan ücreti (Decimal)."},"paymentInterval":{"type":"string","enum":["WEEKLY","MONTHLY","DAILY","YEARLY"],"description":"Ödeme sıklığı."},"paymentIntervalCount":{"type":"integer","description":"Ödeme aralığının tekrar sayısı."},"trialPeriodDays":{"type":"integer","description":"Deneme süresi (gün)."},"currencyCode":{"type":"string","description":"Para birimi (örn. TRY)."},"productReferenceCode":{"type":"string","description":"Planın bağlı olduğu ürün referans kodu."},"planPaymentType":{"type":"string","description":"Plan ödeme tipi (RECURRING)."},"status":{"type":"string","description":"Planın durumu (örn. ACTIVE)."},"recurrenceCount":{"type":"integer","description":"Planın toplam tekrar sayısı (varsa)."}}},"ErrorResponse":{"type":"object","properties":{"status":{"type":"string","description":"İşlem sonucu.","enum":["success","failure"]},"errorCode":{"type":"string","description":"Hata kodu."},"errorMessage":{"type":"string","description":"Hata mesajı."},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."}}}}}}
```

## Ürün Listeleme

> Abonelik ürünlerini listeler. Ürün listeleme tüm ürünlere ve ürünlere bağlı planlara ulaşmak için kullanılır. Cevap süresini kısaltmak ve cevap boyutunu kısaltmak için sayfalama metodu kullanulmıştır. Bu sayede ürün listesini sayfa sayfa hızlıca alabilirsiniz.

```json
{"openapi":"3.0.3","info":{"title":"Subscription Product","version":"1.0.0"},"tags":[{"name":"Subscription Product","description":"Abonelik ürün yönetimi servisleri."}],"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/v2/subscription/products":{"get":{"summary":"Ürün Listeleme","operationId":"listSubscriptionProducts","description":"Abonelik ürünlerini listeler. Ürün listeleme tüm ürünlere ve ürünlere bağlı planlara ulaşmak için kullanılır. Cevap süresini kısaltmak ve cevap boyutunu kısaltmak için sayfalama metodu kullanulmıştır. Bu sayede ürün listesini sayfa sayfa hızlıca alabilirsiniz.","tags":["Subscription Product"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionProductListRequest"}}}},"responses":{"200":{"description":"Başarılı yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionProductListSuccess"}}}},"400":{"description":"Hatalı istek","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.","schema":{"type":"string"}},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"description":"İstek gövdesinin içerik tipi.","schema":{"type":"string"}}},"schemas":{"SubscriptionProductListRequest":{"type":"object","properties":{"page":{"type":"integer","description":"Belirtilen sayfa için tüm ürünleri getirir."},"count":{"type":"integer","description":"Sayfa başına kaç ürün listeleneceğini belirtir."}}},"SubscriptionProductListSuccess":{"type":"object","properties":{"status":{"type":"string","description":"İşlem sonucu.","enum":["success","failure"]},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."},"data":{"type":"object","description":"Sayfalama sonuçları.","properties":{"totalCount":{"type":"string","description":"Toplam kaç tane sonuç geldiğini belirtir."},"currentPage":{"type":"integer","description":"Hangi sayfa için listeleme yapıldığını belirtir."},"pageCount":{"type":"integer","description":"Toplam kaç sayfa sonuç geldiğini belirtir."},"items":{"type":"array","description":"Ürün listesi.","items":{"$ref":"#/components/schemas/ProductResource"}}}}}},"ProductResource":{"type":"object","description":"Ürün detayları.","properties":{"referenceCode":{"type":"string","description":"Ürüne ait eşsiz referans kodu."},"createdDate":{"type":"string","description":"Ürün oluşturulma tarihi (`YYYY-MM-DD hh:mm:ss`)."},"name":{"type":"string","description":"Ürün adı."},"description":{"type":"string","description":"Ürün açıklaması."},"status":{"type":"string","description":"Ürün durumu (varsayılan ACTIVE)."},"pricingPlans":{"type":"array","description":"Ürüne bağlı planlar listesi.","items":{"$ref":"#/components/schemas/PricingPlanBrief"}}}},"PricingPlanBrief":{"type":"object","description":"Ürüne bağlı plan bilgisinin özet görünümü.","properties":{"referenceCode":{"type":"string","description":"Planın eşsiz referans kodu."},"createdDate":{"type":"string","description":"Plan oluşturulma tarihi (`YYYY-MM-DD hh:mm:ss`)."},"name":{"type":"string","description":"Plan adı."},"price":{"type":"number","format":"decimal","description":"Plan ücreti (Decimal)."},"paymentInterval":{"type":"string","enum":["WEEKLY","MONTHLY","DAILY","YEARLY"],"description":"Ödeme sıklığı."},"paymentIntervalCount":{"type":"integer","description":"Ödeme aralığının tekrar sayısı."},"trialPeriodDays":{"type":"integer","description":"Deneme süresi (gün)."},"currencyCode":{"type":"string","description":"Para birimi (örn. TRY)."},"productReferenceCode":{"type":"string","description":"Planın bağlı olduğu ürün referans kodu."},"planPaymentType":{"type":"string","description":"Plan ödeme tipi (RECURRING)."},"status":{"type":"string","description":"Planın durumu (örn. ACTIVE)."},"recurrenceCount":{"type":"integer","description":"Planın toplam tekrar sayısı (varsa)."}}},"ErrorResponse":{"type":"object","properties":{"status":{"type":"string","description":"İşlem sonucu.","enum":["success","failure"]},"errorCode":{"type":"string","description":"Hata kodu."},"errorMessage":{"type":"string","description":"Hata mesajı."},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."}}}}}}
```

## Ürün Silme

> Abonelik ürününü siler. Ürünler kendilerine bağlı herhangi bir plan olmadıkça hem API hem de iyzico merchant panel üzerinden silinebilir.

```json
{"openapi":"3.0.3","info":{"title":"Subscription Product","version":"1.0.0"},"tags":[{"name":"Subscription Product","description":"Abonelik ürün yönetimi servisleri."}],"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/v2/subscription/products/{productReferenceCode}":{"delete":{"summary":"Ürün Silme","operationId":"deleteSubscriptionProduct","description":"Abonelik ürününü siler. Ürünler kendilerine bağlı herhangi bir plan olmadıkça hem API hem de iyzico merchant panel üzerinden silinebilir.","tags":["Subscription Product"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"},{"name":"productReferenceCode","in":"path","required":true,"schema":{"type":"string"},"description":"Ürüne ait eşsiz referans kodu."}],"responses":{"200":{"description":"Başarılı yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionProductDeleteSuccess"}}}},"400":{"description":"Hatalı istek","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.","schema":{"type":"string"}},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"description":"İstek gövdesinin içerik tipi.","schema":{"type":"string"}}},"schemas":{"SubscriptionProductDeleteSuccess":{"type":"object","properties":{"status":{"type":"string","description":"İşlem sonucu.","enum":["success","failure"]},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."}}},"ErrorResponse":{"type":"object","properties":{"status":{"type":"string","description":"İşlem sonucu.","enum":["success","failure"]},"errorCode":{"type":"string","description":"Hata kodu."},"errorMessage":{"type":"string","description":"Hata mesajı."},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."}}}}}}
```