Ana Sayfa Yazılım İşbankası Sanal Pos Epayapi.DLL Kullanım ve Kurulum Kılavuzu
1 Provizyon (PreAuth)
2 İşyeri Onayı (PostAuth)
3 Satış (Auth)
4 Provizyon İptali (Void)
5 İşyeri Onayı İptali (Void)
6 Satış iptali (Void)
7 İade (Credit)
İşbankası Sanal Pos Epayapi.DLL Kullanım ve Kurulum Kılavuzu, bu bölümde tüm detaylar anlatılmıştır.
A) KURULUM VE KURULUMUN KALDIRILMASI
SSLlib.dll , epayapi.dll dosyalarını silinmeyecek bir dizine kopyalayın.
register etmek icin su komutlari calistirin.
regsvr32 -u epayapi.dll
DİKKAT: Ancak kurulumu kaldirdiktan sonra dll dosyalarini silebilirsiniz.
Epayapi.dll register edildikten sonra programlama dili içinden createobject fonksiyonu ile çağrılır.
Örneğin visual basic script ve asp için aşağıdaki şekilde bir obje yaratabilirsiniz.
Set pay = CreateObject(“epayapi.payment”)
COM destekleyen bir client ile (ASP, visual basic, c++ gibi) nesneyi yaratıp ilgili parametrelerini set ettikten sonra
Metodunu cagirdiginizda odeme islemini yapip, sonucu alıp almadığını döner.
Dönen sonuç 1 ise bankanız ile başarılı sekilde bağlantı kurulmuştur, eğer 0 dönerse banka ile bağlantı kurulamamıştır. Bu durumda network ayarlarınızı kontrol etmeniz ve yazdığınız host parametresini kontrol etmeniz gerekmektedir.
Otorizasyon İşleminin başarılı olup olmadığı, dönüş alanlarından anlaşılır.
1) addItem(BSTR id, BSTR desc, BSTR price, BSTR quantity,BSTR itemnumber,BSTR productcode,BSTR total);
Vrilen parametreler ile bir ürünün sanalpos raporlarında görüntülenmesini sağlar.
Kullanılması opsiyonel bir alandır.
Id Siparişe eklenen ürünün id’si
Desc Siparişe eklenen ürün için açıklama
Price Ürün fiyatı
Quantity Üründen kaç adet alınmış
ItemNumber Ürun sira numarasi
Productcode Ürün kodu
Total Toplam tutar
2) putExtra(BSTR FieldName,BSTR FieldValue)
FieldName adinda, FieldValue değerinde bir alanı göndermek için kullanılır.
Putextra fonksiyonu ile puan sorgulama ,puan kullanma ve extra puan verme işlemlerini yapabilirsiniz.
İşbankası Sanal POS uygulamasında, ayrıca, mal veya hizmet satışına aracılık etmek sureti ile, tutarın belli oranının aracı firmaya aracı firma ÜİY çalışma koşulları ile, geri kalan oranın ise mal veya hizmet sahibi firmaya kendi ÜİY çalışma iş koşulları ile ödeneceği yapı mevcuttur. Kısaca bu, bir işlem 2 ayrı ÜİY’ne farklı çalışma koşullarında muhasebe yaratabilecek özelliktir. Arzu edildiği takdirde, uygulamanın detayları hakkında bilgi verilebilir.
Girilen parametrelerle bankaya işlemi gönderir. Eğer bu çagrı başarılı bir şekilde sonuçlanmışsa dönüs alanlarını okuyabilirsiniz.
Metodu çağırdığınızda ödeme işlemini yapıp sonucu alıp almadığını döner.
Dönen sonuç 1 ise bankanız ile başarılı şekilde bağlanti kurulmustur, eger 0 dönerse banka ile bağlantı kurulamamıştır. Bu durumda network ayarlarınızı kontrol etmeniz ve yazdığınız host parametresini kontrol etmeniz gerekmektedir.
Otorizasyon işleminin başarılı olup olmadığı, dönüş alanlarından (pay.appr) anlaşılır.
C) GÖNDERİLMESİ ZORUNLU ALANLAR
Bütün alanlar string olarak gönderilmelidir.
(Objeadı.alanadı = “Alanin değeri“)
Pay.subtotal = “12.14
Host Banka sunucusu adresi
Name Uyeisyeri kullanici adi
Password Uyeisyeri sifresi
Clientid Uyeisyeri numarasi
OrderResult 0 olursa gercek islem 1 olursa test islemi yapar
ChargeType Auth PreAuth PostAuth Credit Void olabilir Bu islem tiplerinin aciklamalari ayri bir bolum olarak verilmistir.
cardnumber Kredi karti numarasi
expmonth Kredi karti son kullanim ayi
expyear Kredi karti son kullanim yili
cv2 CVV veya CVC2
subtotal Islem tutari
currency Parabirimi (YTL icin 949, Dolar icin 840, Eruo için 978)
Provizon alınmış işlemi onaylamak ve para transferini gerçekleştirmek için kullanılır.
Provizyon ve işyeri onayı işlemlerini aynı anda yapar. Satış işlemi otomatik olarak saat 22:00’de gerçekleşen günsonu işleminden sonra muhasebeleşerek , üye işyeri hesabına ve kredi kartı hesabına yansır.
Taksitli satışlar gün içerisinde iade edilemez ancak ertesigün iade edilebilir.
D) GÖNDERILMESI İSTEĞE BAĞLI ALANLAR
(Objeadı.alanadı = “Alanın değeri“)
Pay.Taksit = “5“
Taksit Taksit sayisi bu alandan gönderilir. Taksit parametresi hiç gonderilmez ise peşin işlem yapılır.Taksit sadece İşbankası maximum kartlara yapılabilir. Taksitli işlem gönderirken vade farkı hesaplanıp tutara eklenmelidir.
Eğer taksitli ve puan kullanilan islem yapılıyorsa ve puan tutardan az ise,
sadece kalan limit taksitlendirilir.
Oid Siparis numarasi, biricik (unique) olmalidir, bos gonderilirse sistem tarafindan uretilir. PostAuth isleminde muhakkak dolu olmalidir.
groupid Siparis grup numarasi bos gonderilirse oid ile ayni olur.
ip Siparis veren musterinin ip adresi
userid Siparis veren musterinin kullanici numarasi
email Siparis veren musterinin Email adresi
phone Siparis veren musterinin telefon numarasi
Bname Musteri fatura adi
Baddr1 Musteri fatura adres 1
Baddr2 Musteri fatura adres 2
Baddr3 Musteri fatura adres 3
Bcity Musteri fatura sehir
Bzip Musteri fatura posta kodu
Bstate Musteri fatura eyalet
Bcountry Musteri fatura ulke
Sname Musteri teslimat adi
Saddr1 Musteri teslimat adres 1
Saddr2 Musteri teslimat adres 2
Saddr3 Musteri teslimat adres 3
Scity Musteri teslimat sehir
Szip Musteri teslimat posta kodu
Sstate Musteri teslimat eyalet
Scountry Musteri teslimat ulke
Verified By Visa icin kullanilan alanlar
E) GERİ DÖNEN ALANLAR
Processorder() fonksiyonu dll in calisip calisamadigi ile ilgili deger doner
1 : Com objesi banka ile mesaj transferini gerçekleştirmiş demektir. Transfer mümkün olmus olsa dahi işlem başarılı olmamış olabilir (appr nin değerinin “Approved” olmasi gerekiyor!!)
0: Mesaj transferi gerceklesemedi. Baglanti veya kurulum hatasi.
Processorder fonksiyonu ile odeme islemi gerceklestikten sonra okunabilecek alanlar
oid siparis numarasi
groupid grup numarasi
transid islem numarasi
appr Sonuc: (Approved ise onaylandi, Declined ise reddedildi, Error ise hata demektir)
code provizyon numarasi
refno referans numarasi
err bankadan gelen cevap kodu
errmsg islem aciklama
FieldName adındaki Extra field in değerini return eder. Processorder fonksiyonundan sonra cağırılmalıdır.
Puan kullanıldığı zaman ne kadar puan kullanildığı , ne kadar limit kullanildığı ve kalan puan bu fonksiyon ile alınabilir.
Önceki İçerikASP.NET Avantajları
Sonraki İçerikSevgililer Günü Nedir Ne Zaman Kutlanır
ahmet 22 Şubat 2018 at 11:00
ben akbank için pos kurulumu yapacam. zaten akbanktakinin aynısı yukarıdaki metin. lakin şu sıkıntı , bu DLL dosyasının kurulumundaki kodu nereye yazacazda , kurulum yapacaz.
Ümit Eğrioğlu 23 Şubat 2018 at 17:27
Başlat / Çalıştır / Cmd komut satırından yapmanız gerekmektedir.
Youtube TV Yayın Hayatına Başladı, Youtube TV İncelemesi