EBANX
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öntemlerini bir araya getiren bir toplayıcıdır. Ödemeler, müşterilere ülkelerinde उपलब्ध ödeme yöntemlerinin gösterildiği güvenli bir EBANX barındırmalı ödeme sayfasında işlenir (Brezilya'da PIX ve boleto, Meksika'da OXXO ve SPEI, Kolombiya'da PSE, kredi/banka kartları ve daha fazlası gibi).
Entegrasyon Anahtarını Alma
EBANX ile bir anlaşma imzalayın ve EBANX Business Portal'a (satıcı kontrol paneliniz) erişim sağlayın.
Onboarding sürecinde, ödeme kabul etmek istediğiniz ülkeleri seçin. Müşteriler yalnızca EBANX hesabınızda etkinleştirilmiş ülkelerden ödeme yapabilir.
Entegrasyon ayarlarında Entegrasyon Anahtarınızı kopyalayın. EBANX'i 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'i Bağlama
Ödeme Sistemleri ayarlarında EBANX'i seçin ve aşağıdakileri girin:
Entegrasyon Anahtarı — kopyaladığınız EBANX Entegrasyon Anahtarı.
Ülke — varsayılan ödeme ülkesi (iki harfli küçük harf ülke kodu:
brBrezilya için,mxMeksika için,coKolombiya için,clŞili için,pePeru için,arArjantin için vb.). Bu, müşterilerin ödeme sayfasında hangi ödeme yöntemlerini göreceğini belirler. Seçilen ülke EBANX hesabınızda etkinleştirilmiş olmalıdır.Test Modu — EBANX sandbox ortamını kullanarak entegrasyonu test etmek için bu seçeneği etkinleştirin. Test Modu etkin olduğunda, sandbox hesabınızdaki 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
Hesaplayıcı fonksiyonu:
get_ebanx_payment_url(amount, description, currency, customer_email, full_name, country)
Parametreler
amount — ödeme tutarı. Gerekli.
customer_email — müşterinin e-posta adresi. Gerekli. EBANX onsuz ödeme oluşturamaz. Müşteri ayrıca bu e-posta adresine bir ödeme onayı alacaktır.
full_name — müşterinin tam adı. Gerekli.
description — ödeme açıklaması. İsteğe bağlı.
currency — ödeme para birimi. Aşağıdakilerden birini kullanabilirsiniz:
ödeme ülkesinin yerel para birimi (örneğin
BRL,MXN,COP,CLP,PEN,ARS, vb.), veyaEBANX hesabınızın para birimi (genellikle
USD), bu durumda EBANX tutarı kendi döviz kurunu kullanarak dönüştürür.
İsteğe bağlı. Varsayılan değer
USD.country — ödeme ülkesi (iki harfli küçük harf ülke kodu). İsteğe bağlı. Belirtilmezse, ödeme ayarlarında belirtilen varsayılan ülke kullanılacaktır.
Fonksiyon bir ödeme bağlantısı döndürür.
Not: Seçilen para birimi ödeme ülkesiyle uyumlu olmalıdır. Ya ülkenin yerel para birimi ya da EBANX hesabınızın para birimi olmalıdır. Örneğin, br (Brezilya), BRL ve USD geçerlidir, ancak MXN geçerli değildir.
Ödeme Bağlantısı Düğmesi
Bir ödeme düğmesi göndermek için, Ödeme Düğmesi türünü seçin ve ödeme sistemi olarak EBANX'i seçin.
Şunu 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ı
1. Adım. Bir Başlat bloğu oluşturun.
Başlat bloğu genellikle iş akışındaki ilk karşılama mesajını ve kullanıcının ihtiyaç duyduğu giriş bilgilerini göstermek için kullanılır.
2. Adım. Aşağıda gösterilen bloğu oluşturun.
3. Adım. ş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.
4. Adım. Mesajı ikinci bloğa girin.
5. Adım. Üçüncü bir blok oluşturun ve Bağlantı ikinci ve üçüncü bloklar arasındaki ayarları açın.
Sonraki bloğa otomatik geçmek için zamanlayıcıyı etkinleştirin.
6. Adım. Üçüncü blokta, fonksiyonu Hesaplayıcı.
şuna örnek olarak kopyalayın:
Eğer ödemeleri USDdışında bir para biriminde kabul etmek istiyorsanız, para birimini aşağıda gösterildiği gibi belirtin.
Örnek 2. Faturalama Düğmesi
Bu örnek neredeyse Örnek 1.
ile 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.
Şunu seçin: Faturalama işlevi.
Şunu seçin EBANX ö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}.
Sonra tıklayın Ekle.
Ödemeden Sonra Bildirimler
Müşteri ödeme bağlantısını açıp ödemeyi tamamladıktan sonra, başarılı ödeme durumunda aşağıdaki geri çağırma konuşmaya gönderilir:
Şurada:
SDJ91MTKTTEntegrasyon Anahtarınızın ilk 10 karakteridir.100ödeme tutarıdır.
Ödeme iptal edilirse, aşağıdaki geri çağırma gönderilir:
Çevrimdışı ödeme yöntemleri için (boleto, OXXO vb. gibi), ödeme onayı anında gerçekleşmez. EBANX geri çağırmayı yalnızca fonları aldıktan sonra gönderir; bu da 1–3 iş günü sürebilir. Ödeme onaylandıktan sonra geri çağırma otomatik olarak teslim edilecektir.
Başarılı veya Başarısız Bir Ödemeye Nasıl Yanıt Gönderilir
1. Adım. Bir Tetikleyici bloğu oluşturun.
2. Adım. 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 Kelimelere Göre.
Alternatif olarak, belirli bir ödemeye tepki vermek istiyorsanız, Tetikleyici alanına tüm geri çağırma 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şlat blok yerine bir Tetikleyici blok oluşturabilir ve bot akışınızı oradan oluşturmaya devam edebilirsiniz.
Başarılı Bir Ödemeden Sonra Müşteri Değişkenleri
Değişken
Değer
ebanx_callback_data
Ödeme sistemi tarafından alınan ödeme bilgileri
ebanx_payment_completed
"True" — ödeme başarılı olarak işlendi
ebanx_payment_hash
EBANX'teki ödeme kimliği (hash)
Son güncelleme