# 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.

<div data-with-frame="true"><img src="/files/5a5238cb8be12688f5243716fd72092eca17f1f8" alt=""></div>

<div data-with-frame="true"><img src="/files/8531e61e66dfb4f3717d8cddd80ad97b7f42538f" alt=""></div>

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.

<div data-with-frame="true"><img src="/files/d01e535f76d557b73e5589ff808f5c61a1c7aa7f" alt="" height="252" width="794"></div>

### 2. Ödeme Bildirimlerini Yapılandırın

Şuraya gidin:

**Geliştiriciler → Yapılandırma**

<div data-with-frame="true"><img src="/files/ec5e9d21701c554aecb563c4a7986877ac37c400" alt="" height="414" width="750"></div>

Ö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
```

<div data-with-frame="true"><img src="/files/e09e02a5bea8e5b81f4c72d13a0fcf5ad216b643" alt="" height="322" width="822"></div>

<div data-with-frame="true"><img src="/files/f40479a5e3ebdc196780d491dd5d3b4f14a784fd" alt="" height="368" width="835"></div>

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

### 3. Mavibot’ta PayTabs’i Yapılandırın

<div data-with-frame="true"><figure><img src="/files/c63d3a911be8d601cf50655a7b0b3b55d6258e1d" alt=""><figcaption></figcaption></figure></div>

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**

{% hint style="info" %}
**Lütfen dikkat!**\
Seçilen bölge, PayTabs hesabınızın kayıtlı olduğu bölgeyle eşleşmelidir.
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/8f842677a3568da27f3c0185add8cb04477b5cff" alt="" width="563"><figcaption></figcaption></figure></div>

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                                            |
| ------------------------------------------------ | --------------------------------------------------- |
| <mark style="color:$danger;">**!**</mark> 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.

<div data-with-frame="true"><img src="/files/46672619cb3db125621dd5e9b536d56473475698" alt="" width="554"></div>

***

## Ö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

<div data-with-frame="true"><figure><img src="/files/39cc5278f4c7edf48854c30de737ab8cb4fef478" alt="" width="357"><figcaption></figcaption></figure></div>

Ö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).

<div data-with-frame="true"><figure><img src="/files/cda025a04e841e825abb7f2e9171f2064b2f6cec" alt=""><figcaption><p>"Start" bloğu</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/2a9247c9b9ac5a786ea5c068dc8ac83d7e8b9363" alt=""><figcaption><p>"Trigger" bloğu</p></figcaption></figure></div>

### 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/tr/integrations/payment/paytabs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.