# Wallet pay

<figure><img src="/files/f3b876533fe1642d90379e4915ef71f80ae2e722" alt="" width="319"><figcaption></figcaption></figure>

## Ödeme sistemine bağlanma

### Telegram tarafında bağlanma

**Adım 1.** Partner hesabınıza giriş yapın

{% hint style="info" %}
[Bunu yapmak için bağlantıyı takip edin](https://pay.wallet.tg/)
{% endhint %}

Açılan sayfada "Telegram üzerinden giriş yap"a tıklayın, ardından açılır penceredeki "oauth.telegram.org görünür" alanına telefon numaranızı girin ve "Uygula"ya tıklayın.

Ödeme sistemini hem web tarayıcısı üzerinden hem de uygulama üzerinden bağlamak gerekir:

* Yetkilendirme isteyen bir Telegram mesajı alacaksınız - tıklayın **"Uygula".**
* Ayrıca açılır pencerede de "Uygula"ya tıklamanız gerekir **web tarayıcısında "oauth.telegram.org ".**

{% hint style="success" %}
Finans sorumlusunun erişebildiği bir hesabın kullanılması önerilir. Tüzel kişiler için – yetkili temsilci.
{% endhint %}

**Adım 2.** Kısa bir anket doldurun

<figure><img src="/files/2278234a25cde538091fa18dc4c2923b4f96f95a" alt=""><figcaption><p>Şekil 1. Satıcı bilgilerini doldurma</p></figcaption></figure>

İlk kez giriş yapıyorsanız veya ek bilgiye ihtiyacınız varsa, WalletPay size daha ayrıntılı bilgi almak için birkaç soruyu yanıtlamanızı önerir. İki adım vardır:

#### 1. Anket

#### 2. KYB (Know Your Business) veya KYC (Know Your Customer) kontrolleri

Tamamlandıktan sonra, başvurunuz kısa süre içinde incelenecek ve sonuçlar size bildirilecektir. Başarılı olursa, hizmet tarafından alınan komisyonu görecek ve entegrasyona başlayabileceğiniz hesabınıza erişim elde edeceksiniz.

{% hint style="warning" %}
Tüzel kişiler için form yalnızca güvenilir bir kişi tarafından doldurulabilir: bir yönetici veya vekaletle bir çalışan.
{% endhint %}

**Adım 3.** *İlk "Mağaza"yı oluşturun.*

"Anket"i başarıyla tamamladıktan sonra, ilk mağazanızı oluşturmanız önerilecektir.

**4. Adım.** *Bir "API anahtarı" oluşturun*

İlk mağazanın adından sonra, onu ayarlamanız önerilecektir:

* API anahtarı oluşturun.
* API anahtarınızı kopyalayın ve Mavibot ile entegrasyona başlayın.

**Adım 5**. *Bir sipariş oluşturun ve bir ödeme bağlantısı alın*

Bir butona bağlantı koymak istiyorsanız, kullanın **Satır İçi Buton.**

Lütfen yalnızca belirtilen "customerTelegramUserId"'nin ödeme sayfasını açabileceğini unutmayın.

**Adım 6.** *Fon çekme*

Müşteri ödemeyi onayladıktan sonra, tutar varlıklarınıza aktarılır ve varsayılan olarak 48 saat boyunca tutulur. Bu süreden sonra, Paypal Wallet hizmetine giriş yapmak için kullandığınız Wallet bakiyesine fon çekebileceksiniz.

**Adım 7.** *Fonların iadesi*

Şu anda, fon çekme işlemi WalletPay'e giriş yapmak için kullandığınız Wallet hesabınızdan kullanılabilir. Ancak yakında Merchant hesabınızda da kullanılabilir olacak.

### Ödeme düğmesi nasıl görünür?

Telegram Bot'unuzu "Wallet Pay API" ile entegre ederken, ödeme düğmesinin aşağıdaki önerilere uygun olduğundan emin olun:

1. İki yoldan biriyle adlandırılır:

* :purse: Wallet Pay
* :purse: Wallet ile Öde

2. Diğer düğmelerin üstünde yer alır (varsa).

> Not. :purse: — это смайлик (bkz. <https://emojipedia.org/purse/>).
>
> Örneği \[[Demo Store Bot](https://t.me/PineAppleDemoWPStoreBot)].

## Mavibot'a bağlanma

Projeye giriş yapın ve **"Bağlan"** düğmesine, "Ödeme sistemleri" bölümündeki Wallet Pay için tıklayın.

<figure><img src="/files/79b18200e18e95dec1d93be32be573aaa87e61aa" alt=""><figcaption><p>Şekil 2. Hizmeti Mavibot'a bağlamak için "Satın alma" bölümü</p></figcaption></figure>

Açılan pencerede, WalletPay mağazanız için oluşturulan API anahtarını girin.

<figure><img src="/files/4366d5501b335b86d56610595a52e7e9d8ab64ab" alt=""><figcaption><p>Şekil 3. API anahtarı giriş alanı olan bir form</p></figcaption></figure>

* [x] Hazır! Artık müşteriler, Paypal Wallet hizmetini kullanarak mağazanızdaki alışverişlerin ödemesini kripto paralarda (USDT, Toncoin ve Bitcoin) yapabilir.

### Ödeme bağlantısı nasıl oluşturulur

Bir huni oluşturucu bloğu oluşturun ve **“wallet\_pay\_generate\_payment\_url”** fonksiyonunu kullanarak gerekli parametreleri ona iletin:

| Parametreler         | Parametrelerin açıklaması                                                                                   |
| -------------------- | ----------------------------------------------------------------------------------------------------------- |
| **amount**           | kripto para biriminde veya "TON"a dönüştürme için mevcut diğer fiat para biriminde ödeme tutarı.            |
| **сurrency\_code**   | Varsayılan ödeme para birimi "RUB"'dur. Mevcut para birimleri listesi: "TON" "BTC" "USDT" "EUR" "USD" "RUB" |
| **description**      | siparişin 5 ila 100 karakter arasında kısa açıklaması.                                                      |
| **timeout\_seconds** | Bağlantının geçerlilik süresi saniye cinsindendir, varsayılan 3600 saniyedir.                               |

<figure><img src="/files/8147389e579a740fa1bd8427fd0ad6da7744c862" alt=""><figcaption><p>Şekil 4. Parametre aktarımına örnek</p></figcaption></figure>

Blok, bir botla sohbet içinde tetiklendiğinde, müşteri bir ödeme bağlantısı alacak ve **wallet\_pay\_payment\_completed** müşteri değişkeni <mark style="color:kırmızı;">**False değeriyle oluşturulur.**</mark>

{% hint style="warning" %}
Bu bağlantı yalnızca WalletPay faturalandırma hesabına bağlı bir botla sohbet içinde açılabilir.
{% endhint %}

### Ödeme doğrulaması

Başarılı ödemenin ardından, müşterinin **wallet\_pay\_payment\_completed** değişkeni <mark style="color:yeşil;">**True,**</mark> olarak ayarlanacak ve satıcı **4690FE98\_success**şeklinde bir geri çağırma alacaktır; bu geri çağırma şunlardan oluşur:

* “4690FE98” - bunlar Wallet Pay API anahtarının ilk 8 karakteridir.
* başarılı olduğuna dair sözler

<mark style="color:kırmızı;">**!**</mark> ödeme hatası olursa, bir **callback** “<mark style="color:kırmızı;">**\_fail**</mark>” sonekiyle alacaksınız.

Bildirimler için adres (callback'ler): <https://chatter.salebot.pro/wallet_pay/payment_callback> - ödeme sistemi ayarlarına eklenir

Başarılı ödeme (veya ödeme hatası) hakkında müşteriye mesaj göndermek için geri çağırma, blok koşuluna gömülebilir:

<figure><img src="/files/60363ddbe1d9aad4b49bce8ac50c641f6a8e8f47" alt=""><figcaption><p>Şekil 5. "Başlangıç koşulu" bloğunda bir geri çağrıya tepki örneği</p></figcaption></figure>

<figure><img src="/files/17803fb6c095d1d7eca8c96df56b50b70a17f023" alt=""><figcaption><p>Şekil 6. "Durum dışı koşul" bloğunda bir geri çağrıya yanıt örneği</p></figcaption></figure>

{% hint style="info" %}
Müşteriyi ana chatbot akışından çıkarmak istemiyorsanız, "Durum dışı koşul" bloğunu kullanın. Bu bloğa gidemezsiniz, bu nedenle müşteri ödeme sonrası ana huniden çıkarılmaz ve başarılı ödeme bildirimi alır.\
​başarılı ödeme bildirimi.

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="info" %}
Koşullu bloklar hakkında daha fazla bilgi aynı adlı makalede verilmiştir. bağlantı[şartlı bloklarda anlattık](broken://pages/676be56d259b2b337f871ff6556002fb28f5dda1)&#x20;
{% endhint %}

### Yararlı bağlantılar

\[[Wallet Pay İşletme Desteği](https://t.me/WalletPay_supportbot)]

\[[Demo Store Bot](https://t.me/PineAppleDemoWPStoreBot)]

\[[Satıcı Topluluğu](https://t.me/+6TReWBEyZxI5Njli)]


---

# 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/wallet-pay.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.
