# Bepaid

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

Bağlanmak için **bePaid** ödeme sistemine, bir **Mağaza Kimliği**, **gizli anahtar**ve **genel anahtar**gerekecektir. Bu kimlik bilgilerini aldıktan sonra, içindeki ayarlara geçin **Salebot**.

{% hint style="info" %}
bunu elde etmek için **Mağaza Kimliği**, **gizli anahtar**ve **genel anahtar**, lütfen **baPaid** teknik desteğiyle iletişime geçin.
{% endhint %}

İçinde **MaviBot**, **"Ödeme sistemi"** bölümünü açın ve **bePaid**seçin. Ardından aldığınız kimlik bilgilerini girin.

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

Lütfen dikkat: son alan, kullanım ülkesine bağlı olarak API barındırmasını seçen bir anahtardır: **Belarus** veya **Rusya**.

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

## **Ödeme Bağlantısı Nasıl Oluşturulur**

Bir ödeme bağlantısı oluşturmak için, şu değişkene bir değer atamanız gerekir: **payment\_sum** değişkeni (örneğin: **150** veya **100.55** — ondalık ayırıcı olarak nokta kullanın).

Bir kez **payment\_sum** değişkeni ayarlandıktan sonra, **bepaid\_pay\_url** değişkeni otomatik olarak görünecektir. Bu değişkeni ekranda bir bağlantı olarak gösterebilir veya metni **"Öde"**.

olan bir düğmeye yerleştirebilirsiniz.\
[Ödeme bağlantısı şöyle görünecektir:](https://checkout.bepaid.by/widget/hpp.html?token=a05eabd3f9368725efbc175614c7d469da08f198cc51916b07fb75e53f9a3e1a)

ayıklamadan önce **payment\_sum** değişkenini, ödemeyi özelleştirmek için aşağıdaki isteğe bağlı değişkenleri de tanımlayabilirsiniz.

{% hint style="info" %}
Varsayılan olarak para birimi **Beyaz Rus rublesi**olarak ayarlanır. Farklı bir para birimi kullanmanız gerekiyorsa, **currency** değişkenine bir değer atayın.
{% endhint %}

<table><thead><tr><th width="209">Fonksiyon Parametreleri</th><th width="242">Açıklama</th><th>Daha Fazla Bilgi</th></tr></thead><tbody><tr><td><strong>currency</strong></td><td>ISO 4217 formatında ödeme para birimi</td><td>Örneğin: <strong>USD</strong></td></tr><tr><td><strong>language</strong></td><td><strong>Ödeme sayfası dili</strong><br>Varsayılan: <strong>en</strong>.</td><td><p><strong>İzin verilen değerler:</strong></p><ul><li><strong>en</strong> – İngilizce</li><li><strong>es</strong> – İspanyolca</li><li><strong>tr</strong> – Türkçe</li><li><strong>de</strong> – Almanca</li><li><strong>it</strong> – İtalyanca</li><li><strong>ru</strong> – Rusça</li><li><strong>zh</strong> – Çince</li><li><strong>fr</strong> – Fransızca</li><li><strong>da</strong> – Danca</li><li><strong>sv</strong> – İsveççe</li><li><strong>no</strong> – Norveççe</li><li><strong>fi</strong> – Fince</li><li><strong>pl</strong> – Lehçe</li><li><strong>ja</strong> – Japonca</li><li><strong>uk</strong> – Ukraynaca</li><li><strong>be</strong> – Belarusça</li><li><strong>ka</strong> – Gürcüce</li><li><strong>ro</strong> – Rumence</li></ul></td></tr><tr><td><strong>payment_description</strong></td><td>Ödeme Açıklaması</td><td></td></tr><tr><td><strong>link_expired</strong> </td><td><strong>Ödeme Bağlantısı Son Kullanma Süresi</strong><br>Son kullanma tarihini şu formatta ayarlayın <strong>gg.aa.yyyy</strong> (örneğin: <strong>25.06.2025</strong>).<br>Varsayılan olarak, ödeme şu süre içinde tamamlanmalıdır: <strong>24 saat</strong>.</td><td><p>ayrıca <strong>"Yönlendirmede Değişkenleri Ata"</strong> alanını kullanarak şunları ayarlayabilirsiniz:</p><ul><li><code>link_expired = current_date + 2</code> — bağlantı <strong>2 gün boyunca 00:00'a kadar geçerli olacaktır</strong>.</li><li>Ayrıca tam son kullanma tarihini ve saatini şu formatta belirtebilirsiniz <strong>gg.aa.yyyy ss:dd</strong> (örneğin: <strong>25.06.2025 12:23</strong>). Varsayılan olarak, ödeme şu süre içinde tamamlanmalıdır: <strong>24 saat</strong>.</li></ul><p>Standart değişkenler de kullanılabilir. Örneğin, bağlantı geçerliliğini <strong>30 dakika</strong>olarak ayarlamak için:<br>time = current_time + 30<br>link_expired = "#{current_date} #{time}"</p></td></tr><tr><td>russian_host</td><td><strong>Rusya'daki bePaid Host'ta Kayıtlı Mağaza Göstergesi</strong><br>Bu parametreyi <strong>1</strong> olarak ayarlayın, eğer mağazanız <strong>bepaid.tech</strong>.</td><td>üzerine kayıtlıysa. Host'u Belarus'a geçirmek gerekiyorsa, bu parametreyi <strong>""</strong> (boş değer) olarak ayarlayın.</td></tr><tr><td><strong>test_payments</strong></td><td>Bu değişken <strong>test ödemeleri</strong>için kullanılır. Bir test ödemesi yapmak için, onu herhangi bir değerle ekleyin.</td><td></td></tr><tr><td><strong>bepaid_attempts</strong> </td><td>şunu belirtir: <strong>ödeme denemesi sayısı</strong>Varsayılan olarak, <strong>1 deneme</strong> izin verilir.</td><td></td></tr><tr><td><strong>сustomer_data</strong></td><td>Ödeyen kişinin şu bilgilerini içeren bir dizi: <strong>first_name</strong>, <strong>last_name</strong>ve <strong>email</strong>. Bu veri, makbuzun ödeyen kişinin e-postasına gönderilmesi için gereklidir ve ödeme sayfasında düzenlenebilir.</td><td>Parametre şu biçimde iletilmelidir: <strong>JSON formatında anahtar-değer çiftleri listesi</strong>.<br>Örneğin:<br>customer_data = ‘{“first_name”: “Sam”, “last_name”: “Smith”, “email”: “sam_smith@mavibot.ai” }’</td></tr><tr><td><strong>bepaid_contract</strong> (koşullu olarak gerekli)</td><td>Token ile Ödeme Amacı</td><td><p><strong>Beklenen değerler:</strong></p><ul><li><strong>“recurring”</strong> – belirli bir sıklıkta yapılan düzenli ödemeler için</li><li><strong>“card_on_file”</strong> – tek seferlik veya düzensiz ödemeler için, örneğin bir hizmet için ödeme sonrası</li></ul></td></tr></tbody></table>

Ödeme tamamlandıktan sonra, **bepaid\_callback\_data** değişkeni müşteri için eklenecektir. Bu değişken, tamamlanan işlem için ödeme sisteminin yanıtını içerir. Gerekli verileri bu sözlükten **get** yöntemini kullanarak çıkarabilirsiniz.

## **Ödemeler Nasıl Test Edilir**

Bir test ödemesi yapmak için, **payment\_sum** değişkenini ayarlamadan önce, **test\_payments** değişkenini herhangi bir değerle ayarlayın.\
Botu **canlı modda**!

**Test kartları:**

* 4200000000000000 — başarılı
* 4005550000000019 — başarısız

Bir şey çalışmazsa, verilerinizi resmi belgelerle karşılaştırın: <https://docs.bepaid.by/ru/test-integration#test-card-number>

## **Ödeme Bağlantısı Oluşturma Örneği**

İçin bir ödeme bağlantısı oluşturalım **100 Belarus rublesi** (varsayılan para birimi).

Not: önce yapılandırma için ek değişkenleri ayarlayın, ardından **payment\_sum**değişkenini ayarlayın. Değişkenler iş akışında daha önce de ayarlanabilir, mutlaka aynı blokta olmak zorunda değildir — bu sadece bir örnektir.

Son olarak, istenen konumda **bepaid\_pay\_url** değişkenini gösterin; bu değişken oluşturulan ödeme bağlantısını içerir.

## **Abonelik Yönetimi**

Ödeme sistemi entegrasyonu, müşterileriniz için abonelik oluşturmanıza olanak tanır.

Bu işlevselliği kullanmadan önce **Salebot**, abonelik planı oluşturun **bePaid** hesabınızda.

{% hint style="warning" %}
Eğer **“Planlar”** ve **“Abonelikler”** menüleri hesabınızda görünmüyorsa, lütfen yöneticinizle iletişime geçin.
{% endhint %}

**Abonelik Oluşturma ve Ödeme Bağlantısı Üretme**

şunu kullanın: **get\_bepaid\_subscription\_url** fonksiyonu, şu parametreyi ileterek: **plan\_id** parametresi, burada…

<table><thead><tr><th width="233"></th><th></th></tr></thead><tbody><tr><td>plan_id</td><td><strong>plan_id</strong> şunun kimliğidir: <strong>bePaid</strong> sistemdeki plan.</td></tr></tbody></table>

Sonuç olarak, fonksiyon bir abonelik oluşturacak ve bir ödeme bağlantısı döndürecektir.

Bağlantıyı müşteriye gönderin ve ödemenin tamamlanmasını bekleyin.

Ödeme başarılı olduktan sonra, abonelik etkinleştirilecektir. İşlemde şu değerler yer alacaktır: **bepaid\_subscription\_id** ve **bepaid\_subscription\_status** değişkenleri ve bot'a bir geri çağrı gönderilecektir (bkz. **“Sonucun Nasıl İşleneceği”** bölümü).

## **Abonelik Bilgilerini Alma**

Bir müşteri için mevcut abonelik ayrıntılarını almak için şunu çağırın: **get\_bepaid\_subscription\_info** fonksiyonunu kullanın ve şu parametreyi iletin: **subscription\_id** parametresi (değer şuradan alınabilir: **bepaid\_subscription\_id** değişkeni).

## **Aboneliği İptal Etme**

Bir aboneliği iptal etmek için şunu kullanın: **cancel\_bepaid\_subscription** işlevini kullanın.

Bu fonksiyon tek bir parametre alır: **subscription\_id** (değer şuradan alınabilir: **bepaid\_subscription\_id** değişkeni).

İptal başarıyla gerçekleştirildiğinde, **bepaid\_subscription\_status** değişkeni şu değere ayarlanacaktır: **“canceled”**, ve bot'a bir geri çağrı gönderilecektir (bkz. **“Sonucun Nasıl İşleneceği”** bölümü).

## Abonelik Durumları

<table data-header-hidden><thead><tr><th width="270"></th><th></th></tr></thead><tbody><tr><td>trial</td><td>Aktif veya iptal edilmiş <strong>deneme süresi</strong> aboneliği.</td></tr><tr><td>active</td><td>Aktif abonelik, <strong>ödeme zamanında yapıldı</strong>.</td></tr><tr><td>failed</td><td>Başarısız abonelik. <strong>bePaid</strong> sonraki ödemeyi işleyemedi.</td></tr><tr><td>error</td><td>Sırasında bir hata oluştu <strong>bePaid</strong> ödeme işlemeye çalışıyordu.</td></tr><tr><td>canceled</td><td>Abonelik <strong>canceled</strong> iptal edildi ve artık aktif değil.</td></tr></tbody></table>

## **Tekrarlayan Ödemeler**

Ayrıca bir abonelik sistemi kurabilirsiniz **plan oluşturmadan** içinde **bePaid** hesabınızda.

Bunun için müşterinin **kart tokenına**.

ihtiyacınız olacaktır. Kart tokenını almak için, müşteri **payment\_sum**.

ayıklamadan önce **payment\_sum** değerini kullanarak oluşturulan bir bağlantı ile başlangıç ödemesi yapmalıdır, şunu ayarlayın: **bepaid\_contract** değişkeni, token ile gelecekteki ödemelerin amacını belirtmek için:

* **“recurring”** – belirli bir sıklıkta yapılan düzenli ödemeler için
* **“card\_on\_file”** – tek seferlik veya düzensiz ödemeler için, örneğin bir hizmet için ödeme sonrası

{% hint style="warning" %}
Düğmenin **“card\_on\_file”** seçeneği tüm alıcılar tarafından desteklenmez. Kullanmak istiyorsanız, lütfen hesap yöneticinizle iletişime geçin.
{% endhint %}

Başarılı bir ödemeden sonra, **bepaid\_client\_card\_token** değişkeni işleme eklenecek ve müşterinin kart tokenını saklayacaktır. Bu token, müşterinin kartından ücret almanıza olanak tanır **müşterinin müdahalesi olmadan**.

Sonra huninizi kurun ve otomatik tahsilat için bir tarih veya koşul belirtin, ardından şunu çağırın: **make\_bepaid\_token\_payment** fonksiyonu, gerekli parametreleri ileterek.

Parametre sırası:\
**amount → currency → description → contract**

### Parametre Açıklamaları

<table><thead><tr><th width="286"></th><th></th></tr></thead><tbody><tr><td>amount (gerekli)</td><td><strong>Ödeme tutarı</strong> – beklenen değer <strong>bir tam sayıdır</strong> veya <strong>ondalıklı sayıdır</strong>, örneğin: 100 veya 100.5.</td></tr><tr><td>currency (gerekli)</td><td><strong>Ödeme para birimi</strong> şu formatta: <strong>ISO 4217</strong> örneğin: <strong>“USD”</strong>.</td></tr><tr><td>description (gerekli)</td><td><strong>Tahsilat açıklaması</strong>, örneğin: <strong>“Hobi kulübüne katılım için haftalık abonelik ödemesi”</strong>.</td></tr><tr><td>contract (gerekli)</td><td><strong>Token ile ödeme amacı.</strong> Beklenen değerler: <strong>“recurring”</strong> veya <strong>“card_on_file”</strong>.</td></tr></tbody></table>

{% hint style="warning" %}
Düğmenin **contract** değeri **birebir eşleşmelidir** ilk ödeme bağlantısı oluşturulurken belirtilen değerle!
{% endhint %}

Ödeme başarılı olursa, fonksiyon şu mesajı döndürür: **“bePaid tokenı ile başarılı tahsilat”**, başarılı ödeme için bir geri çağrı alırsınız ve işlem değişkeni **bepaid\_token\_payment\_completed** şu değere ayarlanacaktır: **“True”**.

Ödeme başarısız olursa, fonksiyon başarısızlığın nedenini belirten bir mesaj döndürür, sonuna **“\_fail”** eklenmiş bir geri çağrı bot'a gönderilir ve işlem değişkeni **bepaid\_token\_payment\_completed** şu değere ayarlanacaktır: **“False”**.

{% hint style="warning" %}
Banka, müşterinin ödemeyi tamamlamasını isteyebilir. Bu durumda, fonksiyon müşteriyi **3-D Secure kimlik doğrulamasından**.
{% endhint %}

## **geçmeye yönlendiren bir bağlantı döndürür**

Sonucun Nasıl İşleneceği **Bot, müşteri eylemlerine yanıt olarak, gizli anahtarın** ilk 20 karakteri

ve işlem türüne ve sonucuna bağlı bir sonek içeren geri çağrılar alacaktır. **görmez**.

### **Ödemeler İçin**

ödemeler için **aboneliklerle ilgili olmayan**, aşağıdaki mesajlardan birini alırsınız:

* **keyNumber\_success** – başarılı bir ödeme için
* **keyNumber\_fail** – başarısız bir ödeme için

Son ödemenin durumunu şu değişkenleri kullanarak da takip edebilirsiniz:

* **bepaid\_payment\_completed** – müşteriyle ilgili ödemeler için
* **bepaid\_token\_payment\_completed** – için **kart tokenına dayalı otomatik ödemeler**

### **Abonelikler İçin**

Bir abonelik başarıyla etkinleştirildikten sonra, ilk veya tekrarlayan ödeme olsun, bot şu mesajı alacaktır **keyNumber\_success**.

Abonelik iptal edilirse, şu mesajı alırsınız **keyNumber\_canceled**.

Başarısız bir abonelik ödemesi durumunda, mesaj **keyNumber\_fail** gönderilecektir.


---

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