# Wayforpay

{% hint style="info" %}

* Hızlı kayıt ve satıcı onayı
* Web sitesi olmayan bireyler için satıcı kaydı
* Bireyler ve tüzel kişiler için birleşik oran – %2,5
* Google Play ve ApplePay kullanılabilirliği
  {% endhint %}

### **Nasıl bağlanır**

wayforpay ödeme sistemini bağlamak için 3 değere ihtiyacınız olacak:

1. satıcının giriş bilgisi
2. satıcının gizli anahtarı
3. satıcının web sitesinin alan adı.

Kişisel hesabınıza gidin -> mağaza ayarları **<https://m.wayforpay.com/mportal/merchant/list>**

<figure><img src="/files/17686db60413715e592a969f541c86fe3d563155" alt="" width="563"><figcaption></figcaption></figure>

Verileri kopyalayın ve Mavibot’taki ayarlara gidin.

"Acquiring" bölümünü açın, wayforpay’i seçin.

<figure><img src="/files/ad36922b49dc309badc3cae38f85d6ec48046ce8" alt=""><figcaption></figcaption></figure>

Açılan formda alınan verileri girmeniz gerekiyor:

<figure><img src="/files/be937e0d77c6ae759915cbc6662edb12c8a7b06e" alt=""><figcaption></figcaption></figure>

Bir ödeme bağlantısı oluşturmak için, **payment\_sum** değişken (örneğin, 150 veya 100.55; tutar kesirliyse, tutar nokta ile ayrılır):

<figure><img src="/files/52ea5040ccb13eea6ebebc3f8e07e75099fbab72" alt=""><figcaption></figcaption></figure>

Bunun hemen ardından, **wayforpay\_pay\_url** değişkeni görünecektir. Bu değişken bağlantılı mesajda görüntülenebilir veya "Öde" metniyle butona yerleştirilebilir:

Seçenek 1. Butondaki ödeme bağlantısı:

<figure><img src="/files/a6bcdc42de4d2f62552dd26312b7af6a35ac59cd" alt=""><figcaption></figcaption></figure>

Seçenek 2. Ödeme bağlantısı attachment url alanındadır:

<figure><img src="/files/e05a83bda34db7c49a260ace3076625530b800fc" alt=""><figcaption></figcaption></figure>

Bağlantı şu şekilde görünür:

<https://secure.wayforpay.com/invoice/id1bbb2ad0375>

{% hint style="warning" %}
Varsayılan olarak, <mark style="color:kırmızı;">USD (dolar)</mark> ayarlanır; başka bir para birimine ihtiyacınız varsa, currency değişkeninin değerini ayarlamanız gerekir.
{% endhint %}

Ayrıca, **payment\_sum** değişkeninin değerini ayarlamadan önce, ödemeyi yapılandırmak için aşağıdaki isteğe bağlı değişkenleri ayarlayabilirsiniz.

**currency** - siparişin varsayılan para birimi UAH’dır (olası değerler USD, EUR, RUB)

**session\_timeout** - Bağlantı süresi saniye cinsindendir, varsayılan 3600’dür (1 saat)

**product\_name** - ürün adı

**language** - ödeme sayfası dili, varsayılan UA’dır (olası değerler RU, EN)\
\
**buyer\_name** - müşteri adı

**buyer\_email** - müşteri e-posta adresi

**buyer\_first\_name** - müşteri adı

**buyer\_last\_name** - müşterinin soyadı

Ödeme sayfası bağlantısı bu şekildedir.

![Ödeme bağlantısı oluşturma örneği](https://lh6.googleusercontent.com/Qsm1KH-AI7U8pv_6AjddIF3rWTlidd-TCKepv0LtbxbpEHBL72YbrQ-Yzb-UvI64-ih_XVqb9kjVCRcix6B5rWFK-AWgNLEbHgsaLCZvMHXoH7xHmSrnsZz-qKB0wHH67M0u8gyR)

1 tutarında ödeme için bir bağlantı oluşturalım <mark style="color:kırmızı;">USD</mark> ve 2 saatlik bir süreyle:

<figure><img src="/files/149a571507c1e9b2e54523fe4741287ea15ac353" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Dikkat edin:** \
\- Öncelikle isteğe bağlı parametreleri belirtin  **product\_name** vb.\
\- Ve son olarak, değerini atayın **payment\_sum** değişkenini kontrol eden bir IF koşulu ile belirlenir.
{% endhint %}

Lütfen önce ayarlar için değişkenleri, ardından payment\_sum değerini ayarladığımızı unutmayın. Değişkenler tek bir blok yerine zincirde daha önce ayarlanabilir; bu sadece bir örnektir.

Sonraki blokta, **wayforpay\_pay\_url** bağlantı içeren değişkeni çıktı olarak veriyoruz (örneğin, metin içindeki bir bağlantı):

<figure><img src="/files/04861e6be01422734261c6cbd7b4457f770ca419" alt=""><figcaption></figcaption></figure>

Bot şu şekilde çalışacaktır:

<figure><img src="/files/1e79e22e4c2c68bee3f93dd8ecbec8f90164e9ed" alt="" width="563"><figcaption></figcaption></figure>

### Sonuç Nasıl İşlenir

Başarılı bir ödemenin ardından, ödeme başarılı oldu bilgisini vermek için bot’a geri çağrılar gönderilecektir. Bu geri çağrıları sistemde kullanıcıdan gelen mesajlar olarak görürsünüz; kullanıcı bunları gönderemesin diye gizli anahtarın ilk 10 karakteri ve \_success eki içerirler, örneğin:  **flk3409ref\_success**

<figure><img src="/files/fd088799b6eea2b4c6c7d14e6ffaa7a36262852e" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Bu geri çağrılar kullanıcıya GÖRÜNMEZ, yalnızca operatöre gösterilir.
{% endhint %}

Karşılaştırma türü "Tam Eşleşme" olmalıdır

Ayrıca, başarılı ödemeden sonra wayforpay\_payment\_completed değişkeni True olarak ayarlanır.

Örneğin, başarılı bir ödemeyi koşullu bir blokta işleyebilir ve ilgili mesajı kullanıcıya gösterebilirsiniz:

<figure><img src="/files/7f56135c89ba6461220c36a616b1588c51b78d25" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/e619c1b99abb321a32ad7d43e1d238c37aa7c26c" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Müşteriyi ana chatbot akışından çıkarmak istemiyorsanız, "Koşullu Non state" bloğunu kullanın. Bu bloğa geçiş yapılamaz; böylece müşteri ödeme sonrasında ana huni dışına çıkarılmaz ve başarılı ödeme bildirimi alır.

Ve eğer başarılı ödemeye tepki vererek huniyi sürdürmeniz gerekiyorsa, o zaman "Başlangıç koşulu" bloğunu kullanın; ardından müşteri ödeme bloğundan "Başlangıç koşulu" bloğuna geçer ve buradan huniyi sürdürebilirsiniz.
{% endhint %}

{% hint style="success" %}
Koşullu bloklar hakkında daha fazla bilgi aynı adlı makalede verilmiştir
{% endhint %}

Ödeme tamamlandıktan sonra, **wayforpay\_callback\_data** değişkeni müşteriye eklenecek ve tamamlanan işleme ilişkin ödeme sisteminin yanıt verilerini içerecektir. Gerekli verileri sonuç sözlüğünden **get** yöntemini kullanarak çıkarabilirsiniz.

## Hesap makinesiyle çalışma fonksiyonları

### Tekrarlayan ödemeler için

wayforpay\_recurrent\_payment(amount, currency, session\_timeout, product\_name, language, buyer\_name, buyer\_email, regular\_date\_next, regular\_date\_end, regular\_count, regular\_mode) - tekrarlayan ödeme için bir bağlantı oluşturur.&#x20;

<table><thead><tr><th width="303.85546875">Parametre</th><th>Açıklama</th></tr></thead><tbody><tr><td>amount</td><td>ödeme tutarı</td></tr><tr><td>currency</td><td>para birimi. Varsayılan: UAH (olası değerler: USD, EUR, RUB). İsteğe bağlı parametre.</td></tr><tr><td>session_timeout</td><td>bağlantı süresi saniye cinsinden. Varsayılan: 3600 (1 saat). İsteğe bağlı parametre.</td></tr><tr><td>product_name</td><td>ürün adı. İsteğe bağlı parametre.</td></tr><tr><td>language</td><td>ödeme sayfası dili. Varsayılan: UA (olası değerler: RU, EN). İsteğe bağlı parametre.</td></tr><tr><td>buyer_name</td><td>müşteri adı. İsteğe bağlı ad.</td></tr><tr><td>buyer_email</td><td>Müşteri e-postası. İsteğe bağlı parametre.</td></tr><tr><td>regular_date_next</td><td>bir sonraki otomatik işlem tarihi. Varsayılan: bağlantı oluşturulduktan bir ay sonra. İsteğe bağlı parametre.</td></tr><tr><td>regular_date_end</td><td>otomatik işlemin bitiş tarihi. Varsayılan: bağlantı oluşturulduktan bir yıl sonra. regular_count parametresi belirtilmişse atlanabilir. İsteğe bağlı parametre.</td></tr><tr><td>regular_count</td><td>otomatik işlem sayısı. Belirtilirse regular_date_end parametresi yoksayılır. İsteğe bağlı parametre.</td></tr><tr><td>regular_mode</td><td>tekrarlayan ödeme aralığı. İsteğe bağlı parametre. Olası değerler: <br>- once - tek seferlik ödeme<br>- daily - günlük<br>- weekly - haftalık<br>- quarterly - ilk ödeme tarihinden sonra her 3 ayda bir<br>- monthly - ayda bir<br>- bimonthly - her 2 ayda bir<br>- halfyearly - her 6 ayda bir<br>- yearly  - yılda bir</td></tr></tbody></table>

### Tekrarlayan ödemenin iptali

wayforpay\_delete\_recurrent() - müşterinin gelecekteki otomatik ödemelerini iptal eder. Başarılı çalıştırıldığında "Ok" döndürür.

<figure><img src="/files/9816c83f35be958c0b65644af4cdd85cb8ea37d8" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Ayrıca "Başlatma tetikleyicisi" ve "State" bloklarını da kullanabilirsiniz (örnekte "Koşullu Non-state" ve Non-state" blokları kullanılmıştır).

Müşteriyi ana chatbot akışından çıkarmak istemiyorsanız, "Koşullu Non-state" bloğunu kullanın — bu bloğa manuel olarak girilemez, bu nedenle müşteri ödeme sonrasında ana hunide kalırken yine de başarılı ödeme bildirimini alır.

Huniye başarılı ödemeye göre devam etmek istiyorsanız, "Başlatma tetikleyicisi" bloğunu kullanın. Bu durumda müşteri ödeme bloğundan "Başlatma tetikleyici koşulu" bloğuna geçer ve buradan huniye devam edebilirsiniz.
{% endhint %}


---

# 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/odeme/wayforpay.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.