Test Ortamı

Sigortayı ayrı bir test adresinde değil, canlı API adresinde test edersiniz. Teste özel bir taban adres, ayrı bir istemci ya da farklı bir çağrı biçimi yoktur.

https://api-gateway.lunixi.com/api/v1

Test anahtarlarının nasıl üretildiği ve ödemelerin test ortamında nasıl işlendiği genel test sayfasındadır: Test Ortamı. Bu sayfa yalnızca sigortaya özgü olanı anlatır.

Ortamı ne belirler

Sigortada ortamı API anahtarınız belirler. Sigorta istekleri yalnızca anahtarınızla aynı ortamdaki sağlayıcı bağlantılarınıza gider:

API anahtarınız	Kullanılan bağlantılar	Ödeme
Test anahtarı (`mk_test_…`)	Yalnızca Test ortamındaki bağlantılarınız	Test ortamında işlenir, gerçek para hareket etmez
Canlı anahtar (`mk_live_…`)	Yalnızca Canlı ortamdaki bağlantılarınız	Canlı ortamda işlenir

Checkout Form yolu: Ortam, ödemeyi oluşturduğunuz anahtarın ortamıdır. Canlı ödemenin formunda yalnızca canlı bağlantılarınızdan gelen teklifler gösterilir; test bağlantınız bu forma teklif vermez.
Merchant API yolu: Ortam, isteği imzaladığınız anahtarın ortamıdır. Teklifi bir ödemeye bağlarken paymentIntentId başka ortamda oluşturulmuşsa istek 422 ve paymentIntentId alanında environment_mismatch nedeniyle reddedilir.
Anahtarınızın ortamında sigorta tipi açık bir bağlantınız yoksa o tip için teklif dönmez.

Test ve canlı bağlantılarınızda aynı sigorta tipini aynı anda açık tutabilirsiniz; ortamlar birbirine karışmaz.

Test bağlantısı

Test bağlantısı, sağlayıcınızın test ortamı için size verdiği kimlik bilgisiyle kurulur.

Bağlantıyı panelde POS Merkezi > Sigorta sayfasında, sağlayıcının kartındaki Aktif Et ile eklersiniz. Ortam olarak Test'i seçin ve sağlayıcınızın test kimlik bilgisini girin.
Kimlik bilgisi güvenli kasaya yazılır ve bir daha gösterilmez. Canlı ortam için ayrı bir bağlantı eklersiniz.
Bağlantıyı test et ile kimlik bilgisini sağlayıcıya karşı doğrulayabilirsiniz. Test sonucu saklanmaz; her test anlık bir doğrulamadır.

Bağlantının ortamı, bağlantıda hangi ürünleri açabileceğinizi de belirler:

Ürün durumu	Test bağlantısı	Canlı bağlantı
Kullanımda	Açılabilir	Açılabilir
Yalnız test	Açılabilir	Açılamaz
Kullanıma kapalı	Açılamaz	Açılamaz

Adımlar

Test anahtarınızı hazırlayın

İsteklerinizi test anahtarınızla imzalayın; bkz. Kimlik Doğrulama. Anahtarınızın sigorta ürününe erişimi olmalıdır.

Test bağlantısını ekleyin ve ürünü açın

Yukarıdaki gibi Test ortamında bir bağlantı ekleyin. Bağlantının Ürünler ve sıra ekranında test edeceğiniz ürünü açın ve primi kimin tahsil ettiğini seçin.

Aynı sigorta tipi başka bir bağlantınızda da açıksa önce sırası küçük olan bağlantı kullanılır. Canlı bir bağlantınız varsa test boyunca o tipi canlı bağlantıda kapatın.

Sepet kalemlerinize sigorta alanlarını ekleyin

Hangi sigortanın sunulacağı sepet kalemlerindeki sigorta alanlarından çözülür; bkz. Sepet Kalemleri › Sigorta alanları. Sigorta alanı olmayan kaleme sigorta sunulmaz.

Sigortanın sunulduğunu doğrulayın

API yolu: POST /api/v1/insurance/products ucuna ödemede göndereceğiniz kalemleri context.items içinde gönderin. Yanıttaki data.products listesi, bu kalemler için sunulan sigorta tiplerini ve her tipin hangi kalemlere (basketItemIds) uygulandığını gösterir. Bu çağrı salt okumadır; teklif oluşturmaz.
Checkout Form yolu: Panelde Form Ayarları > Sigorta bölümünden sigortayı açın. Ardından test anahtarınızla, sigorta alanlı kalemlerle bir ödeme oluşturun ve formu açın. Uygun bir teklif varsa form sigortayı gösterir.

Liste boşsa ya da formda sigorta görünmüyorsa aşağıdaki kontrol listesine bakın.

Primi test ödemesiyle tahsil edin

Primi Lunixi ödemesiyle tahsil ediyorsanız ödeme test anahtarınızla test ortamında işlenir ve gerçek para hareket etmez. Ödeme senaryoları (başarılı, reddedilen, zaman aşımı) için bkz. Test Ortamı › TestBank.

Sigorta sunulmuyorsa

Sigorta sunulamadığında ödemeniz durmaz; yalnızca sigorta gösterilmez ve uygunluk listesi boş döner. Sırasıyla şunları kontrol edin:

Sigorta hesabınızda açık mı? Sigorta ve kullandığınız yol (Checkout Form ya da API) hesabınızda açık olmalıdır.
Sigorta panelde açık ve yolunuzun kullanım modu seçili mi? Sigorta > Genel ekranında Sigorta açık ayarı açık olmalı ve kullandığınız yolun modu seçili olmalıdır: Checkout Form için Ödeme formu, API için API — Lunixi ödemesine bağlı ya da API — harici tahsilat. Uygunluğu paymentIntentId ile sorguluyorsanız API — Lunixi ödemesine bağlı modu gerekir: Sigorta Menüsü › Kullanım modu.
Kalemde sigorta alanları var mı? Kalemde insuranceCategory yoksa ya da kalem insuranceEligible: false taşıyorsa o kaleme sigorta sunulmaz.
İstediğiniz tip kalemin türüne uyuyor mu? insuranceTypes ile istediğiniz tip, kalemin türüne (insuranceCategory) bağlı değilse sunulmaz.
Tip hesabınızda açık ve kalem uygunluk koşullarını karşılıyor mu? Tipi Sigorta > Sigorta Tipleri ekranında açıp kaydetmiş olmalısınız: Sigorta Menüsü › Sigorta Tipleri. Örneğin bir tutar sınırı varsa kalemin teminat bedeli bu sınırın içinde olmalıdır.
Tipin açık olduğu kullanılabilir bir bağlantınız var mı? Bağlantı Pasif olmamalı, ürün bağlantıda açık olmalı ve bağlantının ortamında açılabilmelidir. Yalnız test ürünleri canlı bağlantıda kullanılmaz.
Checkout Form'da form ayarı açık mı? Form Ayarları > Sigorta ayarı kapalıysa formda sigorta hiç görünmez. Etkin bir sigorta bağlantınız yokken bu ayar kilitlidir.

Test verisi

Gerçek kişi bilgisi kullanmayın. Test isteklerinde gerçek bir kişiye ait kimlik numarası, ad, doğum tarihi, e-posta, telefon ya da adres göndermeyin.
Doğrulama test ortamında da aynıdır. Biçim kuralları gevşetilmez. Örneğin TCKN'nin kontrol haneleri test isteklerinde de doğrulanır; bu yüzden biçime uyan bir test değeri kullanmanız gerekir. Kurallar: Veri Biçimleri.
Değer yoksa alanı göndermeyin. Boş metin ve "yok" gibi yer tutucu değerler kabul edilmez.
Zamanları saat dilimiyle gönderin. Kalkış zamanı gibi alanlar saat dilimi olmadan reddedilir; bkz. Veri Biçimleri › Zaman damgası.
Tutarlar kuruş cinsindendir. Sepet kalemleriyle sigorta isteğindeki tutarlar aynı birimdedir.

Canlıya geçerken

Canlı API anahtarınızı kaydedin; taban adres değişmez.
Sağlayıcınızın canlı kimlik bilgisiyle Canlı ortamda yeni bir bağlantı ekleyin ve ürünleri bu bağlantıda açın.
Test bağlantınızı kapatmanız gerekmez; canlı anahtarla gelen istekler test bağlantısına gitmez.
Checkout Form kullanıyorsanız Form Ayarları > Sigorta ayarınızı kontrol edin.

İlgili

Test Ortamı: test anahtarları ve TestBank
Sigorta Tipleri ve Şemalar: alanlar ve zorunluluklar
Veri Biçimleri: tutar, zaman ve kimlik biçimleri
Sepet Kalemleri: sigorta alanları

Hata Kodları Sağlayıcı Bağlantısı