Paytabs

PayTabs’i Mavibot’a bağlama

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

1. Bir API Anahtarı oluşturun

PayTabs kontrol 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ırın

Şuraya gidin:

Geliştiriciler → Yapılandırma

Ödeme bildirimlerini etkinleştirin (geri çağrılar).

Tıklayın "+" ve aşağıdaki geri çağırma 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’i Yapılandırın

Mavibot ayarlarında:

1. şuraya gidin: Tahsilat bölümüne

2. Seçin PayTabs ödeme sağlayıcısı olarak

3. Aşağıdaki bilgileri girin:

   • Profil Kimliği

   • Sunucu Anahtarı

4. Seçin PayTabs hesap bölgenizi

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 tamamlanacaktı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)

Fonksiyon Parametreleri

Parametre	Açıklama
! amount	Ödeme tutarı. Gerekli parametre
description	Ödeme açıklaması. İsteğe bağlı parametre
currency	Ödeme para birimi. İsteğe bağlı parametre
customer_email	Müşterinin e-posta adresi. İsteğe bağlı parametre
customer_phone	Müşterinin telefon numarası. İsteğe bağlı parametre
full_name	Müşterinin 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ı desteklenir:

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

Fonksiyon bir ödeme URL’si döndürür.

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

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

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

1. Şu türde bir düğme oluşturun: Ödeme türü

2. Seçin PayTabs ödeme sağlayıcısı olarak

3. Şunları belirtin:

   • ödeme açıklaması;

   • ödeme tutarı;

   • para birimi.

---

Ödeme Durumunun İşlenmesi

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

Başarılı Ödeme

Örnek:

SDJ91MTKTT_success 100

Burada:

• SDJ91MTKTT — ilk 10 karakteri Sunucu Anahtarı

• 100 — ödeme tutarı

Başarılı bir ödeme için bir işlem oluşturmak için şuraya gidin: Builder ve bir tetikleyici içeren bir blok oluşturun (bu bir Start bloğu veya bir Trigger bloğu olabilir).

Daha sonra, Trigger alanına şunu girin:

• tam geri çağırma değeri (işlemi yalnızca belirli bir ödeme tutarı için tetiklemek istiyorsanız) veya

• yalnızca ödeme tutarından önceki geri çağırma değeri (işlemi tüm başarılı ödemeler için tetiklemek istiyorsanız).

"Start" bloğu

"Trigger" bloğu

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 tetikleyici içeren bir blok oluşturun ve geri çağırma değerini Trigger alanına 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, aşağıdaki değişkenler müşteri için otomatik olarak kaydedilir:

paytabs_callback_data Ödeme sisteminden alınan tam webhook verilerini içerir.

paytabs_payment_completed

Değer:

True

Ödemenin başarıyla tamamlandığını gösterir.