PayTR entegrasyonu, bir Türk ödeme hizmet sağlayıcısı olan PayTR üzerinden ödeme almanızı sağlar. Müşteriler, güvenli PayTR ödeme sayfasında ödemelerini tamamlar ve bu sayede Türk banka kartları ve diğer yerel ödeme yöntemlerini kullanabilirler.

Entegrasyon Bilgilerini Alma

PayTR'yi bağlamadan önce, PayTR ile bir sözleşme imzalayın ve mağaza hesabınıza erişim sağlayın.

Sol menüde Bilgi bölümünü açın ve API Entegrasyon Bilgileri kısmını bulun. Aşağıdaki değerleri kopyalayın:

PayTR Panosu Mavibot Alanı
Mağaza No Merchant ID (merchant_id)
Mağaza Anahtarı Merchant Key (merchant_key)
Mağaza Şifresi Merchant Salt (merchant_salt)

Not: Bu bilgiler yalnızca Ana Kullanıcı ve Teknik Sorumlu tarafından görülebilir. Bu bölümü göremiyorsanız, ana hesap sahibinden gerekli izinleri almasını isteyin.

PayTR panosunda bir ödeme bildirimi (callback) URL'si yapılandırmanıza gerek yoktur. Mavibot, her ödeme bağlantısı isteğiyle birlikte callback URL'sini otomatik olarak gönderir.

PayTR'yi Bağlama

Mavibot'ta Acquiring ayarlarını açın ve PayTR'yi seçin.

Aşağıdaki bilgileri girin:

  • Merchant ID (merchant_id) — Mağaza No'nuz
  • Merchant Key (merchant_key) — Mağaza Anahtarı'nız
  • Merchant Salt (merchant_salt) — Mağaza Şifresi'niz

Entegrasyonu tamamlamak için ayarları kaydedin.

Ödeme Bağlantısı Oluşturma

Hesap makinesi işlevini kullanın:

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

Parametreler

Parametre Zorunlu Açıklama
amount ✅ Ödeme tutarı.
description Hayır Ödeme açıklaması (ürün veya hizmet). PayTR ödeme sayfasında görüntülenir.
currency Hayır Ödeme para birimi: TL, USD, EUR, GBP veya RUB. Varsayılan: TL.
customer_email Hayır Müşterinin e-posta adresi.
product_name Hayır Ödeme sayfasında görüntülenen ürün adı.
expired Hayır Ödeme bağlantısının saniye cinsinden ömrü. Belirtilmezse bağlantının süresi dolmaz.
language Hayır Ödeme sayfası dili: tr (Türkçe) veya en (İngilizce). Varsayılan: tr.

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

Notlar

  • TRY para birimi kodu otomatik olarak TL'ye dönüştürülür.
  • Desteklenmeyen bir para birimi belirtilirse, otomatik olarak TL kullanılır.
  • Ürün adı 4–200 karakter içermelidir.
    • 4 karakterden kısa adlar nokta (.) ile doldurulur.
    • 200 karakterden uzun adlar otomatik olarak kısaltılır.

Örnek

Adım 1

Müşteriden e-posta adresini girmesini isteyen bir mesaj oluşturun.

Adım 2

Mesajın altına bir sonraki bloğu oluşturun ve ok ayarlarını açın.

Bağlantıyı aşağıdaki gibi yapılandırın:

  • Eşleme türü: Düzenli ifade
  • Kullanıcı veri girişi seçeneğini etkinleştirin.
  • Değişken adını girin: customer_email

Bağlantı ayarlarını kaydedin.

Adım 3

Hesap makinesine işlev parametrelerini girin.

Ödeme Butonu Oluşturma

Mavibot'ta bir ödeme butonu göndermek için:

  1. Bir buton içeren blok oluşturun.

  1. Faturalama türünü seçin.
  2. Ödeme sağlayıcısı olarak PayTR'yi seçin.
  3. Belirtin:
    • Ürün adı
    • Ödeme tutarı
    • Para birimi
  4. İsteğe bağlı olarak müşterinin e-posta adresini içeren değişkeni sağlayın.

Ödeme Geri Bildirimleri

Müşteri ödemeyi tamamladıktan sonra, Mavibot bir geri bildirim alır ve bunu sohbete gönderir.

Başarılı Ödeme

SDJ91MTKTT_success 100

Burada:

  • SDJ91MTKTT, Merchant Key (merchant_key)'inizin ilk 10 karakteridir.
  • 100 ödeme tutarıdır.

Başarılı veya başarısız ödemelere tepki vermek için, geri bildirim değerini kopyalayın ve bir Başlangıç bloğu (veya Tetikleyici bloğu) oluşturun.

Tetikleyiciye geri bildirim metnini girin.

Ardından, müşteriye ödemenin başarılı mı yoksa başarısız mı olduğunu bildiren bir mesaj oluşturun.

Bu bloktan itibaren sohbet robotu akışınıza ihtiyacınız olduğu gibi devam edebilirsiniz.

Not: Bu örnekte gösterilen tetikleyici yapılandırması, yalnızca ödeme tutarı olmadan geri bildirim önekini kullandığı için her başarılı ödemeye yanıt verecektir.
Yalnızca belirli bir ürünün satın alınmasına veya ödeme tutarına tepki vermek istiyorsanız, ödeme tutarı da dahil olmak üzere tam geri bildirim metnini girin ve Eşleme türünü Tam eşleme olarak değiştirin.

Başarısız Ödeme

SDJ91MTKTT_fail 100

Not: PayTR ödeme bağlantıları tek kullanımlıktır. Başarılı bir ödemeden sonra bağlantı otomatik olarak devre dışı bırakılır. Her yeni ödeme için yeni bir ödeme bağlantısı oluşturun.

Başarılı Ödemeden Sonra Müşteri Değişkenleri

Değişken Açıklama
paytr_callback_data PayTR'den alınan ödeme bilgileri.
paytr_payment_completed Ödeme başarıyla işlenmişse "True".
paytr_merchant_oid PayTR işlem tanımlayıcısı (merchant_oid).