Menyambung PayTabs ke Mavibot

Untuk menyambung PayTabs dengan Mavibot, anda perlu mengkonfigurasi beberapa tetapan dalam akaun PayTabs anda.

1. Cipta Kunci API

Dalam papan pemuka PayTabs anda, pergi ke:

Pembangun → Kunci API

Cipta kunci API baharu.

Selepas mencipta kunci API, simpan butiran berikut:

  • Kunci Pelayan — diperlukan untuk menyediakan integrasi.
  • ID Profil — juga diperlukan untuk persediaan sambungan.

2. Konfigurasi Pemberitahuan Pembayaran

Pergi ke:

Pembangun → Konfigurasi

Dayakan pemberitahuan pembayaran (panggilan balik).

Klik "+" dan tambah URL panggilan balik berikut:

https://chatter.mavibot.ai/paytabs_callback/result

URL ini digunakan untuk menghantar kemas kini status pembayaran ke Mavibot.

3. Konfigurasi PayTabs dalam Mavibot

Dalam tetapan Mavibot:

  1. Pergi ke bahagian Pemerolehan
  2. Pilih PayTabs sebagai penyedia pembayaran
  3. Masukkan butiran berikut:
    • ID Profil
    • Kunci Pelayan
  4. Pilih rantau akaun PayTabs anda

Sila ambil perhatian!
Rantau yang dipilih mesti sepadan dengan rantau di mana akaun PayTabs anda didaftarkan.

Setelah tetapan disimpan, persediaan integrasi akan selesai.

Menjana Pautan Pembayaran

Untuk menjana pautan pembayaran, gunakan fungsi berikut:

get_paytabs_payment_url(amount, description, currency, customer_email, customer_phone, full_name, language)

Parameter Fungsi

Parameter Penerangan
! amount Jumlah pembayaran. Parameter wajib
description Penerangan pembayaran. Parameter pilihan
currency Mata wang pembayaran. Parameter pilihan
customer_email Alamat e-mel pelanggan. Parameter pilihan
customer_phone Nombor telefon pelanggan. Parameter pilihan
full_name Nama penuh pelanggan. Parameter pilihan
language Bahasa halaman pembayaran. Parameter pilihan

Mata Wang Tersedia

Kod mata wang berikut disokong:

SAR, AED, BHD, EGP, EUR, GBP, HKD, IDR,INR, IQD, JOD, JPY, KWD, MAD, OMR,PKR, QAR, USD

Bahasa Tersedia

en — Englishar — Arabicfr — French

Fungsi ini mengembalikan URL pembayaran.

Jika parameter currency tidak disediakan, mata wang akan dipilih secara automatik berdasarkan rantau yang dikonfigurasi.

Menggunakan Pautan Pembayaran dalam Butang

Untuk menghantar butang pembayaran kepada pelanggan:

  1. Cipta butang dengan jenis Pembayaran
  2. Pilih PayTabs sebagai penyedia pembayaran
  3. Nyatakan:
    • penerangan pembayaran;
    • jumlah pembayaran;
    • mata wang.

Pengendalian Status Pembayaran

Selepas pelanggan membuka pautan pembayaran dan melengkapkan pembayaran, acara panggilan balik akan dihantar ke perbualan.

Pembayaran Berjaya

Contoh:

SDJ91MTKTT_success 100

Di mana:

  • SDJ91MTKTT — 10 aksara pertama Kunci Pelayan
  • 100 — jumlah pembayaran

Untuk mencipta tindakan untuk pembayaran berjaya, pergi ke Pembina dan cipta blok dengan pencetus (ini boleh menjadi blok Mula atau blok Pencetus).

Kemudian, dalam medan Pencetus, masukkan:

  • nilai panggilan balik penuh (jika anda mahu mencetuskan tindakan hanya untuk jumlah pembayaran tertentu), atau
  • hanya nilai panggilan balik sebelum jumlah pembayaran (jika anda mahu mencetuskan tindakan untuk semua pembayaran berjaya).

Pembayaran Gagal

Contoh:

SDJ91MTKTT_fail 100

Pengendalian pembayaran gagal dikonfigurasi dengan cara yang sama seperti pengendalian pembayaran berjaya.

Cipta blok dengan pencetus dan masukkan nilai panggilan balik dalam medan Pencetus. Ini membolehkan anda menentukan tindakan yang akan dilaksanakan apabila pembayaran gagal.

Pembolehubah Disimpan Selepas Pembayaran Berjaya

Selepas pembayaran berjaya, pembolehubah berikut disimpan secara automatik untuk pelanggan:

paytabs_callback_data
Mengandungi muatan webhook penuh yang diterima daripada sistem pembayaran.

paytabs_payment_completed

Nilai:

True

Menunjukkan bahawa pembayaran telah berjaya diselesaikan.