Garanti Pay Nedir?

• GarantiPay internet alışverişlerinde müşterinin kart bilgilerini firmayla paylaşmadığı, BonusFlaş uygulaması içinde yer alan hızlı ve kolay bir ödeme yöntemidir.

• İnternet alışverişi sırasında, ödeme seçenekleri adımında bir check out alternatifi olarak yer alır.

• GarantiPay seçeneğini check out sayfasında görünür yerlerde konumlandırmak GarantiPay sadık kullanıcılarının firmada kolayca işlem yapabilmesini sağlar.

• Hem e-commerce(in-web) işlemlerde, hem de m-commerce(in-app) işlemlerde müşteriler bu deneyimi yaşayabilir.

• GarantiPay check out seçildiğinde, müşteri BonusFlaş’a yönlendirilir, işlemini BonusFlaş içinden sonlandırır.

• Müşteri GarantiPay içinden ödemesini tamamlarken Garanti veya diğer banka kartlarını kullanabilir. Aynı zamanda Alışveriş Kredisi ile de ödemesini gerçekleştirebilir. Alışveriş kredisi firmada banka kartı işlemi olarak görünür. Bu sayede müşterinin tüm ödeme ihtiyaçlarına tek yerden çözüm sunar.

Garanti Pay‘in Müşterilerimiz ve Üye İşyerlerimize Faydaları:

• Müşterilerimize kolay, hızlı ve güvenli bir ödeme deneyimi sağlar.

• Müşterilerimizin işlem esnasında cüzdanlarını ve kartlarını yanlarında bulundurma ihtiyacını ortadan kaldırır.

• Ödeme işlemi sırasında kart bilgilerinin üye işyerleri ile paylaşılması ihtiyacı ortadan kaldırır.

• OneClickPayment yapısını kullanmak isteyen ama kart bilgilerini saklamak istemeyen üye işyerlerimiz için bu yapıyı hem mobil uygulamalarından hem de web sitelerinden yapılacak ödemeler için sağlar.

• Mobil Uygulama üzerinden de ürün ve servislerini sağlayan üye işyerlerimize de ödeme çözümü sağlar. Mobil Uygulama üzerinden kredi kartı bilgisinin manuel girişi ile ödemenin yapıldığı yapıya göre işlem sürelerini %70 oranında kısaltarak kullanıcı deneyimine olumlu katkı sağlar.

Örnek Firma Rakamları:

• Alışveriş sıklığını %47 artırır.
• Müşteri başına %56 daha fazla ciro
• Kullanan müşterilerin %88'i tekrar kullanır
• Görünür olduğu firmalarda %30 ciro payı yakalar

Test, Entegrasyon ve Üretim Ortamı URL Bilgileri

IP Tanımları

TEST ve PROD ortamda işlem gönderebilmek, test BonusFlaş uygulamasını indirebilmek için IP tanımlamanız tarafımızca yapılmalı, size işlem cevaplarını dönebilmemiz için firewall kullanıyorsanız bankamız aşağıdaki IP’lerine izin vermeniz gereklidir.

İzin vermeniz gereken bankamız IP bilgileri:

217.68.208.0/20 ; 194.29.208.0/21 ; 91.188.192.0/22 ve 193.218.113.0/24

Tarafımıza iletmeniz gereken IP bilgileri aşağıdadır.

TEST ortamında işlem yapabilmeniz için sabit sunucu IP bilginiz: ………………………………………………………

TEST BonusFlaş uygulamasını indirebilmeniz için sabit IP bilginiz: ………………………………………………………

(Bu alanda cep telefonunuzun bağlı olduğu sabit wifi IP adresi iletilmelidir.)

PROD ortamda işlem yapabilmeniz için sabit sunucu IP

bilginiz: …………………………………………………………

Test BonusFlaş ortamı için IP kayıtlarınız yapıldıktan sonra aşağıdaki bilgiler ile test BonusFlaş uygulamasını indirebilir ve BonusFlaş üzerinden ödeme işlemlerinizi tamamlayabilirsiniz.

Uygulama Test Linkleri:

Android ve IOS:
https://bonusgw-tst.garanti.com.tr/bonusapp/downloadBonusApp.json

İş yeri web sitesinden veya akıllı telefon uygulaması üzerinden ödeme başlatılmasına göre iki farklı GarantiPay akışı mevcuttur. Bu akışlara Web2App ve App2App denilmektedir.

App2App Akışı

GarantiPay işleminin iş yeri akıllı telefonu üzerinden başlatıldığı akıştır. App2App akışında, müşteri iş yeri akıllı telefon uygulamasından ödeme seçenekleri adımında Garanti Pay ile Öde seçeneğini seçerek ilerletir. Akış ve mesajların detayları aşağıda ilgili bölümdedir. Akış diyagramı:

Web2App Akışı

GarantiPay işleminin iş yeri web sitesi üzerinden başlatıldığı akıştır. Web2App akışında, müşteri iş yeri web sayfasında ödeme seçenekleri adımında GarantiPay ile Öde seçeneğini seçerek ilerletir. Akış ve mesajların detayları aşağıda ilgili bölümdedir. Akış diyagramı:

Mesaj Signature

Ecommerce API Platform mesajların doğruluğunu kontrol etmek için JWS (Json Web Signature) standardını kullanır. JWS, JSON veri yapılarının dijital imzalar veya Hash tabanlı Mesaj Kimlik Doğrulama Kodları (HMAC'ler) ile içerikte değişiklik olup olmadığının kontrolünü sağlar. JWS de kullanılmak için gereken şifreleme bilgileri JWK (Json Web Key) formatında sanalpos admin ekranları üzerinden herbir terminal için ayrı olarak alınır. JWK, bir şifreleme anahtarını temsil eden bir JSON yapısıdır. JWK dosyasının içinde kullanılan anahtarın özellikleri ve bilgisi vardır. Ecommerce API Platformda bir JWK dosyası sadece bir terminal ile ilişkilidir. Yeni bir JWK dosyası üretilmesi durumunda eski JWK dosyası 48 saat daha geçerlidir. Bu süre içinde iş yerinin mevcut JWK dosyalarını güncellemesi gerekir. 48 saat sonra sisteme eski JWK bilgileri ile gelen istekler Ecommerce API platform tarafından kabul edilmez.

JWS ile mesajı imzalamak için sanalpos admin ekranlarından alınan JWK dosyası bir dizin, veri tabanı veya bir kasa programından okunmalıdır. Kasa programı kullanan iş yerlerinin mutlaka JWK dosyalarını bu kasalarda tutması önerilir. JWK dosyasının okunması için bir çok programlama dilini destekleyen nimbus-jose kütüphanesi kullanılabilir. İlk olarak JWK dosya okunarak JWK objesi oluşturulur. Bu JWK objesi ile de JWS header ı oluşturulur. JWS header oluşturulurken JWK key id si mutlaka JWS header bilgisine eklenmelidir. Oluşan JWS header ve mesaj payload birlikte JWSObject oluşur ve bilgiler imzalanır. JWSObject imzalandıktan sonra gönderilecek isteğin http body sine direkt yazılır ve ilgili Ecommerce API Platform adresine gönderilir.