GitHubFeedback FormAPI Reference - Beta

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 ürünü oluşturur. 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
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
Responses
200

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

application/json
Responseall of
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
}
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
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
descriptionstringOptional

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

Example: 10 Adet Kitap
pricestring · decimalRequired

Ürün fiyatı (decimal).

Example: 75.00
currencyCodestringRequired

Para birimi kodu.

Example: TRY
Responses
200

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

application/json
Responseall of
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 iyzilink ürününün detayını döner.

Path parameters
tokenstringRequired

iyzilink ürününün benzersiz anahtarı.

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
Responseall of
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": "UNKNOWN"
  }
}

Örnek Kodlar

PHP

Java

.NET

Python

Postman

iyzico Linkleri Listeleme

get

iyzilink ürünlerini sayfalı olarak listeler.

Query parameters
localestringOptional

Yanıt dili (varsayılan tr).

Example: tr
pageinteger · min: 1Optional

Sayfa numarası (1..N).

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
Responseall of
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

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

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ı (decimal).

Example: 60.00
currencyCodestringRequired

Para birimi kodu.

Example: TRY
encodedImageFilestringOptional

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

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

Adres istenmesin/istensin.

Example: false
installmentRequestedbooleanOptional

Taksitli satış aktif/pasif.

Example: true
stockEnabledbooleanOptional

Stok kontrolü aktif/pasif.

Example: true
stockCountintegerOptional

Stok sayısı.

Example: 12
Responses
200

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

application/json
Responseall of
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 iyzilink’in durumunu ACTIVE veya PASSIVE yapar.

Path parameters
tokenstringRequired

iyzilink token’ı.

Example: WxI
statusstring · enumRequired

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

Token ile belirli bir iyzilink’i siler.

Path parameters
tokenstringRequired

Silinecek iyzilink 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

Last updated