Test Ortamı
Test ortamı canlıyla aynı uçları, aynı alanları ve aynı webhook olayını kullanır. Fark, bağlantının gerçek bir bankaya değil simülatör bir bankaya gitmesidir; gerçek hesap verisi okunmaz.
Taban adres tektir; ortamı anahtarınız belirler. Test anahtarınızla (mk_test_…) aynı https://api-gateway.lunixi.com/api/v1/bank-connect adresine istek gönderirsiniz; ayrı bir test adresi yoktur. → Test Ortamı (genel)
Uçtan uca deneme
Test ortamında bir simülatör banka bağlayın
Panelde Ortam seçicisini Test yapın ve Banka Bağlantıları › Bankalar ekranında listelenen simülatör bankalardan birini Lunixi ile bağla ile bağlayın. Test ortamında yalnız simülatör bankalar listelenir. → Panelden Banka Bağlama
Test anahtarınıza yetki verin
Test anahtarınıza Banka Bağlantıları ürününü (BANK_CONNECT), bank-connect:view ve bank-connect:transactions:view yetkilerini ekleyin. → API'ye Giriş › Yetkiler
Hesapları ve hareketleri okuyun
Bağlantı ACTIVE olduktan sonra Hesaplar, Bakiyeler ve Hareketler uçlarını test anahtarınızla çağırın. Simülatör banka örnek hesaplar ve geçmiş hareketler sunar.
Webhook endpoint'i oluşturun
productCode: BANK_CONNECT, environment: TEST ve eventTypes: ["bank_account.*"] ile bir endpoint oluşturun. → Webhook Olayları › Abonelik
Yeni hareketleri bekleyin
Simülatör banka gün içinde yeni örnek hareketler üretir. Bunlar olağan okumada bulunduğu için her biri için bank_account.transaction.received olayı gelir. Bağlantı ilk kurulduğunda okunan geçmiş hareketler için olay gelmez; bu canlıyla aynıdır.
Simülatör verisi
- Hesaplar, IBAN'lar ve hareketler gerçek değildir.
- Aynı bağlantının hesapları ve geçmiş hareketleri her okumada aynı döner; testleriniz tekrarlanabilir.
- Simülatör, entegrasyonunuzu sınamanız için gerçek hayatta görülen durumları da üretir: bankanın bir hareketi geç bildirmesi, aynı hareketin bankadan yeniden gelmesi ve ortak tiplerden birine eşlenemeyen hareket (
OTHER). Senkron ve tekilleştirme mantığınızı bu durumlarla deneyin. → Hareketleri senkron tutma
Test ve canlı veriler birbirine karışmaz. Test anahtarı canlı bağlantıları görmez; canlı anahtar test bağlantılarını görmez. Test ortamında kurduğunuz bağlantı canlıya taşınmaz.
Canlıya geçerken
- Panelde Ortam seçicisini Canlı yapın ve bankanızı canlı ortamda bağlayın; başvuru ve kurulum adımları canlı ortamda ayrıca yapılır.
- Canlı API anahtarınıza aynı ürünü ve yetkileri verin.
- Webhook endpoint'inizi
environment: LIVEile ayrıca oluşturun. - Kodunuzda yalnız anahtar değişir; taban adres ve çağrılar aynı kalır.