Untuk menggunakan gerbang pembayaran iyzico di Mavibot, anda perlu mendapatkan kelayakan API dari akaun peniaga iyzico anda dan memasukkannya dalam tetapan integrasi.

Mendapatkan Kelayakan API

  1. Log masuk ke Panel Peniaga iyzico anda.
  2. Pergi ke Tetapan → Kunci API (Kunci API Peniaga).
  3. Salin kelayakan berikut:
    • Kunci API
    • Kunci Rahsia

Kelayakan ini diperlukan untuk menyambungkan iyzico ke Mavibot.

Untuk ujian, iyzico menyediakan kelayakan berasingan dengan awalan sandbox-. Jika anda memasukkan kelayakan ini, semua pembayaran akan diproses secara automatik dalam mod Sandbox (ujian)—tiada konfigurasi tambahan diperlukan. Untuk menerima pembayaran langsung, gunakan kelayakan pengeluaran anda (tanpa awalan sandbox-).

Menyambungkan iyzico

Dalam tab Pemerolehan, pilih iyzico.

Kemudian masukkan:

  • Kunci API — kunci API anda.
  • Kunci Rahsia — Kunci Rahsia anda.

Integrasi kini selesai.

Menjana Pautan Pembayaran

Fungsi kalkulator:

get_iyzico_payment_url(amount, description, currency, customer_email, customer_phone, full_name, identity_number, city, country, address, product_name, language)

Parameter

Parameter Penerangan Diperlukan Nilai Lalai / Dibenarkan
amount Jumlah pembayaran. ✅ —
description Penerangan pembayaran. Tidak —
currency Mata wang pembayaran. Tidak Lalai: TRY
Disokong: TRY, USD, EUR, GBP, CHF, NOK
customer_email Alamat e-mel pelanggan. Tidak —
customer_phone Nombor telefon pelanggan dalam format antarabangsa (contohnya, +905XXXXXXXXX). Tidak —
full_name Nama penuh pelanggan. Tidak —
identity_number Nombor pengenalan pelanggan (untuk pelanggan di Turki, ini adalah TCKN). Tidak —
city Bandar pelanggan. Tidak —
country Negara pelanggan. Tidak —
address Alamat pelanggan. Tidak —
product_name Nama produk yang dipaparkan pada halaman pembayaran. Jika ditinggalkan, description digunakan. Tidak Menggunakan description
language Bahasa halaman pembayaran. Tidak Lalai: en
Disokong: en, tr

Fungsi ini mengembalikan URL pembayaran.

Butang Pautan Pembayaran

Untuk menghantar butang dengan pautan pembayaran, pilih jenis Butang Pembayaran dan pilih iyzico sebagai gerbang pembayaran. Kemudian masukkan nama produk, jumlah pembayaran, dan, jika perlu, mata wang pembayaran.

Panggil Balik Pembayaran

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

SDJ91MTKTT_success 100

Di mana:

  • SDJ91MTKTT ialah 10 aksara pertama Kunci Rahsia anda.
  • 100 ialah jumlah pembayaran.

Jika pembayaran gagal, panggil balik berikut dihantar:

SDJ91MTKTT_fail 100

Pembolehubah Pelanggan Selepas Pembayaran Berjaya

Pembolehubah Nilai
iyzico_callback_data Maklumat pembayaran yang diterima daripada iyzico
iyzico_payment_completed "True" jika pembayaran berjaya diproses
iyzico_payment_id ID pembayaran iyzico