Untuk menggunakan sistem pembayaran Garanti BBVA (Sanal POS) dalam Mavibot, anda perlu mendapatkan kelayakan POS terminal maya daripada bank dan memasukkannya dalam tetapan integrasi. Pembayaran diproses di halaman selamat bank dengan pengesahan 3D Secure.

Mendapatkan kelayakan

Tandatangani perjanjian dengan Garanti BBVA untuk perkhidmatan Sanal POS (POS maya). Semasa mengaktifkan perkhidmatan, minta bank untuk mendayakan Ortak Ödeme (halaman pembayaran dikongsi) untuk terminal anda. Tanpa ciri ini, pembayaran melalui halaman pembayaran bank tidak akan berfungsi.

Bank akan memberikan anda:

  • Merchant ID (Üye İşyeri No) — ID peniaga anda;
  • Terminal ID — ID terminal anda;
  • Provision User ID — nama pengguna peruntukan (biasanya PROVAUT atau PROVOOS);
  • Provision Password — kata laluan pengguna peruntukan.

Store Key (kunci 3D Secure) dicipta oleh anda dalam panel pengurusan Sanal POS (Yönetim → 3D Secure). Pastikan anda menyimpannya, kerana ia juga diperlukan untuk integrasi.

Bagaimana untuk menyambungkan Garanti BBVA ke Mavibot?

Dalam bahagian Acquiring di Mavibot, pilih Garanti BBVA dan masukkan butiran berikut:

  • Merchant ID — ID peniaga anda.
  • Terminal ID — ID terminal anda.
  • Provision User ID — nama pengguna peruntukan. Jika dibiarkan kosong, PROVAUT akan digunakan.
  • Provision Password — kata laluan pengguna peruntukan.
  • Store Key — kunci 3D Secure anda.
  • Store Name — nama yang dipaparkan kepada pelanggan di halaman pembayaran bank. Jika dibiarkan kosong, "Kedai dalam talian" akan dipaparkan.
  • Test Mode — dayakan pilihan ini untuk menguji integrasi menggunakan kelayakan ujian bank. Untuk memproses pembayaran langsung, pilihan ini mesti dilumpuhkan.

Integrasi kini selesai.

Menjana Pautan Pembayaran

Fungsi kalkulator:

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

Parameter:

Parameter Penerangan Diperlukan Nilai Lalai / Dibenarkan
amount Jumlah pembayaran. ✅ —
description Penerangan pembayaran. Tidak —
currency Mata wang pembayaran. Tidak TRY (lalai). Nilai yang disokong: TRY, USD, EUR, GBP, JPY
customer_email Alamat e-mel pelanggan. Tidak —
language Bahasa halaman pembayaran. Tidak tr (lalai). Nilai yang disokong: tr, en

Fungsi ini mengembalikan URL pembayaran.

Pautan Pembayaran dalam Butang

Untuk menghantar butang dengan pautan pembayaran, pilih jenis butang Payment dan pilih Garanti BBVA sebagai penyedia pembayaran. Kemudian masukkan nama produk, jumlah pembayaran, dan, jika perlu, mata wang pembayaran.

Contoh 1: Konfigurasi Aliran Kerja

Langkah 1. Cipta blok Start.

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

Langkah 2. Cipta blok yang ditunjukkan di bawah.

Langkah 3. Pergi ke tetapan Connection.

Anda 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, dayakan pilihan User enters data dan masukkan customer_email.

Langkah 4. Masukkan mesej dalam blok kedua.

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

Dayakan pemasa untuk teruskan secara automatik ke blok seterusnya.

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

Contoh untuk disalin:

amount = 1000
description = "Product1 is a product of great reliability!"
link = get_garanti_payment_url(amount, description, none, customer_email, none)

Jika anda ingin menerima pembayaran dalam mata wang selain Lira Turki (TRY), nyatakan mata wang seperti yang ditunjukkan di bawah.

Contoh untuk disalin:

amount = 1000
description = "Product1 is a product of great reliability!"
currency = "USD"
link = get_garanti_payment_url(amount, description, currency, customer_email, none)

Contoh 2. Butang Bil

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 Billing.
  • Pilih Garanti BBVA sebagai penyedia pembayaran.

Kemudian masukkan yang berikut:

  • Product Name.
  • Payment Amount.
  • Currency (pilihan).
  • Client Full Name (pilihan). Anda boleh mengkonfigurasi ini dengan cara yang sama seperti anda mengkonfigurasi input e-mel pelanggan.
  • Customer Email — masukkan pembolehubah #{customer_email}.

Kemudian klik Add.

Pemberitahuan Selepas Pembayaran

Selepas pelanggan mengikuti pautan pembayaran dan menyelesaikan pembayaran, pemberitahuan (panggilan balik) akan dihantar ke perbualan.

Untuk pembayaran yang berjaya:

SDJ91MTKTT_success 100

Di mana:

  • SDJ91MTKTT ialah 10 aksara pertama Store Key anda.
  • 100 ialah jumlah pembayaran.

Jika pembayaran gagal, pemberitahuan berikut akan dihantar:

SDJ91MTKTT_fail 100

Cara Menghantar Respons kepada Pembayaran Berjaya atau Gagal

Langkah 1. Cipta blok Trigger.

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

Dalam kes ini, Match Type hendaklah ditetapkan kepada By Keywords.

Sebagai alternatif, masukkan keseluruhan teks panggilan balik dalam medan Trigger jika anda mahu bertindak balas terhadap pembayaran tertentu. Dalam kes ini, Match Type mesti ditetapkan kepada Exact Match.

Jika anda mahu meneruskan aliran kerja selepas pembayaran yang berjaya, anda boleh mencipta blok Start dan bukannya blok Trigger dan teruskan membina aliran bot anda dari sana.

Pembolehubah Pelanggan Selepas Pembayaran Berjaya