Mavibot'ta EBANX ödeme platformunu kullanmak için EBANX hesabınızdan Entegrasyon Anahtarınızı almanız ve ödeme ayarlarına girmeniz gerekir.

EBANX, Latin Amerika genelinde yerel ödeme yöntemlerinin bir toplayıcısıdır. Ödemeler, müşterilere ülkelerinde mevcut olan ödeme yöntemlerinin (Brezilya'da PIX ve boleto, Meksika'da OXXO ve SPEI, Kolombiya'da PSE, kredi/banka kartları ve daha fazlası gibi) gösterildiği güvenli bir EBANX tarafından barındırılan ödeme sayfasında işlenir.

Entegrasyon Anahtarını Alma

EBANX ile bir anlaşma imzalayın ve EBANX İşletme Portalı'na (satıcı paneliniz) erişim sağlayın.

Kayıt süreci sırasında, ödeme almak istediğiniz ülkeleri seçin. Müşteriler yalnızca EBANX hesabınızda etkinleştirilen ülkelerden ödeme yapabilecektir.

Entegrasyon ayarlarında, Entegrasyon Anahtarınızı kopyalayın. EBANX'ı Mavibot'a bağlamak için buna ihtiyacınız olacak.

Test amaçları için EBANX, kendi Entegrasyon Anahtarına sahip ayrı bir sandbox hesabı sağlar. Aşağıdaki Test Modu bölümüne bakın.

EBANX'ı Bağlama

Ödeme Sistemleri ayarlarında EBANX'ı seçin ve aşağıdakileri girin:

  • Entegrasyon Anahtarı — kopyaladığınız EBANX Entegrasyon Anahtarınız.
  • Ülke — varsayılan ödeme ülkesi (iki harfli küçük harf ülke kodu: Brezilya için br, Meksika için mx, Kolombiya için co, Şili için cl, Peru için pe, Arjantin için ar, vb.). Bu, müşterilerin ödeme sayfasında göreceği ödeme yöntemlerini belirler. Seçilen ülke EBANX hesabınızda etkinleştirilmelidir.
  • Test Modu — entegrasyonu EBANX sandbox ortamını kullanarak test etmek için bu seçeneği etkinleştirin. Test Modu etkinleştirildiğinde, sandbox hesabınızdan Entegrasyon Anahtarını kullanın. Gerçek ödemeleri kabul etmek için Test Modu'nu devre dışı bırakın ve canlı Entegrasyon Anahtarınızı kullanın.

Kurulum artık tamamlandı.

Ödeme Bağlantısı Oluşturma

Hesap makinesi işlevi:

get_ebanx_payment_url(amount, description, currency, customer_email, full_name, country)

Parametreler

  • amount — ödeme tutarı. Zorunlu.

  • customer_email — müşterinin e-posta adresi. Zorunlu. EBANX bu olmadan ödeme oluşturamaz. Müşteri ayrıca bu e-posta adresine bir ödeme onayı alacaktır.

  • full_name — müşterinin tam adı. Zorunlu.

  • description — ödeme açıklaması. İsteğe bağlı.

  • currency — ödeme para birimi. Aşağıdakilerden birini kullanabilirsiniz:

    • ödeme ülkesinin yerel para birimi (Brezilya için BRL, Meksika için MXN, Kolombiya için COP, Şili için CLP, Peru için PEN, Arjantin için ARS vb.) veya
    • EBANX hesap para biriminiz (genellikle USD), bu durumda EBANX, kendi döviz kurunu kullanarak tutarı dönüştürecektir.

    İsteğe bağlı. Varsayılan değer USD'dir.

  • country — ödeme ülkesi (iki harfli küçük harf ülke kodu). İsteğe bağlı. Atlanırsa, ödeme ayarlarında belirtilen varsayılan ülke kullanılacaktır.

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

Not: Seçilen para birimi, ödeme ülkesiyle uyumlu olmalıdır. Ya ülkenin yerel para birimi ya da EBANX hesap para biriminiz olmalıdır. Örneğin, br (Brezilya) için BRL ve USD geçerlidir, ancak MXN geçerli değildir.

Ödeme Bağlantı Düğmesi

Bir ödeme düğmesi göndermek için Ödeme Düğmesi türünü seçin ve ödeme sistemi olarak EBANX'ı seçin.

Şunları girin:

  • ürün adı;
  • ödeme tutarı;
  • para birimi;
  • müşterinin tam adını ve e-posta adresini içeren değişkenler.

İsteğe bağlı olarak, ödeme ülkesini belirtin.

Ö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 normal 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 = "Product1 is product of great reliability!"
currency = "BRL"
link = get_ebanx_payment_url(amount, description, currency, customer_email, full_name, country)

USD dışında bir para biriminde ödeme kabul etmek istiyorsanız, para birimini aşağıda gösterildiği gibi belirtin.

Ö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 EBANX'ı seçin.

Ardından aşağıdakileri girin:

  • Ürün Adı.
  • Ödeme Tutarı.
  • Para Birimi (isteğe bağlı).
  • Müşteri Tam Adı (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ı açıp ödemeyi tamamladıktan sonra, başarılı ödeme üzerine konuşmaya aşağıdaki geri arama gönderilir:

SDJ91MTKTT_success 100

Burada:

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

Ödeme iptal edilirse, aşağıdaki geri arama gönderilir:

SDJ91MTKTT_fail 100

Çevrimdışı ödeme yöntemleri (boleto, OXXO vb.) için ödeme onayı anında gerçekleşmez. EBANX, geri aramayı yalnızca fonları aldıktan sonra gönderir; bu 1-3 iş günü sürebilir. Geri arama, ödeme onaylandıktan sonra otomatik olarak teslim edilecektir.

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

Değişken Değer
ebanx_callback_data Ödeme sisteminden alınan ödeme bilgisi
ebanx_payment_completed "True" — ödeme başarılı olarak işlendi
ebanx_payment_hash EBANX'taki ödeme kimliği (hash)