In-Store API V3
iyzico In-Store API V3 — Genel Bakış
Entegrasyon Akışı
Kullanıcı Yönetimi
Kullanıcı kimliği
user-123Kullanıcı başarıyla oluşturuldu
Sisteme kayıtlı kullanıcının benzersiz kimliği.
user-001Geçersiz parametre veya eksik alan
Geçersiz veya eksik header
Sunucu hatası
Sayfa numarası
1Example: 1Sayfa başına kullanıcı sayısı
100Example: 100Başarılı — kullanıcı listesi döner
Geçersiz parametre veya eksik alan
Geçersiz veya eksik header
Sunucu hatası
Silinecek kullanıcı kimliği
user-123Kullanıcı başarıyla silindi
Başarıyla silinen kullanıcının kimliği. Silme işleminin doğrulanması amacıyla döner.
user-123Geçersiz parametre veya eksik alan
Geçersiz veya eksik header
Sunucu hatası
Ödeme Başlatma
İşlem sonucu bildirimi için callback URL
https://yoursite.com/callbackÖdemeyi yapacak kullanıcı ID'si
usr_12345Sipariş referans numarası
ord_98765Ödeme tutarı
150.00Ödeme başarıyla başlatıldı
İşlemin sonucunu gösterir. Başarılı durumlarda "success" döner.
successHata oluşması durumunda iyzico hata kodunu içerir, aksi hâlde null döner.
Hata oluşması durumunda açıklayıcı mesajı içerir, aksi hâlde null döner.
Müşterinin iyzico mobil uygulamasına yönlendirileceği deep link URL'i. Bu link açıldığında uygulama ödeme ekranını başlatır.
iyzico://payment?token=abc123Ödeme oturumuna özgü token. Ödeme tamamlandıktan sonra /crypt/decrypt adımında şifre çözmek için kullanılır.
abc123xyziyzico tarafından atanan benzersiz ödeme kimliği. İade ve sorgulama işlemlerinde referans olarak kullanılır.
1000001Validasyon hatası — eksik veya hatalı alan
Sunucu hatası
Ödeme Sonucu Şifre Çözme
Callback ile gelen şifreli ödeme verisi
U2FsdGVkX1+ENCRYPTED_DATA_HERE==Ödeme başlatma adımında alınan token
abc123xyzŞifre başarıyla çözüldü
İşlemin sonucunu gösterir. Başarılı durumlarda "success" döner.
successSunucu tarafındaki işlem zamanı (Unix epoch, milisaniye).
1750291200000Validasyon hatası — eksik veya hatalı alan
Sunucu hatası
İptal ve İade
İşlem sonucu bildirimi için callback URL
https://yoursite.com/callbackİşlemi başlatan kullanıcı ID'si
usr_12345İade edilecek ödemenin ID'si
1000001Kısmi iade tutarı; girilmezse tam iade yapılır
50.00İade işlemi başarıyla başlatıldı
İşlemin sonucunu gösterir. Başarılı durumlarda "success" döner.
successHata oluşması durumunda iyzico hata kodunu içerir, aksi hâlde null döner.
Hata oluşması durumunda açıklayıcı mesajı içerir, aksi hâlde null döner.
Müşteriyi iade onay ekranına yönlendiren deep link URL'i. İade akışı bu link üzerinden tamamlanır.
iyzico://refund?token=def456İade oturumuna özgü token. Callback sonrasında şifre çözmek için kullanılır.
def456uvwİade işlemi başlatılan orijinal ödemenin kimliği.
1000001Validasyon hatası — eksik veya hatalı alan
Sunucu hatası
Ödeme Sorgulama
Sorgulanacak ödemenin ID'si
1000001Ödeme bilgileri başarıyla döndü
İşlemin sonucunu gösterir. Başarılı durumlarda "success" döner.
successHata oluşması durumunda iyzico hata kodunu içerir, aksi hâlde null döner.
Hata oluşması durumunda açıklayıcı mesajı içerir, aksi hâlde null döner.
Hata grubunu belirten alan. Başarılı işlemlerde null döner.
İşlemin gerçekleştiği dil/bölge kodu.
Sunucu tarafındaki işlem zamanı (Unix epoch, milisaniye).
1750329600000İsteğe bağlı olarak iletilen konuşma/istek takip kimliği.
Sorgulanan ödemenin iyzico sistemindeki benzersiz kimliği.
123456789Ödeme oluşturulurken iletilen sipariş referans numarası.
ORD-2026-001Ödemeyi gerçekleştiren kullanıcının kimliği.
usr_12345Validasyon hatası — eksik veya hatalı alan
Sunucu hatası
Last updated
