iyzico Link API

iyzilink API içerisinde yer alan servisler aşağıda listelenmiştir.

1. iyzico Link Oluşturma

2. Fastlink Oluşturma

3. iyzico Link Detayı

4. iyzico Link Listeleme

5. iyzico Link Güncelleme

6. iyzico Link Durum Güncelleme

7. iyzico Link Silme

iyzico Link Oluşturma

post

Yeni bir iyzico Link oluşturmak için kullanılır. Başarılı yanıtta link url'sini döner. Dönen url parametresini müşterilerinize ileterek kullanabilirsiniz.

Header parameters

AuthorizationstringRequired

IYZWSv2 ile başlayan imza değeri (Base64). Örn: IYZWSv2 YXBpS2V5On...

Example: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=

Content-Typestring · enumRequired

İstek gövdesi formatı.

Example: application/jsonPossible values:

Body

application/json

conversationIdstringOptional

İstek/yanıt eşleştirme için gönderilen değer.

Example: 123456

localestringOptional

Yanıt dili (tr|en). Varsayılan tr.

Example: tr

namestringRequired

Ürünün adı (müşteriye görünür).

Example: Örnek Ürün

descriptionstringRequired

Ürünün açıklaması (müşteriye görünür).

Example: 10 Adet Kitap

pricestring · decimalRequired

Ürün fiyatı (decimal).

Example: 50.00

currencyCodestring · enumRequired

Para birimi kodu.

Example: TRYPossible values:

encodedImageFilestringRequired

Ürün resminin base64'e çevrilmiş hali.

Example: a/9j/4AAQSkZJRgABAgAAZABkAAD/7AARRHVja3k...

addressIgnorablebooleanOptional

Satın alımda adres istenmesin (true) / istensin (false).

Example: true

installmentRequestedboolean · enumOptional

Taksitli satış aktif/pasif.

Example: falsePossible values:

stockEnabledboolean · enumOptional

Stok kontrolü aktif/pasif.

Example: truePossible values:

stockCountintegerOptional

Stok sayısı.

Example: 25,

flexibleLinkboolean · enumOptional

Üye işyerinin belirlediği 3 farklı tutardan birinin seçilerek veya müşterinin kendi girdiği tutar ile ödemenin tamamlamalarına olanak sağlamaktadır. Üye işyeri hesabında bu özelliğin aktif olması gerekmektedir.

Example: truePossible values:

presetPriceValuesinteger · enumOptional

FlexibleLink'te gösterilecek tutarların bilgisi.

Example: 10Possible values:

categoryTypestring · enumOptional

Ürün kategori tipi. Default; "UNKNOWN" değerini alır.

Example: PHONEPossible values:

Responses

200

Başarılı oluşturma yanıtı.

application/json

post

/v2/iyzilink/products

HTTP

POST /v2/iyzilink/products
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

{
  "conversationId": "123456",
  "locale": "tr",
  "name": "Örnek Ürün",
  "description": "10 Adet Kitap",
  "price": "50.00",
  "currencyCode": "TRY",
  "encodedImageFile": "/9j/4AAQSkZJRgABAQEAYABgAAD...",
  "addressIgnorable": true,
  "installmentRequested": false,
  "stockEnabled": true,
  "stockCount": 25,
  "flexibleLink": true,
  "presetPriceValues": [10.00, 20.00],
  "categoryType": "UNKNOWN"
}

200

Başarılı oluşturma yanıtı.

{
  "status": "success",
  "locale": "tr",
  "systemTime": 1687827915258,
  "conversationId": "123456",
  "data": {
    "token": "WxI",
    "url": "https://sandbox.iyzi.link/WxI",
    "imageUrl": "https://sandbox-img.iyzi.link/Wx/I.jpg"
  }
}

Örnek Kodlar

PHP

Java

.NET

Python

Postman

Fastlink Oluşturma

post

Fastlink Oluşturur. Fast Link, 750 TL ve altı ödemeler için hızlı ve kolay bir şekilde ödeme alınmasını sağlayan çözümdür. Bir linkten yalnızca bir kere ödeme alınabilmektedir. Fastlink oluşturmak için önce onaylı bi iyzico link olması gerekmektedir.

Header parameters

AuthorizationstringRequired

IYZWSv2 ile başlayan imza değeri (Base64). Örn: IYZWSv2 YXBpS2V5On...

Example: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=

Content-Typestring · enumRequired

İstek gövdesi formatı.

Example: application/jsonPossible values:

Body

application/json

conversationIdstringOptional

İstek/yanıt eşleştirme için gönderilen değer.

Example: 123456

localestring · enumOptional

Yanıt dili (tr|en). Varsayılan tr.

Example: trPossible values:

descriptionstringOptional

Müşteriye görünecek link açıklaması.

Example: 10 Adet Kitap

pricestring · decimalRequired

Ürün fiyatı.

Example: 75.00

currencyCodestringRequired

Para birimi kodu.

Example: TRY

Responses

200

Başarılı oluşturma yanıtı.

application/json

post

/v2/iyzilink/fast-link/products

HTTP

POST /v2/iyzilink/fast-link/products
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

{
  "conversationId": "123456",
  "locale": "tr",
  "description": "10 Adet Kitap",
  "price": "75.00",
  "currencyCode": "TRY"
}

200

Başarılı oluşturma yanıtı.

{
  "status": "success",
  "locale": "tr",
  "systemTime": 1687827915258,
  "conversationId": "123456",
  "data": {
    "token": "WxI",
    "url": "https://sandbox.iyzi.link/WxI",
    "imageUrl": "https://sandbox-img.iyzi.link/Wx/I.jpg"
  }
}

Örnek Kodlar

PHP

Postman

iyzico Link Sorgulama

get

Token ile tek bir link sorgulayabilirsiniz. Sorgulanan token'a ait iyzico Link detayını döner.

Path parameters

tokenstringRequired

Sorgulanmak istenen iyzico Link'e ait token değeri.

Example: WxI

Query parameters

localestringOptional

Yanıt dili (varsayılan tr).

Example: tr

conversationIdstringOptional

İstek/yanıt eşleştirme değeri.

Example: 123456

Header parameters

AuthorizationstringRequired

IYZWSv2 ile başlayan imza değeri (Base64). Örn: IYZWSv2 YXBpS2V5On...

Example: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=

Content-Typestring · enumRequired

İstek gövdesi formatı.

Example: application/jsonPossible values:

Responses

200

Ürün detay yanıtı.

application/json

get

/v2/iyzilink/products/{token}

HTTP

GET /v2/iyzilink/products/WxI?locale=tr&conversationId=123456
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

200

Ürün detay yanıtı.

{
  "status": "success",
  "locale": "tr",
  "systemTime": 1687827915258,
  "conversationId": "123456",
  "data": {
    "name": "sample-name",
    "conversationId": "1123456789",
    "description": "10 Adet Kitap",
    "price": "50.00000000",
    "currencyId": 3,
    "currencyCode": "USD",
    "token": "Wx0",
    "productType": "IYZILINK",
    "productStatus": "ACTIVE",
    "merchantId": 376927,
    "url": "https://sandbox.iyzi.link/Wx0",
    "imageUrl": "https://sandbox-img.iyzi.link/Wx/0.jpg",
    "addressIgnorable": false,
    "soldCount": 0,
    "installmentRequested": false,
    "stockEnabled": false,
    "stockCount": 0,
    "presetPriceValues": [
      "50.00",
      "75.00",
      "100.00"
    ],
    "flexibleLink": false,
    "categoryType": "PHONE"
  }
}

Örnek Kodlar

PHP

Java

.NET

Python

Postman

iyzico Linkleri Listeleme

get

Oluşturulan tüm iyzico Linkleri sayfalı olarak listeler.

Query parameters

localestringOptional

Yanıt dili.

Example: tr

pageinteger · min: 1Optional

Sayfa numarası.

Example: 1

countinteger · min: 1 · max: 100Optional

Sayfa başına ürün sayısı.

Example: 10

conversationIdstringOptional

İstek/yanıt eşleştirme için serbest metin alanı.

Example: test

Header parameters

AuthorizationstringRequired

IYZWSv2 ile başlayan imza değeri (Base64). Örn: IYZWSv2 YXBpS2V5On...

Example: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=

Content-Typestring · enumRequired

İstek gövdesi formatı.

Example: application/jsonPossible values:

Responses

200

Listeleme yanıtı.

application/json

get

/v2/iyzilink/products

HTTP

GET /v2/iyzilink/products?locale=tr&page=1&count=10&conversationId=test
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

200

Listeleme yanıtı.

{
  "status": "success",
  "locale": "tr",
  "systemTime": 1756284905529,
  "conversationId": "123456789",
  "data": {
    "listingReviewed": true,
    "totalCount": 11,
    "currentPage": 1,
    "pageCount": 11,
    "items": [
      {
        "name": "link",
        "conversationId": "conversationId",
        "description": "description",
        "price": "80.00000000",
        "currencyId": 1,
        "currencyCode": "TRY",
        "token": "AAF9Bw",
        "productType": "IYZILINK",
        "productStatus": "ACTIVE",
        "merchantId": 3410007,
        "url": "https://sandbox.iyzi.link/AAF9Bw",
        "imageUrl": "https://sandbox-img.iyzi.link/AA/F9Bw+V3.jpg",
        "addressIgnorable": true,
        "soldCount": 1,
        "installmentRequested": false,
        "stockEnabled": true,
        "stockCount": 3,
        "presetPriceValues": [],
        "flexibleLink": false,
        "categoryType": "UNKNOWN"
      }
    ]
  }
}

Örnek Kodlar

PHP

Java

.NET

Python

Postman

iyzico Link Güncelleme

put

iyzico Link oluşturduğunuzda dönen token değeri ile varolan iyzico Linkinizi güncelleyebilirsiniz.

Path parameters

tokenstringRequired

Güncellenecek iyzilink’in token değeri.

Example: WxI

Header parameters

AuthorizationstringRequired

IYZWSv2 ile başlayan imza değeri (Base64). Örn: IYZWSv2 YXBpS2V5On...

Example: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=

Content-Typestring · enumRequired

İstek gövdesi formatı.

Example: application/jsonPossible values:

Body

application/json

Link güncelleme için gönderilebilecek alanlar (token path’te gönderilir).

conversationIdstringOptional

İstek/yanıt eşleştirmesi için gönderilen değer.

Example: 123456

localestringOptional

Yanıt dili (tr|en).

Example: tr

namestringRequired

Ürün adı.

Example: Güncellenmiş Ürün

descriptionstringRequired

Ürün açıklaması.

Example: 10 Adet Kitap

pricestring · decimalRequired

Ürün fiyatı.

Example: 60.00

currencyCodestringRequired

Para birimi kodu.

Example: TRY

encodedImageFilestringOptional

Ürün resminin base64’e çevrilmiş hali.

Example: a/9j/4AAQSkZJRgABAgAAZABkAAD/7AARRHVja3k...

addressIgnorableboolean · enumOptional

Adres istenmesin/istensin.

Example: falsePossible values:

installmentRequestedboolean · enumOptional

Taksitli satış aktif/pasif.

Example: truePossible values:

stockEnabledboolean · enumOptional

Stok kontrolü aktif/pasif.

Example: truePossible values:

stockCountintegerOptional

Stok sayısı.

Example: 12

categoryTypestring · enumOptional

Ürün kategori tipi. Default; "UNKNOWN" değerini alır.

Example: PHONEPossible values:

Responses

200

Başarılı güncelleme yanıtı.

application/json

put

/v2/iyzilink/products/{token}

HTTP

PUT /v2/iyzilink/products/WxI
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

{
  "conversationId": "123456",
  "name": "Güncellenmiş Ürün",
  "description": "10 Adet Kitap",
  "price": "60.00",
  "currencyCode": "TRY",
  "encodedImageFile": "/9j/4AAQSkZJRgABAQEAYABgAAD...",
  "addressIgnorable": false,
  "installmentRequested": true,
  "stockEnabled": true,
  "stockCount": 12
}

200

Başarılı güncelleme yanıtı.

{
  "status": "success",
  "locale": "tr",
  "systemTime": 1687827915258,
  "conversationId": "123456",
  "data": {
    "token": "WxI",
    "url": "https://sandbox.iyzi.link/WxI",
    "imageUrl": "https://sandbox-img.iyzi.link/Wx/I.jpg"
  }
}

Örnek Kodlar

PHP

Java

.NET

Python

Postman

iyzico Link Statü Güncelleme

patch

Bir iyzico link’in durumunu ACTIVE veya PASSIVE yapar. iyzico Link'e ait token değeri ve güncellenecek statü değerinin kullanılması gerekmektedir.

Path parameters

tokenstringRequired

iyzico link'e ait token değeri.

Example: WxI

statusstring · enumRequired

Güncellenecek yeni durum.

Example: PASSIVEPossible values:

Query parameters

localestringOptional

Yanıt dili (varsayılan tr).

Example: tr

conversationIdstringOptional

İstek/yanıt eşleştirme değeri.

Example: 123456

Header parameters

AuthorizationstringRequired

IYZWSv2 ile başlayan imza değeri (Base64). Örn: IYZWSv2 YXBpS2V5On...

Example: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=

Content-Typestring · enumRequired

İstek gövdesi formatı.

Example: application/jsonPossible values:

Responses

200

Durum güncelleme sonucu.

application/json

patch

/v2/iyzilink/products/{token}/status/{status}

HTTP

PATCH /v2/iyzilink/products/WxI/status/PASSIVE?locale=tr&conversationId=123456
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

200

Durum güncelleme sonucu.

{
  "status": "success",
  "locale": "tr",
  "systemTime": 1687827915258,
  "conversationId": "123456"
}

Örnek Kodlar

PHP

Postman

iyzico Link Silme

delete

Bir iyzico Link'i silmek için kullanılır.

Path parameters

tokenstringRequired

Silinecek iyzico link token’ı.

Example: WxI

Query parameters

localestringOptional

Yanıt dili (varsayılan tr).

Example: tr

conversationIdstringOptional

İstek/yanıt eşleştirme değeri.

Example: 123456

Header parameters

AuthorizationstringRequired

IYZWSv2 ile başlayan imza değeri (Base64). Örn: IYZWSv2 YXBpS2V5On...

Example: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=

Content-Typestring · enumRequired

İstek gövdesi formatı.

Example: application/jsonPossible values:

Responses

200

Silme sonucu.

application/json

delete

/v2/iyzilink/products/{token}

HTTP

DELETE /v2/iyzilink/products/WxI?locale=tr&conversationId=123456
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

200

Silme sonucu.

{
  "status": "success",
  "systemTime": 1687825929316,
  "locale": "tr",
  "conversationId": "123456"
}

Örnek Kodlar

PHP

Java

.NET

Python

Postman