Garanti BBVA entegrasyonu iki ayrı işi kapsar: e-ticaret sitesinde kartla ödeme almak için Sanal POS bağlantısı ve hesap hareketlerini, ödemeleri ya da hesap özetini yazılımınıza çekmek için API Store servisleri. Bu yazıda ikisini de resmî geliştirici belgelerine dayanarak anlatıyoruz.
İlgili içerikler: iyzico ödeme entegrasyonu · Luca entegrasyonu · REST API güvenliği
Sanal POS Başvurusu
Garanti BBVA Sanal POS sayfasına göre başvuru İnternet Bankacılığı, sayfadaki form (Garanti müşterisi olmayanlar da kullanabilir) veya şube üzerinden yapılır. Sayfada sayılan koşullar:
- Sitede SSL sertifikası bulunması
- Satışa hazır ürünlerin sitede yer alması
- Mesafeli Satış Sözleşmesi ve Hizmet Sözleşmesi metinlerinin yayında olması
- Vergi levhası ve imza sirküleri gibi belgeler
Kendi ödeme sayfası olmayan işyerleri için Güvenli Ortak Ödeme Sayfası seçeneği de var. Banka sayfasına göre bu modeli kullanan işyeri için SSL zorunluluğu kalkıyor ve ödeme 3D Secure 2.0 altyapısında alınıyor.
Sanal POS Teknik Bilgileri
Teknik belgeler dev.garantibbva.com.tr adresindeki E-Ticaret Developer Portal'da. Belgeler satış, iptal, iade, kapama, sorgulama, ek alanlar, ortak ödeme ve açık kaynak eklentiler başlıklarına ayrılmış.
| Kullanım | Test | Canlı |
|---|---|---|
| Provizyon | https://sanalposprovtest.garantibbva.com.tr/VPServlet | https://sanalposprov.garanti.com.tr/VPServlet |
| 3D Secure | https://sanalposprovtest.garantibbva.com.tr/servlet/gt3dengine | https://sanalposprov.garanti.com.tr/servlet/gt3dengine |
Belgeye göre üye işyeri, sanal POS yönetim panelinde şu kullanıcı ve şifreleri kendisi oluşturur: PROVAUT (satış), PROVOOS, PROVRFN (iade) ve 3D işlemlerinde kullanılan store key. 3D formunda gönderilen başlıca alanlar:
terminalprovuserid,terminalmerchantid,terminalidsecure3dsecuritylevel: belgede3D_PAY,3D_FULL,3D_HALFveCUSTOM_PAYdeğerleri geçiyortxncurrencycode: Türk lirası için 949mode: TEST veya PRODsuccessurlveerrorurl: banka dönüşünün geleceği adreslersecure3dhash: belgeye göre SHA512 ile hesaplanıp büyük harfe çevrilir
API Store: Hesap ve Ödeme API'leri
Garanti BBVA API Store, şirketlerin ve yazılımcıların bankanın servislerini kendi uygulamalarına bağlaması için açılmış bir portaldır (developers.garantibbva.com.tr). Tanıtım sayfasında elektronik hesap özeti, QR ile ödeme ve tahsilat, HGS, ATM ve şube konumları ile çeşitli hesaplama servisleri sayılıyor. Testler sandbox ortamında yapılıyor.
- Uygulama oluşturma: Portalda Manage, Applications, Add Application adımlarıyla uygulama açılır, platform seçilir ve kullanılacak API'ler eklenir. Her API'nin kullanım koşulları ayrı onaylanır.
- Callback adresi: https olmalıdır.
- Anahtarlar: Kayıtta Client ID ve Client Secret üretilir. Uygulama "Pending Approval" durumuna geçer, onaylanınca e-posta gelir.
- Token: OAuth 2.0
client_credentialsakışıylahttps://apis.garantibbva.com.tr/auth/oauth/v2/tokenadresinden alınır.
curl -X POST https://apis.garantibbva.com.tr/auth/oauth/v2/token \
-d grant_type=client_credentials \
-d client_id=CLIENT_ID \
-d client_secret=CLIENT_SECRET \
-d redirect_uri=https://ornek.com/callbackHesap Hareketlerini Muhasebeye Aktarma
Bankanın "Entegrasyon Çözümlerimiz" sayfasında hesap hareketlerini muhasebe programına taşımak için şu seçenekler sayılıyor:
| Yöntem | Ne sağlar |
|---|---|
| MT940 / MT942 ve LUCA formatı | FTP, e-posta veya SWIFT ile günlük, haftalık ya da aylık dosya gönderimi ve otomatik muhasebeleştirme |
| Elektronik Hesap Özeti | Hesap bilgisi ve hesap hareketleri için iki API servisi |
| GoGaranti | LOGO Tiger2 ve GO ile entegrasyon |
| Mikro | Mikro Jump ve Fly ile entegrasyon |
| Tek Ekran | Diğer bankalardaki hareketleri gösterme ve Excel'e indirme |
Luca kullanıyorsanız bankanın LUCA formatlı dosyası doğrudan işinize yarar; ayrıntılar Luca entegrasyonu yazısında.
Sık Sorulan Sorular
Sanal POS için Garanti müşterisi olmak gerekir mi?
Banka sayfasına göre başvuru formunu Garanti müşterisi olmayanlar da kullanabilir. Onay ve koşullar banka değerlendirmesine bağlıdır.
Sanal POS destek için kime yazılır?
Sanal POS sayfasında eticaretdestek@garantibbva.com.tr adresi ve 444 0 339 numarası veriliyor.
Açık bankacılıkla başka bankadaki hesabı görebilir miyim?
Bankanın açık bankacılık sayfasına göre Garanti BBVA Mobil ve İnternet kanallarında başka bankalardaki bakiye, hareket ve kart bilgileri görüntülenebiliyor; verilen onay 6 ay geçerli. Bu, uygulama içi bir özelliktir; kendi yazılımınıza bağlamak için API Store servislerine bakın.
Marka adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen kuruluşlarla bayilik veya ortaklık ilişkisi bulunduğu anlamına gelmez.