Garanti BBVA
Kullanmak için Garanti BBVA (Sanal POS) ödeme sistemini Mavibot, sanal POS terminali kimlik bilgilerini bankadan alıp entegrasyon ayarlarına girmeniz gerekir. Ödeme, bankanın güvenli sayfasında 3D Secure onayı ile işlenir.
Kimlik bilgilerinin alınması
ile bir sözleşme imzalayın Garanti BBVA için Sanal POS (sanal POS) hizmeti. Hizmeti etkinleştirirken bankadan Ortak Ödeme (ortak ödeme sayfası) özelliğini terminaliniz için etkinleştirmesini isteyin. Bu özellik olmadan bankanın ödeme sayfası üzerinden yapılan ödemeler çalışmaz.
Banka size şunları sağlayacaktır:
Merchant ID (Üye İşyeri No) — üye işyeri numaranız;
Terminal ID — terminal ID'niz;
Provizyon Kullanıcı ID — provizyon kullanıcı adı (genellikle PROVAUT veya PROVOOS);
Provizyon Parolası — provizyon kullanıcısının parolası.
Bu Mağaza Anahtarı (3D Secure anahtarı) sizin tarafınızdan Sanal POS yönetim panelinde (Yönetim → 3D Secure) oluşturulur. Kaydettiğinizden emin olun, çünkü entegrasyon için de gereklidir.
Garanti BBVA Mavibot'a nasıl bağlanır?
içindeki Tahsilat bölümünde Mavibot, Garanti BBVA seçin ve aşağıdaki bilgileri girin:
Merchant ID — üye işyeri numaranız.
Terminal ID — terminal ID'niz.
Provizyon Kullanıcı ID — provizyon kullanıcı adı. Boş bırakılırsa, PROVAUT kullanılacaktır.
Provizyon Parolası — provizyon kullanıcısının parolası.
Mağaza Anahtarı — 3D Secure anahtarınız.
Mağaza Adı — bankanın ödeme sayfasında müşterilere gösterilen ad. Boş bırakılırsa, "Online mağaza" görüntülenecektir.
Test Modu — bu seçeneği bankanın test kimlik bilgilerini kullanarak entegrasyonu test etmek için etkinleştirin. Gerçek ödemeleri işlemek için bu seçenek devre dışı bırakılmalıdır.
Entegrasyon artık tamamlandı.
Ödeme Bağlantısı Oluşturma
Hesaplayıcı fonksiyonu:
get_garanti_payment_url(amount, description, currency, customer_email, language)
Parametreler:
amount
Ödeme tutarı.
✅
—
description
Ödeme açıklaması.
Hayır
—
currency
Ödeme para birimi.
Hayır
TRY (varsayılan). Desteklenen değerler: TRY, USD, EUR, GBP, JPY
customer_email
Müşterinin e-posta adresi.
Hayır
—
language
Ödeme sayfasının dili.
Hayır
tr (varsayılan). Desteklenen değerler: tr, en
Fonksiyon bir ödeme URL'si döndürür.
Bir Butonda Ödeme Bağlantısı
Ödeme bağlantısı içeren bir buton göndermek için, Ödeme buton türünü seçin ve Garanti BBVA ödeme sağlayıcısı olarak seçin. Ardından ürün adını, ödeme tutarını ve gerekirse ödeme para birimini girin.
Örnek 1: İş Akışı Yapılandırması
Adım 1. Bir Başlangıç bloğu oluşturun.
Başlangıç bloğu genellikle iş akışındaki ilk karşılama mesajını, ayrıca kullanıcının ihtiyaç duyduğu giriş bilgilerini göstermek için kullanılır.
Adım 2. Aşağıda gösterilen bloğu oluşturun.
Adım 3. şuraya gidin: Bağlantı ayarları.
Müşterinin geçerli bir e-posta adresi girdiğini doğrulamak için aşağıdaki düzenli ifadeye ihtiyacınız olacak:
^[-\w.]+@([A-z0-9][-A-z0-9]+.)+[A-z]{2,4}$
Ayrıca, Kullanıcı veri girer seçeneğini etkinleştirin ve customer_email.
Adım 4. Mesajı ikinci bloğa girin.
Adım 5. Üçüncü bir blok oluşturun ve Bağlantı ikinci ve üçüncü bloklar arasındaki ayarları açın.
Sonraki bloğa otomatik geçiş için zamanlayıcıyı etkinleştirin.
Adım 6. Üçüncü blokta fonksiyonu Hesaplayıcı.
Kopyalamak için örnek:
Başka bir para biriminde ödeme kabul etmek istiyorsanız Türk lirası (TRY), para birimini aşağıda gösterildiği gibi belirtin.
Kopyalamak için örnek:
Örnek 2. Faturalandırma Butonu
Bu örnek neredeyse Örnek 1.
ile aynıdır. Ancak ödeme bağlantısı oluşturma işlevine sahip üçüncü bir blok oluşturmak yerine, ikinci blokta bir buton oluşturabilirsiniz.
Açılan pencerede:
Buton metnini girin.
Seçin Faturalandırma işlevini.
Seçin Garanti BBVA ödeme sağlayıcısı olarak.
Ardından aşağıdakileri girin:
Ürün Adı.
Ödeme Tutarı.
Para Birimi (isteğe bağlı).
Müşterinin Tam Adı (isteğe bağlı). Bunu, müşterinin e-posta girişini yapılandırdığınız şekilde yapılandırabilirsiniz.
Müşteri E-postası — değişkeni girin
#{customer_email}.
Ardından Ekle'ye tıklayın.
Ödemeden Sonra Bildirimler
Müşteri ödeme bağlantısını takip edip ödemeyi tamamladıktan sonra sohbete bir bildirim (callback) gönderilecektir.
Başarılı bir ödeme için:
Burada:
SDJ91MTKTTsizin Mağaza Anahtarı.100ödeme tutarıdır.
Ödeme başarısız olursa, aşağıdaki bildirim gönderilecektir:
Başarılı veya Başarısız Bir Ödemeye Nasıl Yanıt Gönderilir
Adım 1. Bir Tetikleyici bloğu oluşturun.
Adım 2. Koşul alanına bildirim metnini girin SDJ91MTKTT_success — ödeme tutarı olmadan — her ödemeye tepki vermek istiyorsanız.
Bu durumda Eşleşme Türü olarak ayarlanmalıdır Anahtar Sözcüklerle.
Alternatif olarak, belirli bir ödemeye tepki vermek istiyorsanız tetikleyici alanına tüm callback metnini girin. Bu durumda Eşleşme Türü Tam Eşleşme olarak ayarlanmalıdır.
Başarılı bir ödemeden sonra iş akışını sürdürmek istiyorsanız, bir Başlangıç bloğu yerine bir Tetikleyici bloğu oluşturup bot akışınızı oradan oluşturmaya devam edebilirsiniz.
Başarılı Bir Ödemeden Sonra Müşteri Değişkenleri
garanti_callback_data
Ödeme sisteminden alınan ödeme bilgileri.
garanti_payment_completed
"True" ödeme başarıyla işlendiyse.
garanti_auth_code
Bankanın işlem yetkilendirme kodu.
Son güncelleme