PayTabs'ı Mavibot'a Bağlama

PayTabs'ı Mavibot'a bağlamak için PayTabs hesabınızda birkaç ayar yapılandırmanız gerekir.

1. API Anahtarı Oluşturma

PayTabs panelinizde şuraya gidin:

Geliştiriciler → API Anahtarları

Yeni bir API anahtarı oluşturun.

API anahtarını oluşturduktan sonra aşağıdaki bilgileri kaydedin:

  • Sunucu Anahtarı — entegrasyonu kurmak için gereklidir.
  • Profil Kimliği — bağlantı kurulumu için de gereklidir.

2. Ödeme Bildirimlerini Yapılandırma

Şuraya gidin:

Geliştiriciler → Yapılandırma

Ödeme bildirimlerini (geri aramalar) etkinleştirin.

"+" düğmesine tıklayın ve aşağıdaki geri arama URL'sini ekleyin:

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

Bu URL, ödeme durumu güncellemelerini Mavibot'a göndermek için kullanılır.

3. Mavibot'ta PayTabs'ı Yapılandırma

Mavibot ayarlarında:

  1. Tahsilat bölümüne gidin
  2. Ödeme sağlayıcısı olarak PayTabs'ı seçin
  3. Aşağıdaki bilgileri girin:
    • Profil Kimliği
    • Sunucu Anahtarı
  4. PayTabs hesap bölgenizi seçin

Lütfen dikkat!
Seçilen bölge, PayTabs hesabınızın kayıtlı olduğu bölgeyle eşleşmelidir.

Ayarlar kaydedildikten sonra entegrasyon kurulumu tamamlanmış olacaktır.

Ödeme Bağlantısı Oluşturma

Bir ödeme bağlantısı oluşturmak için aşağıdaki işlevi kullanın:

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

İşlev Parametreleri

Parametre Açıklama
! amount Ödeme tutarı. Zorunlu parametre
description Ödeme açıklaması. İsteğe bağlı parametre
currency Ödeme para birimi. İsteğe bağlı parametre
customer_email Müşteri e-posta adresi. İsteğe bağlı parametre
customer_phone Müşteri telefon numarası. İsteğe bağlı parametre
full_name Müşteri tam adı. İsteğe bağlı parametre
language Ödeme sayfasının dili. İsteğe bağlı parametre

Kullanılabilir Para Birimleri

Aşağıdaki para birimi kodları desteklenmektedir:

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

Kullanılabilir Diller

en — İngilizcear — Arapçafr — Fransızca

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

currency parametresi sağlanmazsa, para birimi yapılandırılan bölgeye göre otomatik olarak seçilir.

Ödeme Bağlantısını Bir Düğmede Kullanma

Bir müşteriye ödeme düğmesi göndermek için:

  1. Ödeme türünde bir düğme oluşturun
  2. Ödeme sağlayıcısı olarak PayTabs'ı seçin
  3. Şunları belirtin:
    • ödeme açıklaması;
    • ödeme tutarı;
    • para birimi.

Ödeme Durumu İşleme

Müşteri ödeme bağlantısını açıp ödemeyi tamamladıktan sonra, sohbete bir geri arama olayı gönderilecektir.

Başarılı Ödeme

Örnek:

SDJ91MTKTT_success 100

Burada:

  • SDJ91MTKTT — Sunucu Anahtarı'nın ilk 10 karakteri
  • 100 — ödeme tutarı

Başarılı bir ödeme için bir eylem oluşturmak üzere Builder'a gidin ve bir tetikleyiciye sahip bir blok oluşturun (bu bir Başlangıç bloğu veya bir Tetikleyici bloğu olabilir).

Ardından, Tetikleyici alanına şunu girin:

  • tam geri arama değeri (eylemi yalnızca belirli bir ödeme tutarı için tetiklemek istiyorsanız) veya
  • yalnızca ödeme tutarından önceki geri arama değeri (eylemi tüm başarılı ödemeler için tetiklemek istiyorsanız).

Başarısız Ödeme

Örnek:

SDJ91MTKTT_fail 100

Başarısız ödeme işleme, başarılı ödeme işleme ile aynı şekilde yapılandırılır.

Bir tetikleyiciye sahip bir blok oluşturun ve Tetikleyici alanına geri arama değerini girin. Bu, bir ödeme başarısız olduğunda yürütülecek eylemleri tanımlamanıza olanak tanır.

Başarılı Ödemeden Sonra Kaydedilen Değişkenler

Başarılı bir ödemeden sonra, müşteri için aşağıdaki değişkenler otomatik olarak kaydedilir:

paytabs_callback_data
Ödeme sisteminden alınan tam webhook yükünü içerir.

paytabs_payment_completed

Değer:

True

Ödemenin başarıyla tamamlandığını belirtir.