iyzico Link API
iyzilink API içerisinde yer alan servisler aşağıda listelenmiştir.
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.
IYZWSv2 ile başlayan imza değeri (Base64). Örn: IYZWSv2 YXBpS2V5On...
IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
İstek gövdesi formatı.
application/json
Possible values: İstek/yanıt eşleştirme için gönderilen değer.
123456
Yanıt dili (tr|en). Varsayılan tr.
tr
Ürünün adı (müşteriye görünür).
Örnek Ürün
Ürünün açıklaması (müşteriye görünür).
10 Adet Kitap
Ürün fiyatı (decimal).
50.00
Para birimi kodu.
TRY
Possible values: Ürün resminin base64'e çevrilmiş hali.
a/9j/4AAQSkZJRgABAgAAZABkAAD/7AARRHVja3k...
Satın alımda adres istenmesin (true) / istensin (false).
true
Taksitli satış aktif/pasif.
false
Possible values: Stok kontrolü aktif/pasif.
true
Possible values: Stok sayısı.
25
Başarılı oluşturma yanıtı.
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
}
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
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.
IYZWSv2 ile başlayan imza değeri (Base64). Örn: IYZWSv2 YXBpS2V5On...
IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
İstek gövdesi formatı.
application/json
Possible values: İstek/yanıt eşleştirme için gönderilen değer.
123456
Yanıt dili (tr|en). Varsayılan tr.
tr
Link açıklaması (müşteriye görünür).
10 Adet Kitap
Ürün fiyatı (decimal).
75.00
Para birimi kodu.
TRY
Başarılı oluşturma yanıtı.
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"
}
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
Token ile tek bir iyzilink ürününün detayını döner.
iyzilink ürününün benzersiz anahtarı.
WxI
Yanıt dili (varsayılan tr).
tr
İstek/yanıt eşleştirme değeri.
123456
IYZWSv2 ile başlayan imza değeri (Base64). Örn: IYZWSv2 YXBpS2V5On...
IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
İstek gövdesi formatı.
application/json
Possible values: Ürün detay yanıtı.
GET /v2/iyzilink/products/WxI?locale=tr&conversationId=123456
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json
Ü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
iyzilink ürünlerini sayfalı olarak listeler.
Yanıt dili (varsayılan tr).
tr
Sayfa numarası (1..N).
1
Sayfa başına ürün sayısı.
10
İstek/yanıt eşleştirme için serbest metin alanı.
test
IYZWSv2 ile başlayan imza değeri (Base64). Örn: IYZWSv2 YXBpS2V5On...
IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
İstek gövdesi formatı.
application/json
Possible values: Listeleme yanıtı.
GET /v2/iyzilink/products?locale=tr&page=1&count=10&conversationId=test
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json
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
iyzico Link oluşturduğunuzda dönen token değeri ile varolan iyzico Linkinizi güncelleyebilirsiniz.
Güncellenecek iyzilink’in token değeri.
WxI
IYZWSv2 ile başlayan imza değeri (Base64). Örn: IYZWSv2 YXBpS2V5On...
IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
İstek gövdesi formatı.
application/json
Possible values: Link güncelleme için gönderilebilecek alanlar (gövde — token path’te verilir).
İstek/yanıt eşleştirmesi için gönderilen değer.
123456
Yanıt dili (tr|en).
tr
Ürün adı.
Güncellenmiş Ürün
Ürün açıklaması.
10 Adet Kitap
Ürün fiyatı (decimal).
60.00
Para birimi kodu.
TRY
Ürün resminin base64’e çevrilmiş hali.
a/9j/4AAQSkZJRgABAgAAZABkAAD/7AARRHVja3k...
Adres istenmesin/istensin.
false
Taksitli satış aktif/pasif.
true
Stok kontrolü aktif/pasif.
true
Stok sayısı.
12
Başarılı güncelleme yanıtı.
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
}
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
Bir iyzilink’in durumunu ACTIVE veya PASSIVE yapar.
iyzilink token’ı.
WxI
Yeni durum.
PASSIVE
Possible values: Yanıt dili (varsayılan tr).
tr
İstek/yanıt eşleştirme değeri.
123456
IYZWSv2 ile başlayan imza değeri (Base64). Örn: IYZWSv2 YXBpS2V5On...
IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
İstek gövdesi formatı.
application/json
Possible values: Durum güncelleme sonucu.
PATCH /v2/iyzilink/products/WxI/status/PASSIVE?locale=tr&conversationId=123456
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json
Durum güncelleme sonucu.
{
"status": "success",
"locale": "tr",
"systemTime": 1687827915258,
"conversationId": "123456"
}
Örnek Kodlar
Token ile belirli bir iyzilink’i siler.
Silinecek iyzilink token’ı.
WxI
Yanıt dili (varsayılan tr).
tr
İstek/yanıt eşleştirme değeri.
123456
IYZWSv2 ile başlayan imza değeri (Base64). Örn: IYZWSv2 YXBpS2V5On...
IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
İstek gövdesi formatı.
application/json
Possible values: Silme sonucu.
DELETE /v2/iyzilink/products/WxI?locale=tr&conversationId=123456
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json
Silme sonucu.
{
"status": "success",
"systemTime": 1687825929316,
"locale": "tr",
"conversationId": "123456"
}
Örnek Kodlar
Last updated