• Garantipay 2.0

Garantipay 2.0

Filtrele

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

Test Entegrasyon Üretim
https://garantipay- test.garantibbva.com.tr https://garantipay- integration.garantibbva.com.tr https://garantipay.garantibbva. com.tr

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.

Müşteri No TCKN Parola
33838408 10033838408 147852

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ı:

Order INQ İsteği

İş yerleri işlem sonuçlarını sorgulamak istediğinde Ecommerce API Platform sipariş sorgu isteğini kullanabilir. İş yerleri zaman aşımı hatası veya başka bir hata aldığında da başarılı bir işlem için de sipariş sorgusu gönderebilir.

HTTP Metod URL
POST /api/payment/v0/inquiry

İstek Parametreleri

Parametre Adı Tipi Zorunlu Açıklama
 meta  Meta  Evet  İstekle ilgili meta verileri içerir.
data Data Evet API Platformun genel işlem veri tipidir.

Meta

Parametre Adı Tipi Zorunlu Açıklama
 id  String  Evet Her işlem için üretilen universal unique ID (UUID) değeridir.
timestamp Decimal Evet İşlem zamanı bu alanda gönderilir.
source String Evet Ecommerce API Platform source bilgisi
 clientInfo  ClientInfo[]  Evet İşlemi yapan kullanıcı ile ilgili bilgilerin gönderildiği alandır. ClientIp, ServerIp, UserId, Email, Channel bilgileri gönderilmelidir.

ClientInfo

Parametre Adı Tipi Zorunlu Açıklama
 type  String  Evet Kullanıcı bilgisinin tipi. Bilgi türleri -> ClientIp, ServerIp, UserId, Channel, Email
value String Evet Kullanıcı bilgisinin değeri.

Data

Parametre Adı Tipi Zorunlu Açıklama
 orderId  String  Evet  Order id bilgisi.

İstek Örneği

{\n \"meta\": {\n \"id\": \"acde070d-8c4c-4f0d-9d8a-162843c10333\",\n \"timestamp\": 1685645139,\n \"source\": \"garantipay\",\n \"clientInfo\": [\n {\n \"type\": \"channel\",\n \"value\": \"WEB\"\n },\n {\n \"type\": \"serverIp\",\n \"value\": \"38.45.490.123\"\n },\n {\n \"type\": \"clientIp\",\n \"value\": \"194.29.214.244\"\n },\n {\n \"type\": \"email\",\n \"value\": \"test@test.com\"\n },\n {\n \"type\": \"userId\",\n \"value\": \"309853331\"\n }\n ]\n },\n \"data\": {\n \"orderId\": \"84593089908345\"\n }\n}

Dönüş Parametreleri

Parametre Adı Tipi Zorunlu Açıklama
id String Evet Her işlem için üretilen universal unique ID (UUID) değeridir.
token String Hayır İşleme ait token bilgisidir.
resultcode String Evet İşlemin sonuç kodudur.
resultMessage String Evet İşleme ait sonuç mesajıdır.
errors Error[] Hayır İşlem sırasında hata oluştu ise oluşan hataların bilgileridir. Örnek mesajlarda bu alan parse işlemleri için dummy olarak doldurulmuştur. Üretim ortamında hata olmadığında bu alan boş olacaktır.

Errors

Parametre Adı Tipi Zorunlu Açıklama
 code  String  Evet  Hata kodu.
 Type  String  Evet  Hata Tipi
message String Evet Hata mesajı

Order

Parametre Adı Tipi Zorunlu Açıklama
orderId String Evet Birincil işlem mesajında gönderilen sipariş bilgisidir.
statusCode String Evet Siparişin son durumudur
finalAmount String Evet Siparişin son tutarıdır.
originalAmount String Evet Siparişin ilk tutarıdır.
currencyNum String Evet Döviz kuru bilgisi. 3 haneli ISO standart kodu. Örnek : 949
orderDate String Evet Siparişin tarihidir.
vposOrderId String Evet İşlemin geçtiği Bankanın order id bilgisi.

Transaction

Parametre Adı Tipi Zorunlu Açıklama
requestId String Evet Siparişteki son işlemin requestId değeridir.
status String Evet Siparişe ait son işlemin son durumudur.
txnAmount String Evet Siparişe ait son işlemin tutarıdır.
txnType String Evet Siparişe ait son işlemin tipidir.
installmentCount String Evet Siparişe ait son işlemin taksit sayısıdır.
transactionDate String Evet Siparişe ait son işlemin tarihidir.
voidInd String Evet Siparişe ait son işlemin iptal durumudur. Y ise işlem iptal edilmiş demektir, N ise işlemde iptal yoktur.
acquirerId String Evet İşlemin yönlendirildiği acquirer bankanın id’sidir.
acquirerReturnCode String Evet Acquirer bankanın döndüğü işlem sonuç kodudur.
reasonCodeExplText String Evet Acquirer bankanın döndüğü işlem sebep kodunun açıklamasıdır.
acquirerReasonCode String Evet Acquirer bankanın döndüğü işlem sebep kodudur.

Card

Parametre Adı Tipi Zorunlu Açıklama
binNumber String Evet Kartın BIN numarasıdır.
maskedNumber String Evet Maskeli kart bilgisidir.

CardHolder

Parametre Adı Tipi Zorunlu Açıklama
gsm String Hayır Kart sahibi telefon numarasıdır.
ip String Hayır Kart sahib ip adresidir.
email String Hayır Kart sahib e-mail adresidir.

AcquirerResponse

Parametre Adı Tipi Zorunlu Açıklama
orderId String Evet Acquier sipariş numarası bilgisidir.(vposOrderId’dir)
statusCode String Evet Siparişin son durumudur.
preAuthAmount String Hayır Ön otorizasyon tutarıdır.
authAmount String Evet Satış tutarıdır.
authDate String Evet İşlem tarihidir.
authCode String Evet Sanalpos tarafından dönülen auth kodu bilgisidir.
txnReturnCode String Evet İşlem sonuç kodudur.
txnRetRefNum String Evet İşleme ait referans numarasıdır.
txnReasonCode String Evet İşlem sebep kodudur.
cardNumberMasked String Evet Maskeli kart bilgisidir.
installmentCount String Evet Siparişe ait taksit sayısıdır.
terminalId String Evet İşlemin geçtiği Sanalpos terminal numarasıdır.
merchantId String Evet İşlemin geçtiği Sanalpos merchant numarasıdır.

İstek Örneği

{\n \"id\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"token\": \"eyJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiUlNBLU9BRVAtMjU2In0.O01BFr_XxGzKEUb_Z9vQOW3DX2cQFxojrRy2JyM5_nqKnrpAa0rvcPI_ViT2PdPRogBwjHGRDM2uNLd1B berKQlaZYuqPGXnpzDQjosF0tQlgdtY3uEZUMT-9WPP8jCxxQg0AGIm4abkp1cgzAWBQzm1QYL8fwaz16MS48ExRz41dLhA0aEWE4e 7TYzjrfaK8M4wIUlQCFIl-wS1N3U8W2XeUc9MLYGmHft_Rd9KJs1c- 9KKdUQf6tEzJ92TGEC7TRZX4hGdtszIq3GGGBQaW8P9jPozqaDdrikF18D0btRHNf3_57sR_CPEGYX0O4mY775CLWqB4Y1adNn-fZ0xoA.ln7IYZDF9TdBIK6i.ZhQ3Q5TY827KFQw8DdRRzQVJVFdIE03B6AxMNZ1sQIjlUB4QUxg- UYqjPJESPUmFsODeshGWLa5t4tUri5j6uC4mFDbkbemPmNKIQiY5m8yc.5KKhrggM Rm7ydVRQKJaT0g\",\n \"timestamp\": 1685673913,\n \"resultCode\": \"00\",\n \"resultMessage\": \"Success\",\n \"errors\": [\n {\n \"code\": \"0\",\n \"type\": \"info\",\n \"message\": \"No error\"\n }\n ],\n \"response\": {\n \"order\": {\n \"orderId\": \"84593089908345\",\n \"statusCode\": \"00\",\n \"finalAmount\": 10,\n \"originalAmount\": 10,\n \"currencyNum\": 949,\n \"orderDate\": \"2021-09-06T06:54:38.196+0000\",\n \"vposOrderId\": \"ORDR74C83D5660004B44A03E30319F51C68B\"\n },\n \"transaction\": {\n \"requestId\": \"7793400DCER234DFG\",\n \"status\": \"00\",\n \"txnAmount\": 10,\n \"txnType\": \"auth\",\n \"installmentCount\": \"0\",\n \"transactionDate\": \"2021-09-06T06:54:38.226+0000\",\n \"voidInd\": \"N\",\n \"acquirerId\": \"62\",\n \"acquirerReturnCode\": \"00\",\n \"acquirerReasonCode\": \"00\",\n \"reasonCodeExplText\": \"Başarılı\",\n \"card\": {\n \"binNumber\": \"554960\",\n \"maskedNumber\": \"554960******7013\"\n },\n \"cardHolder\": {\n \"gsm\": \"5313534207\",\n \"email\": \"Dturan3678@gmail.com\",\n \"ip\": \"176.237.143.99\"\n }\n },\n \"acquirerResponse\": {\n \"orderId\": \"ORDR74C83D5660004B44A03E30319F51C68B\",\n \"statusCode\": \"00\",\n \"preAuthAmount\": 0,\n \"authAmount\": 10,\n \"authDate\": \"2021-09-06 09:54:38.624\",\n \"authCode\": \"688947\",\n \"txnReturnCode\": \"00\",\n \"txnReasonCode\": \"00\",\n \"txnRetRefNum\": \"124906112355\",\n \"cardNumberMasked\": \"554960******7013\",\n \"installmentCount\": \"0\",\n \"terminalId\": \"30690168\",\n \"merchantId\": \"7000679\"\n }\n }\n}
GP Data Status Updated Request >> GP Data Status Updated Request Order Cancel >> Order Cancel

We would love to hear from you. Do you have problems/questions about services ? Send us detailed email about it ?

Send Us a Question Send Us a Question