ApivomApivom
Demo Alın

iyzico Ödeme API Bağlayıcısı

Türkiye'nin iyzico ödeme API'si — ödeme formu, 3-D Secure, BIN sorgu, taksit, iptal ve iade, alt üye işyeri kaydı — kendi API anahtar çiftinizle Apivom Iris'e bağlı: istekler Iris tarafından imzalanır, webhook'lar doğrulanır ve hiçbir kart numarası Apivom üzerinden geçmez.

Neler yapabilirsiniz

  • İstekler iyzico'nun IYZWSv2 HMAC-SHA256 şemasıyla Iris tarafından imzalanır — gizli anahtar kiracınızdan çıkmaz
  • Barındırılan ödeme formu, 3-D Secure, BKM Express, BIN sorgu ve taksit sorguları kataloglanmış rotalarda
  • Satış sonrası işlemler için iptal, iade ve ödeme detayı rotaları; pazaryerleri için alt üye işyeri kaydı
  • Gelen webhook'lar uygulanmadan önce X-IYZ-SIGNATURE-V3 ile doğrulanır
  • Canlı ve sandbox sunucuları (api.iyzipay.com / sandbox-api.iyzipay.com) kimlik bilgisinin ortamıyla seçilir
  • Iris ödeme kayıtlarında ödeme sağlayıcısı olarak seçilebilir; 63 rota entegrasyon merkezinden denenebilir

Kullanım senaryoları

  • Yerel taksitle Türk kartı kabulü — Ödeme kaydı ve durumu Iris'te kalırken Türk müşterilere iyzico üzerinden taksit planları ve yerli kart şemaları sunun.
  • Destek masasından iade ve iptal — Bir ödemeyi konuşma kimliğiyle bulun, ardından Iris'ten iptal edin veya kısmi iade yapın; imzalı istek ve iyzico'nun yanıtı kayda işlenir.
  • Alt üye işyerlerine pazaryeri ödemeleri — Kendi iyzico pazaryeri sözleşmeniz altında kayıt ve kalem rotalarıyla alt üye işyerleri oluşturun, güncelleyin ve kalemleri ödemeye onaylayın.

iyzico, Türkiye'nin önde gelen ödeme hizmeti sağlayıcılarındandır ve API'si Türk üye işyerleri için kart ödeme yaşam döngüsünün tamamını kapsar: barındırılan ödeme formu, doğrudan 3-D Secure yetkilendirme, BKM Express, BIN ve taksit sorguları, ödeme detayları, iptal ve iade, kart saklama ve pazaryerleri için alt üye işyeri kaydı. Apivom Iris buna seçilebilir bir ödeme sağlayıcısı olarak bağlanır. Kimlik bilgisi kendi API anahtarınız ve gizli anahtarınızdır; iyzico her isteği IYZWSv2 şemasıyla imzaladığından Iris HMAC-SHA256 imzasını kendisi hesaplar ve Apivom Atlas yalnızca hazır başlıkları iletir — gizli anahtar Atlas'a hiçbir zaman aktarılmaz veya orada saklanmaz. Kimlik bilgisindeki ortam canlı ile sandbox sunucusu arasında karar verir. iyzico webhook'ları kiracı bazında alınır ve bir ödeme kaydına dokunmadan önce X-IYZ-SIGNATURE-V3 başlığıyla doğrulanır. Bugün Iris'teki barındırılan ödeme otomasyonu Stripe için geliştirilmiştir; iyzico işlemleri entegrasyon merkezinden (kataloglanmış herhangi bir rota, yazmalar onay arkasında) ve doğrulanmış webhook'lar üzerinden çalışır, her çağrı kiracınızda kaydedilir.

Kimlik doğrulama

iyzico üye işyeri panelinizden API anahtarı + gizli anahtar. Iris her istek için IYZWSv2 imzasını hesaplar (rastgele x-iyzi-rnd ile HMAC-SHA256) ve Apivom Atlas yalnızca imzalı başlıkları iletir — gizli anahtar Atlas'a asla gönderilmez. İki anahtar da Iris kiracınızda şifrelidir.

Sık sorulan sorular

İstekleri neden Apivom Atlas değil de Iris imzalıyor?

iyzico'nun IYZWSv2 şeması her imza için gizli anahtara ihtiyaç duyar. Bu hesaplamayı Iris içinde tutmak gizli anahtarın kiracınızdan hiç çıkmaması demektir — Atlas yalnızca imzalı Authorization ve x-iyzi-rnd başlıklarını alır, iletir ve çağrıyı kaydeder.

Barındırılan ödeme akışı iyzico için de Stripe'taki gibi otomatik mi?

Henüz değil. iyzico bir ödeme kaydında sağlayıcı olarak seçilebilir, rotaları — ödeme formu başlatma dahil — entegrasyon merkezinden çalıştırılabilir ve webhook'lar doğrulanıp uygulanır; uçtan uca otomatik Checkout akışı şu anda yalnızca Stripe için mevcuttur.

Apivom kart numaralarıyla çalışır mı?

Hayır. Barındırılan ödeme formu kartı iyzico tarafında alır ve entegrasyon SAQ-A kapsamında tutulur — Apivom kart verisiyle değil, iyzico'nun ödeme ve konuşma kimlikleriyle çalışır.

Apivom bu bağlayıcı için API çağrısı başına ücret alır mı?

Hayır. Bağlayıcılar Apivom kiracınızın parçasıdır ve Atlas portalında ölçümlenmez. Bağladığınız hesapta sağlayıcının kendi fiyatlandırması, kotaları ve hız sınırları geçerli olmaya devam eder — Apivom çağrılarını bu sınırların içinde kalacak şekilde hızlandırır ve her çağrıyı kiracınızın entegrasyon günlüğünde gösterir.

Kimlik bilgilerim nerede saklanır, trafiği kim görür?

Apivom Atlas durumsuz bir geçittir: sağlayıcı kimlik bilgilerini veya jetonları asla saklamaz. Bağlanan Apivom ürünü kimlik bilgisini kiracı veritabanınızda şifreli tutar; her istek ve yanıt yalnızca kiracınızda kaydedilir — verileriniz kiracılar arasında asla paylaşılmaz.

Diğer Atlas entegrasyonları

AI entegrasyon rehberi (llms.txt)

Makine tarafından okunabilir markdown — AI asistanınıza entegrasyon talimatı olarak verin.