# Paypal
* [Paypal nasıl ayarlanır ](#kak-nastroit-paypal)How to set up Paypal bağlantısı
* [Ödeme bağlantısı nasıl oluşturulur ](#sozdanie-ssylki-na-oplatu) How to create a payment link bağlantısı
* [Yineleyen ödeme nasıl oluşturulur](#kak-sozdat-rekkurentnyi-platezh) How to create a recurring payment bağlantısı
* [Sonuç nasıl işlenir](#obrabotka-rezultata) How to process the result bağlantısı
## How to set up Paypal
Paypal ile çalışmak için iki anahtar almanız gerekir: **client\_id** ve **gizli**
Şu sayfaya gidin
Ve listeden seçin veya yeni bir uygulama oluşturun:
Üstte Live moduna geçin ve istediğiniz uygulamayı seçin. Gerekli verilerin bulunduğu ayarlar sayfası açılır:
Verileri kopyalayın ve Mavibot ayarlarında ilgili alanlara yapıştırın: "Acquiring" bölümüne gidin ve Paypal hizmetini bulun:
Ardından "Connect"e tıklayın ve alanları daha önce aldığınız secret key ve Client ID ile doldurun:
Ardından "Save settings"e tıklayın. Bağlantı tamamlanır.
## Ödeme bağlantısı nasıl oluşturulur
### payment\_sum değişkenini kullanma
Bir ödeme bağlantısı oluşturmak için, **payment\_sum** değişkeninin değerini ayarlamanız ve hemen ardından **paypal\_pay\_url** değişkeni görünecektir.
| İşlev parametreleri | Parametre açıklaması | Not |
| ------------------------ | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **payment\_title** |
(isteğe bağlı değişken) bu ürün adıdır.
| Belirtilmemişse, şu metinle doldurulur: **“Invoice payment order\_id"** (order\_id, mavibot içindeki sipariş tanımlayıcısıdır) |
| **payment\_description** | ürün açıklaması, isteğe bağlı alan | |
| **company\_name** | şirketinizin adı ödeme sayfasının en üstünde gösterilir (örnek aşağıdadır, company) | |
Ayrıca, payment\_sum belirtilmeden önce ödeme sayfasının hangi dilde olacağını belirtebilirsiniz.
Bunun için locale değişkenini ayarlayın. Varsayılan dil **Rusça (ru-RU).** Olası seçenekler: da-DK, he-IL, id-ID, ja-JP, no-NO, pt-BR, ru-RU, sv-SE, th-TH, zh-CN, zh-HK, zh-TW vb. (mevcut diller kümesi değişebilir, asıl kaynağa bakın) bağlantı [asıl kaynak](https://developer.paypal.com/api/rest/reference/locale-codes/))
Ödemenin hangi para biriminde kabul edileceğini de belirtebilirsiniz. Bunun için **currency** değişkenini belirtin, **ruble (RUB)** varsayılan olarak ayarlanır; dolar için değerini USD olarak ayarlayın (currency = USD). Olası para birimi seçenekleri bağlantıda bulunabilir. bağlantı [bağlantı](https://developer.paypal.com/docs/api/reference/currency-codes/).
Ve üçüncü ek parametre **company\_name** - şirketinizin adı, ödeme sayfasının en üstünde gösterilir (örnek aşağıdadır, company)
Düğmenin **paypal\_pay\_url** değişkeni bir bağlantıyla gösterilebilir veya "Pay" metni bulunan bir butona yerleştirilebilir.
Bağlantı şu şekilde görünür: [https://www.paypal.com/checkoutnow?token=07N53571YM296381N](https://www.sandbox.paypal.com/checkoutnow?token=07N53571YM296381N)
Uygulamaya bir örnek.
Ödeme tutarını ve şirket adını ayarlama
{% hint style="info" %}
**Lütfen dikkat:** şu **payment\_sum** değişkenine değer en son, isteğe bağlı değişkenlerden sonra atanır **payment\_title, company\_name,** vb.
{% endhint %}
Ardından, değişkeni #**{paypal\_pay\_url}** ikinci "Status" bloğunda belirtin:
1. Değişken mesaj alanında belirtilebilir:
2. Değişken, ek ayarlarındaki url alanında belirtilebilir:
3. Değişken, buton ayarlarındaki url alanında belirtilebilir:
Ödeme bağlantısı açıldığında
### paypal\_payment\_url hesaplayıcı fonksiyonunu kullanma
Bir funnel oluşturucu bloğu oluşturun ve hesaplayıcı içinde **paypal\_payment\_url** fonksiyonunu kullanarak gerekli parametreleri ona iletin:
ödeme başlığı (127 karaktere kadar). (Atlanırsa şu metinle doldurulur: “Invoice payment payment_id”, burada payment_id Mavibot'taki sipariş ID'sidir)
payment_description
ödemenin kısa açıklaması (127 karaktere kadar)
company_name
isteğe bağlı parametre, kuruluş/şirket adı vb.
locale
Ödeme sayfası dili en-US, fr-XC vb. olarak belirtilir. Varsayılan olarak ‘ru-Ru’dur. Tam liste şu bağlantıda mevcuttur https://developer.paypal.com/api/rest/reference/locale-codes/
Blok koşulu karşılandığında, müşteri bir ödeme bağlantısı alır ve **paypal\_payment\_completed** müşteri değişkeni **False değeriyle oluşturulur.**
`url = paypal_payment_url(2500,`` ``'RUB'``, 'Invoice payment payment_id','payment description', 'organization name', 'ru-Ru')`
## Yineleyen ödeme nasıl oluşturulur
Yineleyen ödemelerle ödeme yapmak için bir bağlantı almak ve oluşturmak üzere bir **abonelik planı** kişisel hesabınızda oluşturmanız gerekir.
Daha önce oluşturulmuş teklifi seçme:
Alternatif olarak, teklif adını arama çubuğuna yazın ve "Create"e tıklayın.
Paypal'da abonelik teklifi oluşturma
Otomatik çekim türü Fixed'i seçin:
Abonelik oluştur
Abonelik para birimini ve çekim koşullarını seçme:
{% hint style="danger" %} **Dikkat!!**
Mavibot'ta varsayılan para birimi eurodur; eğer çekim dolar ya da başka bir para birimindeyse, abonelik oluştururken ihtiyacınız olan para birimini belirtin ve Mavibot'ta Paypal aboneliğinden aynı para birimini kullanın.
{% endhint %}
Ardından aboneliği etkinleştirin:
Oluşturma sonrasında, daha sonra abonelik oluşturmak ve bir ödeme bağlantısı almak için kullanacağımız ID erişilebilir olacaktır.
Ödeme bağlantısı şu fonksiyon tarafından oluşturulur ve döndürülür:\
**paypal\_subscription\_url(plan\_id, shipping\_currency, shipping\_payment\_sum, start\_time)**
| İşlev parametreleri | Parametre açıklaması |
| ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **!** **plan\_id** | abonelik planı ID'si |
| **!** **shipping\_currency** | belirtilen planın ödemesi dolar ise, hiçbir şey aktarmanıza gerek yoktur; aksi halde planda belirttiğiniz para birimi kodunu aktarırız. Teslimatın ödendiği para birimi buradan iletilir (sıfır maliyet için bile). Varsayılan olarak USD |
| **shipping\_payment\_sum** | Bu, teslimat maliyetini belirten isteğe bağlı bir parametredir. Varsayılan olarak değer sıfıra ayarlanır. |
| **start\_time** |
abonelik başlangıcının tarih ve saati için isteğe bağlı parametre. Hiçbir şey aktarmazsanız, abonelik başlangıç tarihi = ödeme tarihi olur. Biçimler: %d.%m.%Y veya %d.%m.%Y %H:%M.
|
Bağlantı oluşturulurken, **paypal\_subscription\_id** değişkeni de görünecektir; bu değişken abonelik ID'sini içerecektir.
Ödeme sırasında, normal bir ödeme için ödeme yapmaya benzer bir callback alırsınız.
**paypal\_subscription\_data(paypal\_subscription\_id)** - abonelik bilgilerini alma
| İşlev parametreleri | Parametrelerin açıklaması |
| ---------------------------- | ------------------------- |
| **paypal\_subscription\_id** | abonelik ID'si. |
Düğmenin **fonksiyonun** çalıştırılmasının sonucu - ödeme sayısı, başarısız çekim denemesi sayısı, durum ve daha fazlası dahil olmak üzere abonelikle ilgili tüm bilgileri içeren bir dizidir.
### Abonelik nasıl iptal edilir
paypal\_remove\_subscription(paypal\_subscription\_id) fonksiyonu, müşterilerin hizmetlerinize olan aboneliklerini iptal etmelerine yardımcı olur.
Parametreler:
| İşlev parametreleri | Açıklama |
| ------------------------ | ---------------------------------------------------------------------- |
| paypal\_subscription\_id | abonelik oluşturulurken müşteri değişkenine kaydedilen abonelik ID'si. |
## Sonuç Nasıl İşlenir
{% hint style="info" %}
Başarılı bir ödemeden sonra, başarılı olduğunu bildiren callback'ler bot'a gönderilecektir.
{% endhint %}
{% hint style="success" %}
Sistemde callback'leri kullanıcının mesajları olarak görürsünüz, ancak kullanıcının kendisi bunları GÖRMEZ: yalnızca operatöre gösterilirler.
{% endhint %}
{% hint style="danger" %}
Callback'i blokta işlemek ve kullanıcıya ödeme durumu hakkında mesajlar göndermek için "Exact match" karşılaştırma türünü kullanın.
{% endhint %}
{% hint style="warning" %}
Callback'ler gecikebilir; bu nedenle, ödeme bağlantısını kullanıcıya gösterdikten sonra şu tür bir mesaj göndermeniz önerilir: “Ödemeyi yaptıktan sonra, lütfen ödemenin başarılı olduğunu belirten bir onay mesajı bekleyin.”
{% endhint %}
### Doğrudan ödeme için
Başarılı ödeme callback'i, gizlinin ilk 10 karakterinden ve durumla birlikte imzadan oluşur. Örneğin: EHsWHYOoWV\_success
Örnek 1: "Start condition" bloğu kullanarak başarılı bir ödemeye tepki:
Örnek 2: "Start condition" bloğu kullanarak başarılı bir ödemeye tepki:
{% hint style="info" %}
Kullanıcıyı ana chatbot akışından çıkarmak istemiyorsanız, “No-state with condition” bloğunu kullanın — kullanıcılar doğrudan bu bloğa yönlendirilemez, bu nedenle başarılı bir ödemeden sonra ana funnel içinde kalırlar ve aynı zamanda başarılı ödeme hakkında bir bildirim alırlar.
Ancak başarılı ödeme olayına göre funnel'a devam etmek istiyorsanız, “Start condition” bloğunu kullanın. Bu durumda, ödeme bloğu tamamlandıktan sonra kullanıcı “Start condition” bloğuna yönlendirilir ve buradan funnel'ınızı oluşturmaya devam edebilirsiniz.
{% endhint %}
{% hint style="info" %}
Koşullu bloklar hakkında daha fazla bilgi aynı adlı makalede verilmiştir. [şartlı bloklarda anlattık](broken://pages/676be56d259b2b337f871ff6556002fb28f5dda1) bağlantı
{% endhint %}
Başarılı ödeme durumunda, paypal\_payment\_completed değişkeni True olarak ayarlanır.
Ödeme tamamlandıktan sonra, işlemin durumuna ilişkin güncel ödeme sistemi verilerini içeren paypal\_callback\_data değişkeni müşteriye eklenir. Gerekli verileri alınan sözlükten get metodu ile çıkarabilirsiniz.
{% hint style="danger" %}
Tekrarlayan bir ödeme yapmak için, payment\_sum değişkenini, daha önce oluşturulmuş bağlantıya sahip değişkeni sıfırlamanız ve ardından payment\_sum değişkenini yeniden atamanız veya yeni bir bağlantı almak için fonksiyonu çağırmanız gerekir.
{% endhint %}
### Abonelik ödemeleri için
{% hint style="danger" %}
Abonelikle ilgili işlemler için callback ayarlama fonksiyonu 09/01/2024 tarihinde eklendi. Bu kategorideki callback'lerin doğru çalışması için, projenizde Paypal ödeme sistemi entegrasyonunu devre dışı bırakıp yeniden bağlamanız gerekir.
{% endhint %}
Bir abonelik ödemesi yapıldığında, bot aşağıdaki mesajlardan birini alır:
* aboneliğin etkinleştirilmesi hakkında. Örneğin, subscription\_I-PTV5H4MRC1H3\_activated;
* başarılı yinelenen abonelik ödemesi bildirimi. Örneğin, subscription\_I-PTV5H4MRC1H3\_paid;
* veya abonelik ödeme hatası hakkında. Örneğin, subscription\_I-PTV5H4MRC1H3\_not\_paid;
Yukarıdaki örneklerde “I-PTV5H4MRC1H3” - müşteri aboneliğinin ID'sidir; buna paypal\_subscription\_id değişkeni kullanılarak erişilebilir.
Callback, işlem durumuna ilişkin güncel ödeme sistemi verilerini içeren paypal\_subscription\_callback\_data değişkenini müşteriye ekleyecektir. Gerekli verileri alınan sözlükten get metodu ile çıkarabilirsiniz.
Örnek 1: "Start condition" bloğu kullanarak abonelik etkinleştirmesine tepki:
Örnek 1: "Not state with condition" bloğu kullanarak abonelik etkinleştirmesine tepki:
---
# 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/paypal.md?ask=
```
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.