iyzico Link

iyzico Link Oluşturma

post

Yeni bir iyzico Link ürünü oluşturur. Başarılı yanıtta link url'sini döner.

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

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"
  }
}

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.

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

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"
  }
}

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

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"
      }
    ]
  }
}

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

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"
  }
}

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

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"
  }
}

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

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"
}

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

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"
}

Last updated 1 day ago