Mavibot'ta iyzico ödeme ağ geçidini kullanmak için, iyzico tüccar hesabınızdan API kimlik bilgilerinizi almanız ve bunları entegrasyon ayarlarına girmeniz gerekir.

API Kimlik Bilgilerini Alma

  1. iyzico Tüccar Panelinize giriş yapın.
  2. Ayarlar → API Anahtarları (Tüccar API Anahtarları) bölümüne gidin.
  3. Aşağıdaki kimlik bilgilerini kopyalayın:
    • API Anahtarı
    • Gizli Anahtar

Bu kimlik bilgileri, iyzico'yu Mavibot'a bağlamak için gereklidir.

Test için iyzico, sandbox- ön ekiyle ayrı kimlik bilgileri sağlar. Bu kimlik bilgilerini girerseniz, tüm ödemeler otomatik olarak Sandbox (test) modunda işlenir—ek bir yapılandırma gerekmez. Canlı ödemeleri kabul etmek için, üretim kimlik bilgilerinizi (sandbox- ön eki olmadan) kullanın.

iyzico'yu Bağlama

Alma sekmesinde iyzico'yu seçin.

Ardından şunları girin:

  • API Anahtarı — API anahtarınız.
  • Gizli Anahtar — Gizli anahtarınız.

Entegrasyon artık tamamlandı.

Ödeme Bağlantısı Oluşturma

Hesap makinesi işlevi:

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

Parametreler

Parametre Açıklama Gerekli Varsayılan / İzin Verilen Değerler
amount Ödeme tutarı. ✅ —
description Ödeme açıklaması. Hayır —
currency Ödeme para birimi. Hayır Varsayılan: TRY
Desteklenen: TRY, USD, EUR, GBP, CHF, NOK
customer_email Müşterinin e-posta adresi. Hayır —
customer_phone Müşterinin uluslararası formatta telefon numarası (örneğin, +905XXXXXXXXX). Hayır —
full_name Müşterinin tam adı. Hayır —
identity_number Müşterinin kimlik numarası (Türkiye'deki müşteriler için bu TCKN'dir). Hayır —
city Müşterinin şehri. Hayır —
country Müşterinin ülkesi. Hayır —
address Müşterinin adresi. Hayır —
product_name Ödeme sayfasında görüntülenen ürün adı. Atlanırsa, description kullanılır. Hayır description kullanır
language Ödeme sayfasının dili. Hayır Varsayılan: en
Desteklenen: en, tr

İşlev bir ödeme URL'si döndürür.

Ödeme Bağlantısı Düğmesi

Ödeme bağlantısı içeren bir düğme göndermek için Ödeme Düğmesi türünü seçin ve ödeme ağ geçidi olarak iyzico'yu seçin. Ardından ürün adını, ödeme tutarını ve gerekirse ödeme para birimini girin.

Ödeme Geri Aramaları

Müşteri ödeme bağlantısını açıp ödemeyi tamamladıktan sonra, başarılı bir ödeme durumunda sohbete aşağıdaki geri arama gönderilir:

SDJ91MTKTT_success 100

Burada:

  • SDJ91MTKTT, Gizli Anahtarınızın ilk 10 karakteridir.
  • 100 ödeme tutarıdır.

Ödeme başarısız olursa, aşağıdaki geri arama gönderilir:

SDJ91MTKTT_fail 100

Başarılı Ödeme Sonrası Müşteri Değişkenleri

Değişken Değer
iyzico_callback_data iyzico'dan alınan ödeme bilgileri
iyzico_payment_completed Ödeme başarıyla işlendiyse "True"
iyzico_payment_id iyzico ödeme kimliği