Garanti Sanal POS. Windows API Kurulum Bilgileri. Garanti e-ticaret



Benzer belgeler
3-D SECURE ÖDEME İŞLEMLERİ

COM API v.1.1 BELGE SÜRÜMÜ : 1.1

SANAL POS ENTEGRASYON DOKÜMANI. Versiyon Temmuz 2014 NESTPAY SANAL POS ENTEGRASYON DOKÜMANI

İNTERNET ŞUBE FONKSİYONLARI

Dış Kurum Entegrasyonları TURKPOS API. Yardım Dokümanı

7/24 destek hattı Kolay kurulum CD si Üç yıl garanti Üç yıl garanti YM.WR.5341.UM.TR.D01REV

NicProxy Registrar WHMCS Modül Kurulumu Versiyon 1.0

ProTicaret Exclusive 4.05 E-Ticaret Yazılımı Kurulum Dokümanı

MOBILEPAX ENTERPRISE API (WEB SERVİS)

Harita güncelleme direktifleri

Kaynak Kodlardan Derleme. Turquaz Muhasebe. Versiyon 0.2. Hüseyin Ergün. 26 Mart 2005

Proticaret Exclusive v3.2.0 E-Ticaret Yazılımı Kurulum Dokümanı

JAVA API v2.0 Belge sürümü: 2.0.2

MaestroPanel Kurulum

API geliştiricileri. Web server ile yapılan entegrasyonun neticeleri. API Dokumantasyonu

İstanbul Arel Üniversitesi

İstanbul Arel Üniversitesi Online Ödeme Sistemi

ETA:MOBİL KURULUM TALİMATI

Tarih: 2 Ağustos 2018 Son versiyon: 1.8. EndNote X9 Windows Multi/Site kurulum talimatları

LOGO için Online Mutabakat Kullanım Kılavuzu

Toplu İleti Gönderimi

Proticaret Exclusive Versiyon Yükseltme Dokümanı(v.3.0'dan v3.1.0'a)

e-mutabakat Ekstre Gönderimi

Medula Eczane Stok Bilgileri Web Servisleri Kullanım Kılavuzu


e-mutabakat hesabı için adresimizden kayıt olabilirsiniz.

Proticaret Exclusive Versiyon Yükseltme Dokümanı(v.3.2.0'dan v3.2.1'e)

Sistem Nasıl Çalışıyor: Araç İzleme ve Filo Yönetim Sistemi

Seymen Isı - BayiPos Kullanım Klavuzu

Smartnet PRO-W Kullanım Kılavuzu

Cambridge LMS e Başlama- Öğrenciler

LOGO için Online Mutabakat Kullanım Kılavuzu

Yayınlanma Tarihi: soru ve sorunlarınız için;

NicProxy Registrar AWBS Modül Kurulumu Versiyon 1.0

COM API v2.0 Belge sürümü : 2.0.3

Değerli Alışveriş Merkezi Üyemiz,

3G SMS & MMS GateWay Xml Interface

AirTies Kablosuz Erişim Noktası (Access Point) olarak kullanacağınız cihazı bilgisayarınıza bağlayarak ayarlarını yapabilirsiniz.

Google Chrome Kullanıyorsanız; Microsoft Internet Explorer Kullanıyorsanız;

Google Scripts. Neticaret Sistemine Google Analytics ve AdWords sistemleriyle ilgili 3 yeni parametre eklenmiştir.

Berqnet Sürüm Notları Sürüm 4.1.0

Global Haberleşme API Kullanıcı Notları

Opera V2 Kurulum Klavuzu V0.01

TC KİMLİK NO SMS GÖNDERİM SOAP API

E-postaya Tarama Hızlı Kurulum Kılavuzu

E-FATURA LOGO ENTEGRATÖRLÜK UYGULAMASI

Kılavuz içerisinde TalksPBX kurulumu anlatılmakta olup, yapacağınız konfigürasyonlar satın aldığınız lisans ile sınırlıdır.

AĞ KULLANIM KILAVUZU. Yazdırma Günlüğünü Ağa Kaydetme. Sürüm 0 TUR

Süha Makina - BayiPos Kullanım Klavuzu

DARA PLUS PARAKENDE MODULU

MOKA ÖDEME SERVİSİ ORTAK ÖDEME SAYFASI ENTEGRASYON DOKÜMANI V

MOKA ÖDEME SERVİSİ IFRAME ENTEGRASYON DOKÜMANI

Elektronik Dergi ve Veri Tabanlarına Kampus Dışından Erişim

AJANS İLETİŞİM API XML API v İçindekiler. 1. AMAÇ - Sayfa 2

Tekirdağ Büyükşehir Belediyesi E-Hizmet Sitesi (ehizmet.tekirdag.bel.tr) Bilgi Edinme Başvurusu

FABREKA YAZILIM ELEKTRONİK DANIŞMANLIK TİC. LTD. ŞTİ.

PERKON PDKS Kurulum ve hızlı başlangıç rehberi

Sol tarafta yer alan Click here to activate your account linkini seçiniz.

Bu makalede 2003 sunucu, Windows 2003 Server anlamına gelmektedir. Aşağıda yapılan işlemler 2003 R2 sunucu üzerinde denenmiş ve çalıştırılmıştır.

MOBILEPAX XML PRODUCT API KULLANIM ŞEKLİ

İnternetten Kredi Kartı İle Online Tahsilat

Online Kanal Durum Başvuru. [Belge alt başlığını yazın]

18 Ekim Programlarımız ile Uyumlu Olan Yazar Kasa Modelleri. Profilo VX 680 E-1 Profilo YK-8200 Farex FR-8300 Telestar TLS-8100

Coslat Monitor (Raporcu)

Sorun Giderme. Genel. Disk. Aygıt Sürücüleri 3

Cihazınızın İnternet ayarlarını yapabilmek için lütfen aşağıdaki adımları takip ediniz;

VAKIFBANK SANAL POS PANELİ KULLANICI KILAVUZU

SERNET ET232CAS x2 RS232 Seri Kanal Sunucu KULLANICI KILAVUZU. Telif Hakkı Uyarısı. >>> Otomasyon Ürünleri

1. Admin kullanıcı ile sisteme giriş yapınız. Ekranın sağ üstünde yer alan defter yaprakları ikonuna tıklayınız.

3G Sms&MMS GateWay Xml Interface

IdeaSoft E-Ticaret ile LOGO Ticari Yazılım Entegrasyon Kullanım Kılavuzu

Wolvox Kapı Ekranı. AKINSOFT Wolvox Kapı Ekranı Yardım Dosyası. Doküman Versiyon :

MİLLİ EĞİTİM BAKANLIĞI YENİ EPOSTA SİSTEMİ HAKKINDA MEB

CLEARONE MAX IP KONFERANS CİHAZI

6 Ocak İlgili Versiyon/lar : ETA:SQL, ETA:V.8-SQL. İlgili Modül/ler : E-Fatura

Orkestra Ürünler. Ana Sayfa / Orkestra Ürünler

ART S602W Standalone Kart Okuyucu

SERNET ET485CAS x2 RS485/RS422 Seri Kanal Sunucu KULLANICI KILAVUZU. Telif Hakkı Uyarısı. >>> Otomasyon Ürünleri

WEB SUNUCU GÜVENLİĞİ: Web Siteleri Neden Hacklenir?

AKINSOFT NetFoto. Yardım Dosyası. Doküman Versiyon : Tarih : Sayfa-1. Copyright 2010 AKINSOFT

Resimdeki alandan tarih aralığı belirterek de (testlerin hasta hesabına aktarıldığı tarihi baz alır). İstek yapılan hasta listesine ulaşabilirsiniz.

İstanbul Arel Üniversitesi Online Ödeme Sistemi

POS KULLANIM KILAVUZU POS KULLANIM KILAVUZU UNUTMAYALIM! POS DESTEK HATTI POS Destek Hattı

LOGO Online Mutabakat ve Finans Süreç Yönetimi. ARTI BİLİŞİM ve DESTEK HİZMETLERİ

Cambridge LMS e Başlama- Öğrenciler

Signera KEY Solutions. Kurulum Dokümanları

ProTicaret yazılımının, en son sürüm dosyasını indirin.(

KÜTÜPHANE KAYNAKLARINA DIŞARIDAN (PROXY SUNUCU KULLANARAK) BAĞLANMAK İÇİN YAPILMASI GEREKENLER A. INTERNET EXPLORER KULLANICILARI İÇİN;

Cambridge LMS e Başlama- Öğrenciler

Design Machin e Erişim Rehberi

Sigorta Programı. Policede Müşteri bilgilerini detaylı olarak girebilirsiniz. her bir müşteriyi cari kart olarak algılar ve cari işlem yapabilirsiniz.

SQL Uyarı Programı Kurulum ve Kullanımı

OPARWEB VE MMWEB YENİ B2B SİSTEMLERİ

SİTE KULLANIMI. Sepete Ürün Ekleme. Sepeti Onaylama

XML API. İçindekiler. Toplu SMS Sistemlerinde Güvenilir Çözüm Ortağınız 1. AMAÇ KULLANIM ŞEKLİ Genel Hata Kodları.

POP3 ve IMAP kurulumu

Kurulum; Ana Bilgisayar ve Tahtalara ayrı ayrı yapılmaktadır. KURULUM ŞEMASI x.x x.x x.x x.

KANTAR UYGULAMASI Kurulum Kılavuzu

7/24 destek hattı Kolay kurulum CD si Üç yıl garanti Üç yıl garanti YM.WR.6372.UM.TR.D00REV

Transkript:

Garanti Sanal POS Windows API Kurulum Bilgileri Garanti e-ticaret http://eticaret.garanti.com.tr eticaret@garanti.com.tr 444 0 333 (menü adımları 5, 2 ve 2) 1

Bu doküman size Garanti Sanal POS Windows API kurulumu hakkında ihtiyacınız olan bilgileri sağlayacaktır. Herhangi bir problem yaşadığınız takdirde, bu dokümanın sonundaki iletişim bilgilerini kullanarak bize ulaşabilirsiniz. Türkiye'nin en gelişmiş e-ticaret ödeme altyapısı olan Garanti Sanal POS'u seçtiğiniz için teşekkür ederiz. 2

I. Başlamadan Önce Lütfen başlamadan önce gerekli konfigürasyon ve teknik bilgi ihtiyaçlarını gözden geçiriniz: ASP sayfalarını çalıştırabilecek şekilde ayarlanmış Microsoft Windows 2000/XP IIS Server Önemli not:.net ve Windows Server 2003 için ayrı kurulum modüllerimiz bulunmaktadır. ccpos.garanti.com.tr adresine 443 (HTTPS) no'lu port üzerinden çift yönlü iletişim Server üzerinde admin yetkileri ve orta seviyede IIS server admin bilgisi Orta-üst derece ASP ve web programlama bilgisi Sanal POS yönetim ekranlarından download edeceğiniz kurulum paketi Garanti e-ticaret tarafından size e-posta ile gönderilmiş olan şifre bilgileri 3

II. Kurulum Paketinin İçeriği ve Dosyaların Kopyalanması Kurulum paketinde bu bilgi dokümanı dışında bulunması gereken dosyalar: İki adet DLL dosyası: epayapi.dll, ssllib.dll Bir adet VBS (visual basic script) dosyası: test.vbs Öncelikle SSLlib.dll, epayapi.dll dosyalarini silinmeyecek bir directory'e kopyalayınız ve register ediniz: regsvr32 epayapi.dll regsvr32 ssllib.dll Eğer unregister etmek isterseniz aşağıdaki yöntemi kullanabilirsiniz: regsvr32 -u epayapi.dll regsvr32 -u ssllib.dll DIKKAT: unregister etmeden DLL dosyalarını silemezsiniz. 4

III. Teknik Kurulum ve Kullanım Tavsiye edilen kurulum süreci 1. Öncelikle paketten çıkan test.vbs dosyasını sunucunuzda çalıştırınız. 2. Eğer herhangi bir hata yoksa 4 no lu adımdan devam ediniz. 3. test.vbs i çalıştırdığınızda hata aldıysanız bunun birkaç sebebi ve çözümü olabilir: a. Sunucu yetki tanımlarınız COM nesnesinin dışarı erişmesine izin vermiyor olabilir. b. Firewall / Proxy ayarlarınız ccpos.garanti.com.tr ye port 443 üzerinden erişimi yasaklıyor olabilir. c. Her iki durumda da lütfen bu dokümanın Problemler ve Çözümler bölümünü inceleyiniz 4. IIS sunucunuzun inetpub\wwwroot dizini altında garanti adında yeni bir klasör yaratınız. 5. ZİP paketinden çıkan test.asp dosyasını bu dizine kopyalayınız. 6. Herhangi bir tarayıcı ile bu sayfayı çağırınız (örnek: http://benimsitem.com/garanti/test.asp ) 7. Eğer herhangi bir hata almadıysanız 9 no lu adımdan devam edebilirsiniz. 8. Eğer test.vbs çalıştıysa ve test.asp çalışmadıysa, bu çok büyük ihtimalle IIS üzerindeki yetki ayarlarından kaynaklanmaktadır. a. Sunucu yetki tanımlarınız COM nesnesinin dışarı erişmesine izin vermiyor olabilir. b. Firewall / Proxy ayarlarınız ccpos.garanti.com.tr ye port 443 üzerinden erişimi yasaklıyor olabilir. c. Her iki durumda da lütfen bu dokümanın Problemler ve Çözümler bölümünü inceleyiniz 9. Eğer hem VBS hem ASP çalıştıysa, sunucunuz Garanti Sanal POS a hazır demektir. Bu dokümanı ve paketteki örnekleri inceleyip Garanti Sanal POS u uygulamanız ile entegre edebilirsiniz. Örnek kaynak kodu ve açıklaması Not: ZİP paketinde bulunan test.asp dosyası örnek olarak alınmıştır. KOD Set pay = Server.CreateObject("epayapi.payment") pay.clientid="100102" pay.name="100102pay" pay.password="100102pass" pay.host="ccpos.garanti.com.tr" pay.orderresult=0 pay.chargetype="preauth" pay.cardnumber= "4242424242424242" pay.expmonth="01" pay.expyear="09" pay.cv2="123" pay.subtotal="1" pay.currency=792 retval=pay.processorder AÇIKLAMA Garanti Sanal POS COM nesnesi yaratılır İşlemde kullanılacak hesap bilgileri tanımlanır. Gösterilen bilgiler test hesabının bilgileridir, kendi hesap bilgileriniz size gönderilen e-posta nın içinde mevcuttur. clientid = mağaza kodu name = kullanıcı adı password = şifre Sanal POS sunucusunun adresi Lütfen değiştirmeyiniz İşlem tipi. PreAuth, PostAuth, Auth, Credit veya Void olabilir. İşlem tipleri ile daha detaylı bilgi Sanal POS yönetim ekranınızın yardım bölümünde mevcuttur. PreAuth, PostAuth, Credit ve Void işlemleri için kaynak (source) işlemin sipariş kodunu göndermeniz gerekmektedir (Sanal POS un hangi işleme bu işlem tipini uygulayacağını bilmesi gerekir). Kart bilgileri. İşlem bilgileri. Subtotal işlem tutarını, currency ise döviz kodunu belirler. Şu anda sadece 792 (TL) desteklenmektedir. COM nesnesinin yukarıda belirlenen işlemi bankaya göndermesini sağlar. 5

Geri dönüşlerin değerlendirilmesi processorder fonksiyonundan dönen parametreler Örnek: retval=pay.processorder DÖNEN DEĞER ANLAMI 1 Garanti Bankası na bağlantı sağlandı ve cevap alındı. 0 İşlem gönderilemedi veya işlem gönderildi ancak cevap alınamadı. pay.xyz şeklinde alınabilecek diğer sonuç bilgileri PARAMETRE OLASI DEĞERLER ANLAMI oid Varchar(256) Gönderilen işlemin sipariş kodu groupid Varchar(256) Gönderilen işlemin grup kodu transid Varchar(256) Gönderilen işlemin işlem kodu code Varchar(6) Onay kodu (6 hane) appr Approved / Declined / Error İşlem sonucu: Approved = onaylandı Declined = banka reddetti Error = Garanti Sanal POS hatası (işlem daha bankaya gönderilmeden hata almış) refno Varchar(12) Referans numarası. err Varchar(2) Hata kodu errmsg Varchar(256) Hata mesajı Başarılı işlem retval : 1 err : 00 errmsg : code : 400626 appr : Approved OrderID: 1072169256488-194.29.214.249-13158 refno : 335710144175 Hatalı kart numarası retval : 1 err : 99 errmsg : The card failed compliancy checks. code : appr : Error OrderID: 1072169305874-194.29.214.249-13160 refno : CVC kodu hatası 6

retval : 1 err : 82 errmsg : Incorrect CVV code : appr : Declined OrderID: 1072169349278-194.29.214.249-13162 refno : Yetkisiz işlem hatası (örneğin taksit yetkiniz olmadan taksit, bonus yetkiniz olmadan bonus gibi) retval : 1 err : 10 errmsg : Reserved code : appr : Declined OrderID: 1072169386657-194.29.214.249-13163 refno : Yetkisiz işlem hatası 2 (bonus yetkisi olmayan bir kredi kartı ile bonus harcanmış) retval : 1 err : 12 errmsg : Invalid transaction code : appr : Declined HostMsg: OrderID: 1072169982267-194.29.214.249-13171 rrn : İşlem sonucu sorgulama Garanti Sanal POS a gönderdiğiniz herhangi bir işlemin sonucunu sorgulayabilirsiniz. Aşağıdaki örnek bu özelliğin nasıl kullanılacağını göstermektedir. Set pay = CreateObject("epayapi.payment") pay.name="payment_kullanıcı_adı" pay.password="payment_kullanıcı_şifresi" pay.clientid="mağaza_kodunuz" pay.host="ccpos.garanti.com.tr" pay.orderresult=0 pay.oid="1066917079636-194.29.214.249-1184": Sorgulamak istediğiniz işlemin sipariş kodu pay.putextra "ORDERSTATUS","SOR" retval=pay.processorder wscript.echo "err: " & pay.err & Chr(13) & "errmsg: " & pay.errmsg & Chr(13) &"appr: " & pay.appr _ & Chr(13) &"OrderID: " & pay.oid & Chr(13) &"rrn: " & pay.refno & Chr(13) &"HostMsg: " & pay.extra("hostmsg") _ & Chr(13) &"AuthCode: " & pay.code & Chr(13) &"Status: " & pay.extra("orderstatus") Taksitli işlem Garanti Sanal POS üzerinden taksitli işlem gönderebilirsiniz. Bunun için pay.subtotal ile ödeme bilgisini set ettiğiniz satırdan önce aşağıdaki satırı eklemeniz gerekir: pay.taksit = 04 : İşlem tutarını 4 takside böler. pay.taksit = 12 : İşlem tutarını 12 takside böler. 7

ÖNEMLİ: Taksitli işlem gönderebilmeniz için şubeniz nezdinde taksitli işyeri başvurusu yapmış olmanız gerekir. Kullanabileceğiniz maksimum ve minimum taksit adetlerini şubeniz ile görüşebilirsiniz. Bonus kazandırma & kullandırma Önemli: Aşağıdaki bölüm sadece Bonus lu işlem yapma yetkiniz varsa geçerlidir. Eğer Bankamız ile Bonus programına katılmak için resmi bir sözleşme imzalamadıysanız Bonus yetkiniz yoktur. Bu durumda aşağıdaki bölümü geçebilirsiniz. Garanti Sanal POS üzerinden Bonus kazandırabilir ve kullandırabilirsiniz. Bonus kazandırmak için (örnek: 1 milyon 750 bin) pay.kazanbonus = 1750000 Bu tutar işlem gerçekleştiğinde kart sahibinin kartına işlenir. Bonus kullandırtmak için (örnek: 10 milyonluk bir satışta 1 milyon 750 bin Bonus kullanmak istiyorsa) pay.subtotal = 10000000 pay.kullanbonus = 1750000 Banka otomatik olarak kredi kartının kredisinden ve Bonusundan ne kadar çekileceğini hesaplar. Bonus sorgulatmak için Müşterilerinizin birikmiş Bonus larını görebilmeleri için aşağıdaki javascript kodunu kullanarak pop-up açabilirsiniz: function bonuslogin() { window.open("https://form.garanti.com.tr/form/login/bns","login","width=450,height=142,toolbar=no,status=yes,menubar=no,resizable=no"); } 8

Genel işleyiş kuralları Bonus lu işlemler PostAuth ve Credit işlemlerinde normal işlemlerden farklı işler. POSTAUTH CREDIT BONUS KULLANIMI Bonus kullanımlı bir PreAuth a PostAuth işlemi gönderdiğinize, kullanılan Bonus değerini belirleyemezsiniz. Sistem kullanılması gereken Bonus değerini aşağıdaki mantığa göre otomatik olarak belirler. Kişinin PreAuth ta kullanmak istediği Bonus tutarı PostAuth larda mümkün olduğu kadar çabuk harcanır. Örneğin 20 milyonluk bir PreAuth ta 10 milyon Bonus kullanımı gönderildiyse, bunun ardından da bu işleme 10 milyonluk bir PostAuth gönderilirse, sistem 10 milyonluk Bonus kullanımını otomatikman yansıtır. Bundan sonra gelecek PostAuth larda artık kullanılabilecek Bonus kalmadığından, sonraki tutarlar kartın kredisinden çekilir. İade ise yukarıdaki mantığın tam tersi olarak işler. Yani sistem her zaman öncelikle kişinin kullandığı Bonus u değil, kullandığı krediyi iade etmeye çalışır. 20 milyonluk işlemde 8 milyon Bonus kullanıldıysa, 13 milyon iade edildiğinde sistem önce 12 milyon kredi iade eder (çünkü 20-8 = 12 milyon kredi, 8 milyon Bonus kullanılmış). Aynı işlemde 12 milyon kredinin ardından 1 milyon Bonus iade edilir. Mantık her zaman önce krediyi sonra kullanılan Bonus u iade etmektir. Bunun sebebi tüketicilerin kart borcu olarak yansıyan kredi yi azaltmayı tercih etmelerinden kaynaklanmaktadır. Kullanılan Bonus borç olarak geri dönmediğinden, iadesi daha önceliksizdir. BONUS KAZANIMI Bonus kullanımlı bir PreAuth a PostAuth işlemi gönderdiğinize, kullanılan Bonus değerini belirleyebilirsiniz. Ancak bu şekilde kullandırılan Bonus ların toplamı PreAuth ta belirtilen değeri aşamaz. Aşağıdaki örnekte PostAuth 2 işlemi hata alır. PreAuth * kredi: 100 milyon * kullanılan Bonus: 20 milyon PostAuth 1 * Kredi: 50 milyon * Kullanılan Bonus: 15 milyon PostAuth 2 * Kredi: 20 milyon * Kullanılan Bonus: 10 milyon!!! Kazanılan Bonus ların toplamı esas işlemin %25 ini geçemez!!! Yukarıdaki işleyiş geçerlidir. Credit işleminde iade edilmesi gereken Bonus Kazanım tutarı belirtilebilir. Bu tutar esas işlemde kazanılan Bonus u aşamaz. 9

IV. Problemler ve Çözümler Bağlantı kurulamıyor PROBLEM ÇÖZÜMÜ Sunucunuzun ccpos.garanti.com.tr adresine 443 no lu port üzerinden bağlantı kurabildiğini test etmelisiniz. Sunucunuz üzerinde bir komut kipi başlatarak telnet ccpos.garanti.com.tr 443 yazıp enter a basınız. Eğer boş ekran üzerinde imleç yanıp sönüyorsa bağlantı var demektir. Server.CreateObject("epayapi.payment") veya pay.processorder satırlarında hata alıyorsunuz. İşlemleriniz 12 hatası alıyor Bazen cevap alabiliyorsunuz ancak işlemleriniz sık sık timeout a düşüyor Timeout a düşen işlemler belirsiz durumda kalıyor Eğer hata mesajı alırsanız büyük ihtimalle firewall / proxy ayarlarınız bu erişimi engellemektedir veya bir şekilde gereken adrese erişim sağlanamamaktadır (örn. bağlantı problemi olabilir). Bir yetki problemi yaşanıyor. Sunucunuz COM nesnesine dışarıya erişim hakkını vermiyor. 1) Daha önce kurulmuş olan ssllib.dll ve epayapi.dll dosyalarini regsvr32 -u parametresi ile unregister ediniz. 2) Web serveri restart ediniz. 3) ssllib.dll ve epayapi.dll dosyalarini regsvr32 komutu ile register ediniz. 4) Bu dll dosyalarinin bulunduğu klasöre IWAM_machinename için execute ve read file permitionun verildiğini kontrol ediniz. 5) Bu 2 dll dosyasina IWAM_machinename için read file permition verildiğini kontrol ediniz. Bu adımlar problemi çözmediyse: "IIS application protection" seviyesi sorun yaratıyor olabilir. Varsayılan setting "medium"dur. Fakat bu seviyede dll port açamayabilir. "Application protection" seviyesini "high" veya "low" şeklinde değiştirmeniz gerekebilir. Yanlışlıkla taksit ve/veya bonus kullanım/kazanım değerleri gönderiyor olabilirsiniz. Lütfen sadece zorunlu alanları set ederek yeniden deneyiniz. Eğer sorun çözülmezse, test.asp ye aynı kart bilgilerini yazıp çalıştırmayı deneyiniz. Eğer bu şekilde denediğinizde test.asp hata almıyor ise kendi kodunuz ile karşılaştırınız. Mutlaka fazladan bir parametre veya eksik bir değer bulacaksınız. Büyük ihtimalle sunucunuz ile ccpos.garanti.com.tr arasındaki erişim aksıyor. Örneğin belirli bir ttnet node unda yoğun paket kaybı olabilir. Mutlaka farklı dial-up bağlantılar üzerinden deneyip sonuçları inceleyiniz. Eğer her ISP üzerinden aynı problem yaşanıyorsa COM nesnesi sunucunuzda sağlam çalışamıyor veya network/sunucunuzda başka bir problem olabilir. Bizimle bağlantıya geçmenizi öneririz. Bu durumda çözüme iki noktadan yaklaşmak gerekir: 1. Timeout nasıl detect edilecek? 2. Detect edildiğinde ne yapılacak? Birinci sorunun farklı cevapları olabilir. DLL in işleyişini başka bir proses üzerinden denetleyebilir veya her işlem gönderdiğinizde tabloya bir kayıt, cevabı geldiğinde ikinci kayıt atayabilirsiniz. Böylece cevabı gelmeyen işlemlerin timeout a düştüklerini anlarsınız. Timeout a düşen işlem belirlendiğinde ise işlem sorgulama özelliğini kullanabilirsiniz. Bunun nasıl yapılacağını Teknik Kurulum ve Kullanım bölümünde görebilirsiniz. 10

V. COM Nesne Fonksiyonları ve Alanlar Bu bölümde COM nesnesi hakkında detaylı bilgi bulabilirsiniz. COM nesne fonksiyonları additem(bstr id, BSTR desc, BSTR price, BSTR quantity,bstr itemnumber,bstr productcode,bstr total); Verilen parametreler ile bir ürünü sepete ekler Id Desc Price Quantity ItemNumber Productcode Total siparişe eklenen item'in id'si siparişe eklenen item için açıklama item fiyatı item adedi ürün sıra numarası ürün kodu toplam tutar putextra(bstr FieldName,BSTR FieldValue) FieldName adında, FieldValue değerinde extra field ekler Extra(BSTR FieldName) FieldName adındaki Extra field'ın değerini döndürür processorder() İşlemi Garanti Bankası na gönderir ve cevabı bekler. COM Nesne alanları Zorunlu alanlar (her siparişte bulunması gereken) ALAN AÇIKLAMA ÖNERİLEN DEĞER host Garanti Bankası Sanal POS un adresi ccpos.garanti.com.tr name Payment yetkilerine sahip kullanıcı adı *** bkz. şifre mail iniz *** password Bu kullanıcının şifresi *** bkz. şifre mail iniz *** clientid Garanti Sanal POS hesabınızın mağaza kodu *** bkz. şifre mail iniz *** orderresult İşlem modu mutlaka 0 olmalıdır! chargetype İşlem tipi Not: işlem tipleri ile daha detaylı yardım için lütfen Sanal POS yönetim ekranınızın yardım bölümünde bulunan kullanım bilgileri ni inceleyiniz. Auth (satış), Pre- Auth (ön-otorizasyon), Post-Auth ( postotorizasyon), Credit ( iade), Void (iptal) cardumber Kredi kart numarası Örnek: 1111222233334444 expmonth Son kullanım tarihi => ay 01 = Ocak, 12 = Aralık expyear Son kullanım tarihi => yıl İki haneli. 2004 = 04 cv2 Kredi kartlarının arka yüzeyindeki 3 haneli güvenlik kodu Örnek: 123 11

subtotal İşlem toplamı Örnek: 5 milyon = 5000000 currency Döviz kodu mutlaka 792 olmalıdır! Opsiyonel (isteğe bağlı) alanlar ALAN AÇIKLAMA ÖNERİLEN DEĞER oid Sipariş kodu Varchar(256) groupid Grup kodu Varchar(256) transid İşlem kodu Varchar(256) Not: yukarıdaki 3 id eğer boş gönderilirse sistem tarafından üretilir. Post-Auth, Credit veya Void işlemlerinde ana işlemin oid sini göndermeniz gerekmektedir. İşlem tipleri ve id ler hakkında daha detaylı bilgi için Sanal POS unuzun yardım bölümünde bulunan bilgi dokümanlarından faydalanabilirsiniz. ip Siparişi veren kişinin IP adresi Örnek: 127.0.0.1 userid Siparişi veren kişinin kullanıcı adı Örnek: ayilmaz92 email Siparişi veren kişinin e-posta adresi Örnek: abc@abc.com phone Siparişi veren kişinin telefon numarası Örnek: 2129876543 bname Siparişi veren kişinin fatura adı Varchar(256) baddr1...fatura adresi (satır 1) Varchar(256) baddr2...fatura adresi (satır 2) Varchar(256) baddr3...fatura adresi (satır 3) Varchar(256) bcity...fatura şehri Varchar(32) bzip...fatura posta kodu Varchar(7) bstate...fatura state (ilçe) Varchar(32) sname Siparişi veren kişinin sevkiyat adı Varchar(256) saddr1...sevkiyat adresi (satır 1) Varchar(256) saddr2...sevkiyat adresi (satır 2) Varchar(256) saddr3...sevkiyat adresi (satır 3) Varchar(256) scity...sevkiyat şehri Varchar(32) szip...sevkiyat posta kodu Varchar(7) sstate...sevkiyat state (ilçe) Varchar(32) 12

VI. Hata Kodları En sık rastlanan hata kodları HATA KODU HATA MESAJI AÇIKLAMA 99 The card failed compliancy checks Kredi kart numarası geçerli değil 99 The card has expired Kart son kullanım tarihi mantıksız 99 Insufficient permissions to perform requested operation Kullanıcı hatası (belirli bir işlem yaparken o işleme yetkisi olmayan bir kullanıcı kullanılmış. Mağaza kodunu, kullanıcı adını ve şifresini gözden geçiriniz.) 99 Value for element 'Total' is not valid. Currency kodu hatalı 93 Transaction cannot be completed (violation of law) İşleyiş kurallarından biri çiğnendi. Büyük ihtimalle Bonus kullanımı / kazanımı ile ilgili 54 Expired Card Kart son kullanım tarihi hatalı 51 Not sufficient funds Yetersiz bakiye 82 Incorrect CVV CVV kodu kart sahibi banka tarafından reddedildi 10 Reserved Yetkisiz işlem (büyük ihtimalle tanımsız taksit adedi) 93 Transaction cannot be completed (violation of law) İşleyiş kurallarından biri çiğnendi. Büyük ihtimalle Bonus kullanımı / kazanımı ile ilgili 12 Invalid transaction Geçersiz işlem (büyük ihtimalle Bonus yetkisi olmadan Bonus kullanılmaya çalışıldı) Tüm hata kodları 1 Bankasındanprovizyonalınız. 2 Bankasındanprovizyonalınız.(VISA) 3 ÜyeİşyeriKategoriKoduHatalı. 4 KartaElkoyunuz!!! 5 İşlemonaylanmadı. 6 İsteminizKabulEdilmedi. 7 KartaElKoyunuz. 8 KIMLIğINIKONTROLEDEREKİşLEMIYAPıNıZ. 9 KartYenilenmiş.Müşteridenisteyin 11 İşlemGerçekleştirildi(VIP). 12 Geçersizişlem. 13 Geçersiztutar. 14 KartNumarasıHatalı. 15 Bankasıbulunamadı/IEMroutingproblem. 16 Bakiyeyetersiz.Yarıntekrardeneyin. 17 İşlemİptalEdildi. 18 KapalıKart.Tekrardenemeyin. 19 BirKereDahaProvizyonTalepEdiniz. 21 İşlemiptaledilemedi. 25 BöyleBirBilgiBulunamadı. 28 Orijinalirededilmiş/Dosyaservisdışı. 29 İptalyapılamadı.(Orjinalibulunamadı) 30 MesajınFormatıHatalı. 31 Issuersign-onolmamış. 32 İşlemKısmenGerçekleştirilebildi. 33 KartınSüresiDolmuş!KartaElKoyunuz. 34 MuhtemelenÇalıntıKart!!!ElKoyunuz. 36 SınırlandırılmışKart!!ElKoyunuz. 13

37 LütfenBankaGüvenliğiniArayınız. 38 ŞifreGirişLimitiAşıldı!!ElKoyunuz. 39 Kredihesabıtanımsız. 41 KayıpKart!!!KartaElKoyunuz. 43 ÇalıntıKart!!!KartaElKoyunuz. 51 Hesapmüsaitdeğil. 52 ÇekHesabıTanımsız. 53 HesapTanımsız. 54 VadesiDolmuşKart. 55 ŞifresiHatalı. 56 BuKartMevcutDeğil. 57 KartSahibiBuİşlemiYapamaz. 58 Buişlemiyapmanızamüsadeedilmiyor. 61 Paraçekmelimitiaşılıyor. 62 KısıtlıKart/Kendiülkesindegeçerli. 63 BuİşlemiYapmayaYetkiliDeğilsiniz 65 GünlükİşlemAdediDolmuş. 68 CevapÇokGeçGeldi.İşlemiİptalEdiniz. 75 ŞifreGirişLimitiAşıldı. 76 Şifrehatalı.ŞifreGirişLimitiAşıldı. 77 Orjinalişlemileuyumsuzbilgialındı. 78 AccountBalanceNotAvailable. 80 HatalıTarih./Networkhatası. 81 Şifreleme/YabancıNetworkhatası. 82 HatalıCVV./Issuercevapvermedi. 83 ŞifreDoğrulanamıyor./İletişimhatası. 85 HesapDoğrulandı. 86 Şifredoğrulanamıyor. 88 Şifrelemehatası. 89 Authenticationhatası. 90 GünsonuİşlemleriYapılıyor. 91 Bankasınaulaşılamıyor. 92 İşlemgerekliyereyönlendirilemedi. 93 HukukiNedenlerleİşleminizRededildi. 94 DuplicateTransmission. 95 GünlükToplamlarhatalı/İptalrededildi 96 SistemHatası. 98 DuplicateReversal. 14

VII. İletişim Lütfen teknik destek birimimizle bağlantıya geçmeden bu dokümanın tümünü dikkatlice okuyunuz. Problemlerin büyük çoğunluğu buradaki bilgilerle kolaylıkla çözülebilir. Destek birimimize gereksiz yere aktarılan her problem sizlere daha iyi hizmet vermemizi zorlaştırmaktadır. Teknik destek almak için aşağıdaki iletişim kanallarını kullanabilirsiniz. 1. Sanal POS yönetim ekranlarınızın Yardım bölümünde bulunan online destek fonksiyonunu 2. eticaret@garanti.com.tr e-posta adresimizi 3. 444 0 333 no lu telefonumuzu (adım 5, 2 ve 2) 15