- Beş yönetim ve sorgu uç noktası: ödeme iptali, komisyon sorgulama, alıcı kaydet, satıcı kaydet, işlem sorgulama
- OAuth2 client-credentials jetonu apis.garantibbva.com.tr üzerinden Iris tarafından alınır ve her istekte Bearer olarak gönderilir
- PAN işleme yok: kart çekimi / 3-D Secure yönlendirme akışı bu API'nin parçası değildir
- Iris ödeme kayıtlarında ödeme sağlayıcısı olarak seçilebilir; rotalar entegrasyon merkezinden onayla denenebilir
- Her çağrının isteği ve yanıtı, bankanın kendi kayıtlarıyla mutabakat için kiracınızda kaydedilir
Garanti BBVA Güvenli Ödeme API Bağlayıcısı
Türk üye işyerleri için Garanti BBVA Güvenli Ödeme API'si — ödeme iptali, komisyon sorgulama, alıcı kaydı, satıcı kaydı ve işlem sorgulama — geliştirici portalı OAuth istemcinizle Apivom Iris'e bağlı: jetonu Iris alır, her çağrı kaydedilir, kart verisi söz konusu değildir.
Neler yapabilirsiniz
Kullanım senaryoları
- Sipariş kaydından ödeme iptali — Bir sipariş aynı gün geri çekildiğinde banka işlemini Iris'ten iptal edin ve bankanın onayını ödeme kaydında tutun.
- Teklif vermeden önce komisyonu bilin — Fatura kesilmeden önce finansa banka ücretini göstermek için tutar ve taksit planı için komisyon sorgusu çalıştırın.
- Bankayla mutabakat — Bir ödemenin banka tarafındaki durumunu doğrulamak ve Iris ile banka ekstresi arasındaki farkları çözmek için işlem sorgulama rotasını kullanın.
Türkiye'nin en büyük bankalarından Garanti BBVA, banka üzerinden tahsilat yapan üye işyerleri için geliştirici portalında bir Güvenli Ödeme API'si yayımlar. Apivom Atlas'ta kataloglanan yüzey yönetim ve sorgu katmanıdır: bir ödemeyi iptal etmek, bir işleme uygulanan komisyonu sorgulamak, alıcı veya satıcı kaydetmek ve bir işlemin durumunu sorgulamak. Beş rotanın tamamı POST işlemidir ve hiçbiri kart numarası taşımaz — 3-D Secure yönlendirmeli asıl kart çekimi bu API'nin dışında ayrı bir banka akışıdır. Apivom Iris seçilebilir bir ödeme sağlayıcısı olarak bağlanır. Kimlik bilgisi, geliştirici portalı uygulamanızın istemci kimliği ve istemci sırrıdır; Iris OAuth2 client-credentials alışverişini bankanın jeton uç noktasına karşı gerçekleştirir ve kısa ömürlü Bearer jetonunu her istekle gönderir; böylece sır kiracınızdan çıkmaz ve Apivom Atlas hiçbir şey saklamaz. Operatörler rotaları entegrasyon merkezinden onay adımıyla çalıştırır; her istek ve bankanın yanıtı kiracınızda kaydedilir.
Garanti BBVA geliştirici portalından OAuth2 istemci kimlik bilgileri (client_id + client_secret). Iris bankanın jeton uç noktasını kendisi çağırır ve elde edilen Bearer jetonunu her istekte gönderir; sır Iris kiracınızda şifreli kalır ve Apivom Atlas'a asla gönderilmez.
Sık sorulan sorular
Bu bağlayıcı üzerinden kart çekimi yapabilir miyim?
Hayır. Bu API yalnızca iptal, komisyon sorgulama, alıcı ve satıcı kaydı ile işlem sorgulamayı kapsar. 3-D Secure yönlendirmeli kart çekim akışı, bu katalogun parçası olmayan ayrı bir Garanti BBVA entegrasyonudur.
OAuth jetonu nasıl yönetilir?
Iris istemci kimliğiniz ve istemci sırrınızla bankanın OAuth2 uç noktasından jeton ister ve her çağrıda Bearer jetonunu gönderir. Sır kiracınızda şifrelidir; Apivom Atlas iletilen istekte yalnızca kısa ömürlü jetonu görür ve çağrıyı kaydeder.
Apivom bu bağlayıcı için API çağrısı başına ücret alır mı?
Hayır. Bağlayıcılar Apivom kiracınızın parçasıdır ve Atlas portalında ölçümlenmez. Bağladığınız hesapta sağlayıcının kendi fiyatlandırması, kotaları ve hız sınırları geçerli olmaya devam eder — Apivom çağrılarını bu sınırların içinde kalacak şekilde hızlandırır ve her çağrıyı kiracınızın entegrasyon günlüğünde gösterir.
Kimlik bilgilerim nerede saklanır, trafiği kim görür?
Apivom Atlas durumsuz bir geçittir: sağlayıcı kimlik bilgilerini veya jetonları asla saklamaz. Bağlanan Apivom ürünü kimlik bilgisini kiracı veritabanınızda şifreli tutar; her istek ve yanıt yalnızca kiracınızda kaydedilir — verileriniz kiracılar arasında asla paylaşılmaz.
Diğer Atlas entegrasyonları
AI entegrasyon rehberi (llms.txt)
Makine tarafından okunabilir markdown — AI asistanınıza entegrasyon talimatı olarak verin.