Mavibot'ta Garanti BBVA (Sanal POS) ödeme sistemini kullanmak için bankadan sanal POS terminal bilgilerini almanız ve entegrasyon ayarlarına girmeniz gerekir. Ödeme, bankanın güvenli sayfasında 3D Secure onayı ile işlenir.

Bilgilerin Alınması

Garanti BBVA ile Sanal POS hizmeti için bir sözleşme imzalayın. Hizmeti etkinleştirirken, bankadan terminaliniz için Ortak Ödeme özelliğini etkinleştirmesini isteyin. Bu özellik olmadan, bankanın ödeme sayfası üzerinden yapılan ödemeler çalışmaz.

Banka size aşağıdakileri sağlayacaktır:

  • Üye İşyeri No — üye işyeri numaranız;
  • Terminal ID — terminal numaranız;
  • Provizyon Kullanıcı Adı — provizyon kullanıcı adı (genellikle PROVAUT veya PROVOOS);
  • Provizyon Şifresi — provizyon kullanıcı şifresi.

Mağaza Anahtarı (3D Secure anahtarı), Sanal POS yönetim panelinde (Yönetim → 3D Secure) sizin tarafınızdan oluşturulur. Entegrasyon için de gerekli olduğundan kaydettiğinizden emin olun.

Garanti BBVA Mavibot'a nasıl bağlanır?

Mavibot'un Acquiring bölümünde Garanti BBVA'yı seçin ve aşağıdaki bilgileri girin:

  • Üye İşyeri No — üye işyeri numaranız.
  • Terminal ID — terminal numaranız.
  • Provizyon Kullanıcı Adı — provizyon kullanıcı adı. Boş bırakılırsa PROVAUT kullanılır.
  • Provizyon Şifresi — provizyon kullanıcı şifresi.
  • Mağaza Anahtarı — 3D Secure anahtarınız.
  • Mağaza Adı — bankanın ödeme sayfasında müşterilere görüntülenen ad. Boş bırakılırsa "Online mağaza" gösterilir.
  • Test Modu — entegrasyonu bankanın test bilgileriyle test etmek için bu seçeneği etkinleştirin. Canlı ö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

Hesap Makinesi işlevi:

get_garanti_payment_url(amount, description, currency, customer_email, language)

Parametreler:

Parametre Açıklama Gerekli Varsayılan / İzin Verilen Değerler
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

İşlev bir ödeme URL'si döndürür.

Bir Düğmede Ödeme Bağlantısı

Ödeme bağlantısı olan bir düğme göndermek için Ödeme düğme türünü seçin ve ödeme sağlayıcısı olarak Garanti BBVA'yı 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ı ve kullanıcının ihtiyaç duyduğu tanıtım bilgilerini görüntülemek için kullanılır.

Adım 2. Aşağıda gösterilen bloğu oluşturun.

Adım 3. Bağlantı ayarlarına gidin.

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 girin.

Adım 4. İkinci bloktaki mesajı girin.

Adım 5. Üçüncü bir blok oluşturun ve ikinci ile üçüncü blok arasındaki Bağlantı ayarlarını açın.

Bir sonraki bloğa otomatik olarak geçmek için zamanlayıcıyı etkinleştirin.

Adım 6. Üçüncü blokta, Hesap Makinesi'ne işlevi girin.

Kopyalamak için örnek:

amount = 1000
description = "Ürün1 son derece güvenilir bir üründür!"
link = get_garanti_payment_url(amount, description, none, customer_email, none)

Ödemeleri Türk lirası (TRY) dışında bir para biriminde kabul etmek istiyorsanız, para birimini aşağıda gösterildiği gibi belirtin.

Kopyalamak için örnek:

amount = 1000
description = "Ürün1 son derece güvenilir bir üründür!"
currency = "USD"
link = get_garanti_payment_url(amount, description, currency, customer_email, none)

Örnek 2. Fatura Düğmesi

Bu örnek, Örnek 1 ile neredeyse aynıdır.

Ancak, ödeme bağlantısını oluşturmak için bir işlev içeren üçüncü bir blok oluşturmak yerine, ikinci blokta bir düğme oluşturabilirsiniz.

Açılan pencerede:

  • Düğme metnini girin.
  • Fatura işlevini seçin.
  • Ödeme sağlayıcısı olarak Garanti BBVA'yı seçin.

Ardından aşağıdakileri girin:

  • Ürün Adı.
  • Ödeme Tutarı.
  • Para Birimi (isteğe bağlı).
  • Müşteri Adı Soyadı (isteğe bağlı). Bunu, müşterinin e-posta girişini yapılandırdığınız gibi yapılandırabilirsiniz.
  • Müşteri E-postası — #{customer_email} değişkenini girin.

Ardından Ekle'ye tıklayın.

Ödeme Sonrası Bildirimler

Müşteri ödeme bağlantısını takip edip ödemeyi tamamladıktan sonra, konuşmaya bir bildirim (geri arama) gönderilecektir.

Başarılı bir ödeme için:

SDJ91MTKTT_success 100

Burada:

  • SDJ91MTKTT, Mağaza Anahtarınızın ilk 10 karakteridir.
  • 100 ödeme tutarıdır.

Ödeme başarısız olursa, aşağıdaki bildirim gönderilecektir:

SDJ91MTKTT_fail 100

Başarılı veya Başarısız Ödemeye Yanıt Nasıl Gönderilir

Adım 1. Bir Tetikleyici bloğu oluşturun.

Adım 2. Koşul alanına, her ödemeye tepki vermek istiyorsanız bildirim metnini SDJ91MTKTT_success — ödeme tutarı olmadan — girin.

Bu durumda, Eşleme Türü Anahtar Kelimelere Göre olarak ayarlanmalıdır.

Alternatif olarak, belirli bir ödemeye tepki vermek istiyorsanız Tetikleyici alanına geri arama metninin tamamını girin. Bu durumda, Eşleme Türü Tam Eşleme olarak ayarlanmalıdır.

Başarılı bir ödemeden sonra iş akışına devam etmek istiyorsanız, bir Tetikleyici bloğu yerine bir Başlangıç bloğu oluşturabilir ve bot akışınızı oradan oluşturmaya devam edebilirsiniz.

Başarılı Ödeme Sonrası Müşteri Değişkenleri