-
Garantipay 2.0
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
Mobil Entegrasyon
İşyeri App üzerinden Satın Alma Öncesinde BonusFlaş Varlık Kontrolü
Aşağıdaki linkler ile merchant uygulamasında check-out’a gelmeden önce kullanıcının cihazında BonusFlaş’ın yüklü olup olmadığını öğrenebilme imkanı bulunmaktadır. Aşağıdaki URL’ler uygulama varlık kontrolü ve desteklenen platform bilgileri (BonusFlaş’ı download’a yönlendirebilmek için gerekli min OS Version bilgileri) için kullanılabilir. IOS tarafında uygulama varlık kontrolü adına verilen link Deep Link, ancak BonusFlaş uygulamasını çağırırmak için SanalPos üzerinden dönecek link universal link’tir.
“Linklerin dinamik olarak kullanılması, ilerde linke yapılacak bir ekleme olma ihtimaline karşı (GaranitPay’in Cep Şube , Igaranti platformlarında da desteklenme durumu gibi) önerilir. IOS 9 ile beraber gelen durumla ilgili (App Store’a uygulama iletilirken, uygulama içinden açılabilecek linkleri vermek gerektiği için) "iosDeepLink": "iosGarantiBonusFlas://" kısmındaki ios linkini statik olarak kod içine gömerek devam etmek gerekse de ana linkin dinamik kullanımı önerilir.
Test Entegrasyon Bağlantısı:
https://sanalposprovtest.garanti.com.tr/interface/GarantiPayAppList.json
[\n {\n \"id\": \"bonusflas\",\n \"app\": {\n \"androidPackageName\": \"com.garanti.bonusapp.tst\",\n \"androidMinVersion\": \"16\",\n \"iosDeepLink\": \"iosGarantiBonusFlas://\",\n \"iosMinVersion\": \"9.0\"\n }\n }\n]
Prod Entegrasyon Bağlantısı:
[\n {\n \"id\": \"bonusflas\",\n \"app\": {\n \"androidPackageName\": \"com.garanti.bonusapp\",\n \"androidMinVersion\": \"16\",\n \"iosDeepLink\": \"iosGarantiBonusFlas://\",\n \"iosMinVersion\": \"9.0\"\n }\n }\n]
Mobil Redirect Url Bilgisi
GPDatarequest’in cevabında redirect url in tipi mobil ise bonusflash uygulaması ile ilgili bilgiler link içinde xml olarak aşağıdaki yapıda olacaktır.
{ link: \"<AppLinks>\n <Link>\n <ID>1</ID>\n <AndroidPackageName>com.garanti.bonusapp.tst</AndroidPackageName>\n <AndroidClassName>com.garanti.bonusapp.activity.start.StartActivity</AndroidClassName>\n <Parameters>garantiPayId%26345673465%26merchantId%26455677%26terminalId%26105329%26garantiPayType%262%26signature%26eyJraWQiOiI4MTBhZDIwZC0zMjA5LTQxZTMtYTRkNy00N WVkNzg5NmNhODAiLCJhbGciOiJIUzUxMiJ9.eyJncGlkIjoiNTIxMzcxNDYwMjUxNDU0NjUyMzg2MzUwODEiLCJtZXJjaGFudE51bSI6IjYwMzE3NSIsInRlcm1pbmFsTnVtIjoiNjY2NzI5In0.DvDWfw5yge2Fcls66AbCyDvvXekCjKa-NV22ALZYlaKitzndI7CklmUHeIApALrOf1dgYQlxJCscnCaKm5hT_A</Parameters>\n <IOSDeepLink> https://bonusappgw.garanti.com.tr/garantiPay</IOSDeepLink>\n </Link>\n <Link>\n <ID>2</ID>\n <AndroidPackageName>com.garanti.cepsubesi</AndroidPackageName>\n <AndroidClassName/>\n <Parameters>garantiPayId%26345673465%26merchantId%26455677%26terminalId%26105329%26garantiPayType%262%26signature%26eyJraWQiOiI4MTBhZDIwZC0zMjA5LTQxZTMtYTRkNy00NWVkNzg5NmNhODAiLCJhbGciOiJIUzUxMiJ9.eyJncGlkIjoiNTIxMzcxNDYwMjUxNDU0NjUyMzg2MzUwODEiLCJtZXJjaGFudE51bSI6IjYwMzE3NSIsInRlcm1pbmFsTnVtIjoiNjY2NzI5In0.DvDWfw5yge2Fcls66AbCyDvvXekCjKa-NV22ALZYlaKitzndI7CklmUHeIApALrOf1dgYQlxJCscnCaKm5hT_A </Parameters>\n <IOSDeepLink>//cepsube</IOSDeepLink>\n </Link>\n\n <Link>\n <ID>3</ID>\n <AndroidPackageName>com.igaranti</AndroidPackageName>\n <AndroidClassName/>\n <Parameters>garantiPayId%26345673465%26merchantId%26455677%26terminalId%26105329%26garantiPayType%262%26signature%26eyJraWQiOiI4MTBhZDIwZC0zMjA5LTQxZTMtYTRkNy00NWVkNzg5NmNhODAiLCJhbGciOiJIUzUxMiJ9.eyJncGlkIjoiNTIxMzcxNDYwMjUxNDU0NjUyMzg2MzUwODEiLCJtZXJjaGFudE51bSI6IjYwMzE3NSIsInRlcm1pbmFsTnVtIjoiNjY2NzI5In0.DvDWfw5yge2Fcls66AbCyDvvXekCjKa-NV22ALZYlaKitzndI7CklmUHeIApALrOf1dgYQlxJCscnCaKm5hT_A</Parameters>\n <IOSDeepLink>//igaranti</IOSDeepLink>\n </Link>\n</AppLinks>\", \ntype: \"mobil\" \n}
IOS için Banka App Çağrımı
Gelen cevapta bulunan app linklerini sırayla açmayı denenecektir. Xml yapısındaki signature ve parameters alanları url’e query param olarak verilir.
Test: https://bonusappgw.garanti.com.tr/garantiPay?signature=xxxxx&gpayid=345673465&merchantId=455677&terminalId=105329&garantiPayType=2
Prod: https://bonusappgw.garanti.com.tr/garantiPay?signature=xxxxx&gpayid=345673465&merchantId=455677&terminalId=105329&garantiPayType=2
Not: Örnek url’in bu şekilde hem test hem prodda aynı oluşmasının sebebi ios 14 ve üzerinde Apple’ın url doğrulamaya çalışıp iç link olduğundan erişim hatası almasını engellemektir. O nedenle test yapılan cihazlarda kesinlikle Bonusflaş Prod uygulaması bulunmamalıdır yoksa yönlenme doğru şekilde yapılamaz
Android için Banka App Çağrımı
Not: Android GarantiPay akışlarında BonusFlaş açılırken, top-level launcher üzerinden tetiklenme gerekmektedir.
Sanalpos Request sonrası bonus app uygulamasının açılması:
Sanal POS response datasından AndroidPackageName ve AndroidClassName alanından çağırılacak app bilgisi alınır. Signature ve parameters alanları Intent’e bundle içinde verilmelidir.
<AppLinks>\n<Link>\n<ID>1</ID>\n<AndroidPackageName>com.garanti.bonusapp.tst</AndroidPackageName>\n<AndroidClassName>com.garanti.bonusapp.activity.start.StartActivity</AndroidClassName>\n<Parameters>garantiPayId%26345673465%26merchantId%26455677%26terminalId%26105329%26garantiPayType%262%26signature%26eyJraWQiOiI4MTBhZDIwZC0zMjA5LTQxZTMtYTRkNy00NWVkNzg5NmNhODAiLCJhbGciOiJIUzUxMiJ9.eyJncGlkIjoiNTIxMzcxNDYwMjUxNDU0NjUyMzg2MzUwODEiLCJtZXJjaGFudE51bSI6IjYwMzE3NSIsInRlcm1pbmFsTnVtIjoiNjY2NzI5In0.DvDWfw5yge2Fcls66AbCyDvvXekCjKa-NV22ALZYlaKitzndI7CklmUHeIApALrOf1dgYQlxJCscnCaKm5hT_A</Parameters>\n<IOSDeepLink> https://bonusappgw.garanti.com.tr/garantiPay</IOSDeepLink> </Link>\n</AppLinks>
