Integrasi PayTR membolehkan anda menerima pembayaran melalui PayTR, penyedia perkhidmatan pembayaran Turki. Pelanggan melengkapkan pembayaran mereka di halaman pembayaran PayTR yang selamat, di mana mereka boleh menggunakan kad bank Turki dan kaedah pembayaran tempatan yang lain.

Mendapatkan Kredensial Integrasi

Sebelum menyambungkan PayTR, tandatangani perjanjian dengan PayTR dan dapatkan akses ke akaun pedagang anda.

Di menu kiri, buka Bilgi (Maklumat) dan cari bahagian API Entegrasyon Bilgileri. Salin nilai berikut:

Papan Pemuka PayTR Medan Mavibot
Mağaza No ID Pedagang (merchant_id)
Mağaza Anahtarı Kunci Pedagang (merchant_key)
Mağaza Şifresi Garam Pedagang (merchant_salt)

Nota: Kredensial ini hanya tersedia untuk Ana Kullanıcı (Pengguna Utama) dan Teknik Sorumlu (Penanggungjawab Teknikal). Jika anda tidak dapat melihat bahagian ini, minta pemilik akaun utama untuk memberikan kebenaran yang diperlukan.

Anda tidak perlu mengkonfigurasi URL pemberitahuan pembayaran (callback) di papan pemuka PayTR. Mavibot secara automatik menghantar URL callback dengan setiap permintaan pautan pembayaran.

Menyambungkan PayTR

Buka tetapan Pemerolehan di Mavibot dan pilih PayTR.

Masukkan kredensial berikut:

  • ID Pedagang (merchant_id) — Mağaza No anda
  • Kunci Pedagang (merchant_key) — Mağaza Anahtarı anda
  • Garam Pedagang (merchant_salt) — Mağaza Şifresi anda

Simpan tetapan untuk melengkapkan integrasi.

Menjana Pautan Pembayaran

Gunakan fungsi kalkulator:

get_paytr_payment_url(amount, description, currency, customer_email, product_name, expired, language)

Parameter

Parameter Diperlukan Penerangan
amount ✅ Jumlah pembayaran.
description Tidak Penerangan pembayaran (produk atau perkhidmatan). Dipaparkan di halaman pembayaran PayTR.
currency Tidak Mata wang pembayaran: TL, USD, EUR, GBP, atau RUB. Lalai: TL.
customer_email Tidak Alamat e-mel pelanggan.
product_name Tidak Nama produk yang dipaparkan di halaman pembayaran.
expired Tidak Tempoh hayat pautan pembayaran dalam saat. Jika ditinggalkan, pautan tidak akan luput.
language Tidak Bahasa halaman pembayaran: tr (Turki) atau en (Inggeris). Lalai: tr.

Fungsi ini mengembalikan URL pembayaran.

Nota

  • Kod mata wang TRY secara automatik ditukar kepada TL.
  • Jika mata wang yang tidak disokong ditentukan, TL digunakan secara automatik.
  • Nama produk mesti mengandungi 4–200 aksara.
    • Nama yang lebih pendek daripada 4 aksara akan ditambah dengan noktah (.).
    • Nama yang lebih panjang daripada 200 aksara akan dipotong secara automatik.

Contoh

Langkah 1

Buat mesej yang meminta pelanggan memasukkan alamat e-mel mereka.

Langkah 2

Buat blok seterusnya di bawah mesej dan buka tetapan anak panah.

Konfigurasikan Sambungan seperti berikut:

  • Jenis padanan: Ungkapan biasa
  • Dayakan pilihan Pengguna memasukkan data.
  • Masukkan nama pemboleh ubah: customer_email

Simpan tetapan Sambungan.

Langkah 3

Masukkan parameter fungsi dalam kalkulator.

Mencipta Butang Pembayaran

Untuk menghantar butang pembayaran di Mavibot:

  1. Buat blok dengan butang.

  1. Pilih jenis Pengebilan.
  2. Pilih PayTR sebagai penyedia pembayaran.
  3. Tentukan:
    • Nama produk
    • Jumlah pembayaran
    • Mata wang
  4. Secara pilihan, berikan pemboleh ubah yang mengandungi alamat e-mel pelanggan.

Panggilan Balik Pembayaran

Selepas pelanggan melengkapkan pembayaran, Mavibot menerima panggilan balik dan menyiarkannya ke perbualan.

Pembayaran Berjaya

SDJ91MTKTT_success 100

Di mana:

  • SDJ91MTKTT ialah 10 aksara pertama Kunci Pedagang (merchant_key) anda.
  • 100 ialah jumlah pembayaran.

Untuk bertindak balas terhadap pembayaran yang berjaya atau gagal, salin nilai panggilan balik dan buat blok Mula (atau blok Pencetus).

Masukkan teks panggilan balik dalam pencetus.

Kemudian buat mesej yang memaklumkan pelanggan sama ada pembayaran berjaya atau gagal.

Dari blok ini, anda boleh meneruskan aliran chatbot anda mengikut keperluan.

Nota: Konfigurasi pencetus yang ditunjukkan dalam contoh ini akan bertindak balas terhadap setiap pembayaran yang berjaya, kerana ia hanya menggunakan awalan panggilan balik tanpa jumlah pembayaran.
Jika anda ingin bertindak balas hanya terhadap pembelian produk tertentu atau jumlah pembayaran tertentu, masukkan teks panggilan balik penuh, termasuk jumlah pembayaran, dan tukar Jenis padanan kepada Padanan tepat.

Pembayaran Gagal

SDJ91MTKTT_fail 100

Nota: Pautan pembayaran PayTR adalah kegunaan tunggal. Selepas pembayaran berjaya, pautan akan dinyahaktifkan secara automatik. Jana pautan pembayaran baharu untuk setiap pembayaran baharu.

Pemboleh Ubah Pelanggan Selepas Pembayaran Berjaya

Pemboleh Ubah Penerangan
paytr_callback_data Maklumat pembayaran yang diterima daripada PayTR.
paytr_payment_completed "True" jika pembayaran berjaya diproses.
paytr_merchant_oid Pengecam transaksi PayTR (merchant_oid).