# Ödeme butonu

Ödeme işlevine sahip bir düğme, bir ödeme bağlantısı sağlayarak bağlı ödeme sistemleriyle çalışmayı kolaylaştırır.

resim

Lütfen birçok mesajlaşma uygulamasında bağlantıların yalnızca metin içindeki satır içi düğmelere yerleştirilebileceğini unutmayın. Düğmeyi oluşturduktan sonra blok ayarlarında uygun düğme türünü seçmeyi unutmayın.

Ödeme işlevi düğmesi aşağıdaki ödeme sistemleri için kullanılabilir:

* Stripe

Tek bir blok içinde, farklı ödeme tutarlarına sahip farklı ödeme sistemleri için "Ödeme" düğmeleri oluşturabilirsiniz.

Projeye bağlı hiçbir ödeme sistemi yoksa, bu düğme türü kullanılamaz.

resim

**Ödeme düğmesinin ana alanları:**

* **Metin alanı:** Bu metin, mesajdaki ödeme bağlantısına sahip düğmede görünecektir.
* **İşlev:** Düğme türünü seçin **Ödeme**.
* **İşlev alanı:** Ödeme bağlantısı sağlayan bir düğme oluşturmak için **Ödeme** işlevini kullanın.
* **Ödeme sistemi alanı:** Liste, projeye bağlı ödeme sistemlerini gösterir.

Seçilen ödeme sistemine bağlı olarak, bağlantıyı oluşturmak ve makbuzu düzenlemek için gerekli alanlar değişecektir.

Farklı ödeme sistemleri için Ödeme işlevi düğmesi ayarlarını burada görüntüleyebilirsiniz:

Düğmenin **ödeme bağlantısını oluşturmak için gerekli alanlar** şunlardır **Tutar** ve **Ürün adı/Ürün açıklaması**.

* **Tutar alanı:** Ödeme tutarını buraya girin.
* **Ürün adı alanı:** Ödeme sayfasında gösterilecek ürünün adını girin.

Çift tırnak işaretleri **gönderemezsiniz** ürün adında kullanılabilir.

Bunları kesme işaretleri veya tek tırnakla değiştirebilirsiniz.

Seçilen ödeme sistemine bağlı olarak, düğme ayarlarında "Makbuz verileri" ve/veya "Ek bilgi" etiketli açılır menüler görünecektir. Bunlara tıklandığında ek alanlar açılacaktır:

resim

### Ödeme işlevi düğmesi kullanılırken değişkenler <a href="#variables-when-using-the-payment-function-button" id="variables-when-using-the-payment-function-button"></a>

Kullanıcı "Ödeme" düğmesine sahip bloğu alır almaz, aşağıdaki istemci değişkenleri otomatik olarak oluşturulur:

* **Sistem istemci değişkeni `__payments`** – bu değişken ödeme tutarını ve oluşturulan ödeme bağlantısının kimliğini saklar. Ödeme sisteminden gelen webhook yanıtını tanımlamak için kullanılır.

Sistem istemci değişkeni `__payments` **silinmemeli veya değiştirilmemelidir**!

İstemci değişkeni `error_payment_button` ödeme düğmesi oluşturulurken bir hata oluşursa oluşturulur.

Değeri, hata mesajını veya ödeme sistemi tarafından döndürülen hata yanıtını içerecektir.

Değişkenlerin değerleri, kullanıcı bir sonraki bloğa geçtiğinde etkinleşir (güncel hale gelir).

#### Sonucun nasıl işleneceği <a href="#how-to-handle-the-result" id="how-to-handle-the-result"></a>

**Başarılı ödeme**

Başarılı bir ödemenin ardından bot bir **callback** ödeme sisteminin gizli anahtarının ilk 10 karakterinden, `_success`kelimesinden ve ödeme tutarından oluşan, aralarında boşluk bulunan bir değer alacaktır. Örneğin: **`ovg58keefc_success 44`**, burada:

* `ovg58keefc`: ödeme sisteminin gizli anahtarının ilk 10 karakteri
* `_success`: isteğin sonucunu belirtir (başarılı ödeme)
* `44`: ödeme tutarı

Ödeme sisteminden gelen geri çağrılar (bildirimler) **kullanıcı tarafından görünmez**. Bunlar yalnızca **Müşteriler** sekmesinde gösterilir ve **operatör**.

**Kullanım örneği:** **Adım 1.** için görünürdür **Ödeme** düğmesinin bulunduğu blokta, **Ödeme** işlevini kullanın. **Adım 2.** içinde **Bağlantı koşulu** alanına sahip düğmeleri **Başarılı ödeme** bloğuna ekleyin, **callback**belirtin. Başarılı ödeme geri çağrısını **Koşul alanı** içinde **Birincil koşul kontrolü** bloğunun belirtmeniz durumunda da aynı şekilde çalışır.

Not! Eşleşme türü seçimi — **Tam eşleşme** veya **Anahtar kelime eşleşmesi.**

Faydalı ipucu

Ana hunideki ilerleyişini kesintiye uğratmadan müşteriye başarılı bir ödeme hakkında bildirim göndermek için **"Koşullu durum içermeyen bloklar" oluşturun.**

**Hatalı ödeme**

Bir **ödeme hatası oluşursa**, bot bir **callback** ödeme sisteminin gizli anahtarının ilk 10 karakterinden, `_fail`kelimesinden ve ödeme tutarından oluşan, aralarında boşluk bulunan bir değer alacaktır. Örneğin: `ovg58keefc_fail 44`, burada:

* `ovg58keefc`: ödeme sisteminin gizli anahtarının ilk 10 karakteri
* `_fail`: istek işleminin sonucu — ödeme başarısız oldu veya bir hata oluştu
* `44`: ödeme tutarı

Bu, ödeme sistemine bağlıdır. **Tüm ödeme sistemleri ödeme hataları için geri çağrı göndermez.**

Düğme ayarlarında belirtilen tutar **müşterinin gerçekten ödediği tutardan farklıysa**, bot bir **callback** ödeme sisteminin gizli anahtarının ilk 10 karakterinden, `_different_amounts`ifadesinden ve benzersiz bir ödeme kimliğinden oluşan, aralarında boşluk bulunan bir değer alacaktır. Örneğin: `ovg58keefc_different_amounts 123456`, burada:

* `ovg58keefc`: ödeme sisteminin gizli anahtarının ilk 10 karakteri
* `_different_amounts`: isteğin işlenmesinin sonucu (ödeme tutarı bağlantıdaki tutardan farklıdır)
* `123456`: benzersiz ödeme kimliği


---

# 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/chatbot/builder/butonlar/odeme-butonu.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.