Untuk menggunakan platform pembayaran EBANX di Mavibot, anda perlu mendapatkan Kunci Integrasi (Integration Key) daripada akaun EBANX anda dan memasukkannya ke dalam tetapan pembayaran.

EBANX adalah pengagregat kaedah pembayaran tempatan di seluruh Amerika Latin. Pembayaran diproses di halaman checkout yang dihoskan secara selamat oleh EBANX, di mana pelanggan akan melihat kaedah pembayaran yang tersedia di negara mereka (seperti PIX dan boleto di Brazil, OXXO dan SPEI di Mexico, PSE di Colombia, kad kredit/debit, dan lain-lain).

Mendapatkan Kunci Integrasi

Tandatangani perjanjian dengan EBANX dan dapatkan akses ke Portal Perniagaan EBANX (papan pemuka peniaga anda).

Semasa proses pendaftaran, pilih negara tempat anda ingin menerima pembayaran. Pelanggan hanya akan dapat membayar dari negara yang diaktifkan pada akaun EBANX anda.

Dalam tetapan integrasi, salin Kunci Integrasi anda. Anda akan memerlukannya untuk menyambungkan EBANX ke Mavibot.

Untuk tujuan ujian, EBANX menyediakan akaun kotak pasir (sandbox) yang berasingan dengan Kunci Integrasinya sendiri. Lihat Mod Ujian di bawah.

Menyambungkan EBANX

Dalam tetapan Sistem Pembayaran, pilih EBANX dan masukkan yang berikut:

  • Kunci Integrasi — Kunci Integrasi EBANX yang telah anda salin.
  • Negara — negara pembayaran lalai (kod negara dua huruf kecil: br untuk Brazil, mx untuk Mexico, co untuk Colombia, cl untuk Chile, pe untuk Peru, ar untuk Argentina, dll.). Ini menentukan kaedah pembayaran yang akan dilihat oleh pelanggan di halaman checkout. Negara yang dipilih mesti diaktifkan pada akaun EBANX anda.
  • Mod Ujian — aktifkan pilihan ini untuk menguji integrasi menggunakan persekitaran kotak pasir EBANX. Apabila Mod Ujian diaktifkan, gunakan Kunci Integrasi dari akaun kotak pasir anda. Untuk menerima pembayaran sebenar, nyahaktifkan Mod Ujian dan gunakan Kunci Integrasi langsung anda.

Persediaan kini selesai.

Menjana Pautan Pembayaran

Fungsi kalkulator:

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

Parameter

  • amount — jumlah pembayaran. Diperlukan.

  • customer_email — alamat e-mel pelanggan. Diperlukan. EBANX tidak boleh membuat pembayaran tanpanya. Pelanggan juga akan menerima pengesahan pembayaran di alamat e-mel ini.

  • full_name — nama penuh pelanggan. Diperlukan.

  • description — penerangan pembayaran. Pilihan.

  • currency — mata wang pembayaran. Anda boleh menggunakan sama ada:

    • mata wang tempatan negara pembayaran (seperti BRL, MXN, COP, CLP, PEN, ARS, dll.), atau
    • mata wang akaun EBANX anda (biasanya USD), di mana EBANX akan menukar jumlah tersebut menggunakan kadar tukarannya.

    Pilihan. Nilai lalai adalah USD.

  • country — negara pembayaran (kod negara dua huruf kecil). Pilihan. Jika ditinggalkan, negara lalai yang ditentukan dalam tetapan pembayaran akan digunakan.

Fungsi ini mengembalikan URL pembayaran.

Nota: Mata wang yang dipilih mesti serasi dengan negara pembayaran. Ia mestilah sama ada mata wang tempatan negara tersebut atau mata wang akaun EBANX anda. Contohnya, untuk br (Brazil), BRL dan USD adalah sah, manakala MXN tidak sah.

Butang Pautan Pembayaran

Untuk menghantar butang pembayaran, pilih jenis Butang Pembayaran dan pilih EBANX sebagai sistem pembayaran.

Masukkan:

  • nama produk;
  • jumlah pembayaran;
  • mata wang;
  • pembolehubah yang mengandungi nama penuh dan alamat e-mel pelanggan.

Secara pilihan, nyatakan negara pembayaran.

Contoh 1: Konfigurasi Aliran Kerja

Langkah 1. Cipta blok Mula.

Blok Mula biasanya digunakan untuk memaparkan mesej alu-aluan pertama dalam aliran kerja, bersama dengan sebarang maklumat pengenalan yang diperlukan oleh pengguna.

Langkah 2. Cipta blok seperti yang ditunjukkan di bawah.

Langkah 3. Pergi ke tetapan Sambungan.

Anda akan memerlukan ungkapan biasa berikut untuk mengesahkan bahawa pelanggan telah memasukkan alamat e-mel yang sah:

^[-\w.]+@([A-z0-9][-A-z0-9]+.)+[A-z]{2,4}$

Juga, aktifkan pilihan Pengguna memasukkan data dan masukkan customer_email.

Langkah 4. Masukkan mesej dalam blok kedua.

Langkah 5. Cipta blok ketiga dan buka tetapan Sambungan antara blok kedua dan ketiga.

Aktifkan pemasa untuk secara automatik beralih ke blok seterusnya.

Langkah 6. Dalam blok ketiga, masukkan fungsi dalam Kalkulator.

Contoh untuk disalin:

amount = 1000
description = "Product1 is product of great reliability!"
currency = "BRL"
link = get_ebanx_payment_url(amount, description, currency, customer_email, full_name, country)

Jika anda ingin menerima pembayaran dalam mata wang selain USD, nyatakan mata wang seperti yang ditunjukkan di bawah.

Contoh 2. Butang Pengebilan

Contoh ini hampir sama dengan Contoh 1.

Walau bagaimanapun, daripada mencipta blok ketiga dengan fungsi untuk menjana pautan pembayaran, anda boleh mencipta butang dalam blok kedua.

Dalam tetingkap yang terbuka:

  • Masukkan teks butang.
  • Pilih fungsi Pengebilan.
  • Pilih EBANX sebagai penyedia pembayaran.

Kemudian masukkan yang berikut:

  • Nama Produk.
  • Jumlah Pembayaran.
  • Mata Wang (pilihan).
  • Nama Penuh Pelanggan (pilihan). Anda boleh mengkonfigurasi ini dengan cara yang sama seperti anda mengkonfigurasi input e-mel pelanggan.
  • E-mel Pelanggan — masukkan pembolehubah #{customer_email}.

Kemudian klik Tambah.

Pemberitahuan Selepas Pembayaran

Selepas pelanggan membuka pautan pembayaran dan menyelesaikan pembayaran, panggil balik berikut akan dihantar ke perbualan apabila pembayaran berjaya:

SDJ91MTKTT_success 100

Di mana:

  • SDJ91MTKTT adalah 10 aksara pertama Kunci Integrasi anda.
  • 100 adalah jumlah pembayaran.

Jika pembayaran dibatalkan, panggil balik berikut akan dihantar:

SDJ91MTKTT_fail 100

Untuk kaedah pembayaran luar talian (seperti boleto, OXXO, dll.), pengesahan pembayaran tidak serta-merta. EBANX menghantar panggil balik hanya selepas menerima dana, yang mungkin mengambil masa 1–3 hari perniagaan. Panggil balik akan dihantar secara automatik setelah pembayaran disahkan.

Cara Menghantar Respons untuk Pembayaran Berjaya atau Gagal

Langkah 1. Cipta blok Pencetus.

Langkah 2. Dalam medan syarat, masukkan teks pemberitahuan SDJ91MTKTT_success — tanpa jumlah pembayaran — jika anda ingin bertindak balas terhadap setiap pembayaran.

Dalam kes ini, Jenis Padanan hendaklah ditetapkan kepada Dengan Kata Kunci.

Sebagai alternatif, masukkan keseluruhan teks panggil balik dalam medan Pencetus jika anda ingin bertindak balas terhadap pembayaran tertentu. Dalam kes ini, Jenis Padanan mesti ditetapkan kepada Padanan Tepat.

Jika anda ingin meneruskan aliran kerja selepas pembayaran berjaya, anda boleh mencipta blok Mula dan bukannya blok Pencetus dan teruskan membina aliran bot anda dari sana.

Pembolehubah Pelanggan Selepas Pembayaran Berjaya

Pembolehubah Nilai
ebanx_callback_data Maklumat pembayaran yang diterima daripada sistem pembayaran
ebanx_payment_completed "True" — pembayaran diproses sebagai berjaya
ebanx_payment_hash Pengecam pembayaran dalam EBANX (hash)