Sanal POS Sağlayıcı Tanımlama

Kod alanı: hangi entegrasyon çalışacak

Formun en kritik alanı Kod'dur; uygulamanın hangi banka entegrasyonunu devreye alacağını bu değer belirler. Şu an desteklenen değerler PAYNKOLAY, VAKIF, ZIRAAT ve KUVEYTTURK'tür. Bu listenin dışında bir şey yazıldığında tanım kaydedilse bile ödeme anında "Sağlayıcı uygulaması bulunamadı." uyarısı çıkar ve işlem tamamlanmaz. Ad alanı ise yalnızca görünürlük içindir: "Ziraat Sanal POS" gibi yazdığınız isim listelerde ve raporlarda karşınıza çıkar. Altyapı / Model alanı serbest metindir; anlaşmanızın hangi altyapı ve model üzerinden yürüdüğünü not etmek için kullanılır, örneğin "PayNkolay" ya da "Ortak Ödeme Sayfası".

Kart bilgisi nereden gönderilecek: 3D Pay ve 3D Host

Gönderim tercihi, ödeyicinin kart bilgisini nerede gireceğini belirler. Sunucudan seçeneğinde (3D Pay) kart bilgisi portalın kendi ödeme ekranından alınır ve sunucumuz aracılığıyla bankaya iletilir. Tarayıcıdan seçeneğinde (3D Host) ise kullanıcı doğrudan bankanın ödeme sayfasına yönlendirilir; kart bilgisi hiçbir aşamada sunucumuza uğramaz. Hangisini seçeceğiniz bankayla yaptığınız anlaşmaya bağlıdır. Aynı formdaki Sıra No, sağlayıcının listede nerede görüneceğini ayarlar. Aktif anahtarı kapatılan bir sağlayıcı ise ödeme akışında hiç değerlendirmeye alınmaz; kullanımdan kaldırmak için kaydı silmenize gerek yoktur.

Kimlik bilgileri ve şifreli saklama

Merchant ID, Terminal No, Kullanıcı Adı, Şifre, Store Key, API Key ve Secret alanlarından hangilerinin doldurulacağı bankaya göre değişir. Bankanın size ilettiği entegrasyon dokümanındaki adlarla birebir aynı karşılıkları girmeniz gerekir. Bu bilgiler veritabanında şifrelenmiş biçimde tutulur ve ekranda tekrar açık olarak gösterilmez. Kaydı sonradan düzenlerken boş bıraktığınız alanların mevcut değeri olduğu gibi korunur; yalnızca gerçekten değiştirmek istediğiniz bilgiyi yeniden yazmanız yeterlidir. Böylece tek bir alanı güncellemek için tüm kimlik setini yeniden girmek zorunda kalmazsınız.

Adresler, taksitler ve ek parametreler

Her sağlayıcı için Ödeme URL, Sorgu URL, İade URL ve Callback URL adresleri tanımlanır. Test ortamının adresleri ile canlı ortamınkiler birbirinden farklıdır; girdiğiniz adreslerin Tahsilat Ayarları'ndaki Ortam seçimiyle tutarlı olması gerekir. Anlaşmadaki Taksitler alanına bankayla üzerinde anlaştığınız taksit numaralarını yazarsınız. Bankaya özgü, standart alanlara sığmayan ek parametreler için Ek Ayar bölümü kullanılır. Ortamı değiştirirken hem ayar ekranındaki seçimi hem de buradaki adres ve kimlik bilgilerini birlikte güncellemek gerekir.

Adım adım

1. 1TAHSİLAT > Sağlayıcılar ekranını açın ve yeni bir sağlayıcı tanımı oluşturun.
2. 2Kod alanına desteklenen değerlerden birini yazın: PAYNKOLAY, VAKIF, ZIRAAT veya KUVEYTTURK.
3. 3Listelerde ve raporlarda görünecek adı girin; anlaşmanızın altyapı ve modelini not düşün.
4. 4Kart bilgisinin sunucudan mı (3D Pay) yoksa tarayıcıdan mı (3D Host) iletileceğini seçin.
5. 5Sıra numarasını belirleyin ve sağlayıcıyı aktif duruma getirin.
6. 6Bankanın entegrasyon dokümanındaki karşılıklarına göre kimlik bilgilerini doldurun.
7. 7Ödeme, sorgu, iade ve geri dönüş adreslerini seçtiğiniz ortama uygun şekilde girin.
8. 8Anlaşmanızdaki taksit numaralarını ve varsa bankaya özgü ek parametreleri tanımlayın.
9. 9Birden fazla POS kullanacaksanız her biri için ayrı tanım açın; seçimi yönlendirme kurallarına bırakın.

İpuçları ve dikkat edilecekler

• Sağlayıcı kimlik bilgileri gerçek para hareketi başlatır: test şirketlerine, demo kayıtlarına veya ekran görüntülerine gerçek POS bilgisi girmeyin.
• Ödeme anında "Sağlayıcı uygulaması bulunamadı." uyarısı alıyorsanız Kod alanı desteklenen değerlerden biri değildir.
• Test ortamından canlıya geçerken ayarlardaki ortam seçimini, sağlayıcıdaki adresleri ve kimlik bilgilerini birlikte güncelleyin; yalnız birini değiştirmek kimlik doğrulama hatalarına yol açar.
• Kapalı durumdaki bir sağlayıcı ödeme akışında hiç değerlendirilmez.
• Düzenleme sırasında boş bıraktığınız kimlik alanlarındaki mevcut değerler silinmez, olduğu gibi kalır.

İlgili özellikler

• Tahsilat Ayarları | Sanal POS Tahsilat Programı

  Ayarlar bölümündeki Tahsilat Ayarları ekranı, modülün açık olmasından ortam seçimine, muhasebe kaydından tutar sınırlarına ve kart sorgulama servisine kadar tüm temel kuralları tek yerde toplar.

• Taksit Tanımları | Sanal POS Tahsilat Programı

  Taksitler ekranında her POS sağlayıcısı için taksit seçeneklerini kart ailesi ve tutar aralığına göre ayrı ayrı belirlersiniz. Ödeme anında karta ve tutara uyan satır otomatik olarak devreye girer.

• POS Yönlendirme Kuralları | Sanal POS Tahsilat Programı

  Birden fazla sanal POS'unuz varsa, kart tipine, kart ailesine, markasına, bankasına, taksit ve tutar aralığına göre işlemin hangi POS'a gideceğini kurallarla belirlersiniz. Kuralı Dene paneliyle de gerçek ödeme yapmadan sonucu görürsünüz.

• Ödeme Yap Ekranı | Kredi Kartı ile Tahsilat

  Ödeme Yap ekranı, ödemeyi yapan bayi veya cari kullanıcısının kendi bakiyesini görüp kart bilgisiyle taksitli ya da tek çekim ödeme başlattığı sayfadır. İşlem, bankanın 3D Secure doğrulamasından sonra sonuç ekranıyla kapanır.