Paypal nasıl kurulur

Paypal ile çalışmak için iki anahtar almanız gerekir: client_id ve secret

https://developer.paypal.com/developer/applications/ sayfasına gidin

Ve listeden seçin veya yeni bir uygulama oluşturun:

Üst kısımda Canlı moda geçin ve istediğiniz uygulamayı seçin. İhtiyacımız olan verilerin bulunduğu ayarlar sayfası açılır:

Verileri kopyalayın ve Mavibot ayarlarındaki uygun alanlara yapıştırın: "Satın Alma" bölümüne gidin ve Paypal hizmetini bulun:

Ardından, "Bağlan"a tıklayın ve alanları daha önce alınan gizli anahtar ve Müşteri Kimliği ile doldurun:

Ardından, "Ayarları kaydet"e tıklayın. Bağlantı bu şekilde 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şkeninin görünmesi gerekir.

Fonksiyon parametreleri Parametre açıklaması Not
payment_title (isteğe bağlı değişken)bu ürün adıdır. Belirtilmezse, şu metinle doldurulur: “Fatura ödeme order_id" (order_id, mavibot'taki 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örüntülenir (aşağıdaki örnek, şirket)

Ayrıca, payment_sum belirtilmeden önce ödeme sayfasının hangi dilde olacağını da belirtebilirsiniz.

Bunu yapmak 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 dillerin kümesi değişir, orijinal kaynağa bakın) (kaynak)

Ayrıca ödemenin kabul edildiği para birimini de belirtebilirsiniz. Bunu yapmak için currency değişkenini belirtin, varsayılan olarak ruble (RUB) ayarlanır, dolar için değerini USD olarak ayarlayın (currency = USD). Olası para birimi seçeneklerine bağlantıdan ulaşılabilir.

Ve üçüncü ek parametre company_name - şirketinizin adı, ödeme sayfasının en üstünde görüntülenir (aşağıdaki örnek, şirket)

paypal_pay_url değişkeni bir bağlantı ile görüntülenebilir veya "Öde" metniyle bir düğmeye yerleştirilebilir.

Bağlantı şöyle görünür: https://www.paypal.com/checkoutnow?token=07N53571YM296381N

Bir uygulama örneği.

Ödeme tutarını ve şirket adını ayarlama

Lütfen dikkat: payment_sum değişkenine, isteğe bağlı payment_title, company_name vb. değişkenlerden sonra en son değer atanır.

Ardından, ikinci "Durum" bloğunda #{paypal_pay_url} değişkenini belirtin:

  1. Değişken mesaj alanında belirtilebilir:

  1. Değişken, ek ayarlarındaki url alanında belirtilebilir:

  1. Değişken, düğme ayarlarındaki url alanında belirtilebilir:

Ödeme bağlantısını açarken

paypal_payment_url hesap makinesi fonksiyonunu kullanma

Bir huni oluşturucu bloğu oluşturun ve hesap makinesinde paypal_payment_url fonksiyonunu kullanarak gerekli parametreleri ona iletin:

Blok koşulu karşılandığında, müşteri bir ödeme bağlantısı alacak ve paypal_payment_completed müşteri değişkeni False değeriyle oluşturulacaktır.

url = paypal_payment_url(2500,`` 'RUB', 'Fatura ödeme payment_id','ödeme açıklaması', 'kuruluş adı', 'ru-Ru')

Tekrarlayan ödeme nasıl oluşturulur

Tekrarlayan ödemelerle ödeme yapmak için bir bağlantı oluşturmak ve almak üzere kişisel hesabınızda bir abonelik planı oluşturmanız gerekir.

Zaten oluşturulmuş teklifi seçme:

Alternatif olarak, teklif adını arama çubuğuna yazın ve "Oluştur"a tıklayın.

Otomatik borçlandırma türünü Sabit olarak seçin:

Abonelik oluşturun

Abonelik para birimini ve borçlandırma koşullarını seçme:

Dikkat!!

Mavibot'ta varsayılan para birimi euro'dur, borçlandırma dolar veya başka bir para birimindeyse, abonelik oluştururken ihtiyacınız olan para birimini ve Mavibot'ta Paypal aboneliğinden aynı para birimini belirtin.

Ardından, aboneliği etkinleştirin:

Oluşturulduktan sonra, gelecekte bir abonelik oluşturmak ve bir ödeme bağlantısı almak için kullanacağımız kimliği kullanılabilir 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)

Fonksiyon parametreleri Parametre açıklaması
! plan_id abonelik planı kimliği
! shipping_currency belirtilen plan için ödeme dolar cinsinden ise, hiçbir şey aktarmanız gerekmez, aksi takdirde planda belirttiğiniz para birimi kodunu aktarırız. Teslimatın ödendiği para birimi burada 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ır olarak ayarlanır.
start_time isteğe bağlı parametre, aboneliğin başlangıç tarihi ve saati. Hiçbir şey aktarmazsanız, abonelik başlangıç tarihi = ödeme tarihi. Biçimler: %d.%m.%Y veya %d.%m.%Y %H:%M.

Bağlantı oluşturulurken, abonelik kimliğini içerecek olan paypal_subscription_id değişkeni de görünecektir.

Ödeme sırasında, normal bir ödeme için ödemeye benzer bir geri arama alacaksınız.

paypal_subscription_data(paypal_subscription_id) - abonelik hakkında bilgi alma

Fonksiyon parametreleri Parametre açıklaması
paypal_subscription_id abonelik kimliği.
sonuç Fonksiyonun sonucu - ödeme sayısı, başarısız tahsilat girişimi 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ı olacaktır.

Parametreler:

Fonksiyon parametreleri Açıklama
paypal_subscription_id abone olurken müşterinin değişkenine kaydedilen abonelik kimliği.

Sonuç nasıl işlenir

Başarılı bir ödemeden sonra, ödemenin başarılı olduğunu size bildirecek geri aramalar bot'a gönderilecektir.

Sistemde, geri aramaları kullanıcıdan gelen mesajlar olarak görürsünüz, ancak kullanıcının kendisi bunları GÖRMEZ: bunlar yalnızca operatöre görüntülenir.

Geri aramayı blokta işlemek ve kullanıcıya ödeme durumu hakkında mesajlar göndermek için "Tam eşleşme" karşılaştırma türünü kullanın.

Geri aramalar gecikebilir, bu nedenle kullanıcıya ödeme bağlantısını gösterdikten sonra şöyle bir mesaj gönderilmesi önerilir: “Ödemeyi yaptıktan sonra, ödemenin başarılı olduğunu belirten bir onay mesajı bekleyin.”

Doğrudan ödeme için

Başarılı ödeme geri araması, gizli anahtarın ilk 10 karakterinden ve durumu içeren imzadan oluşur. Örneğin: EHsWHYOoWV_success

Örnek 1: "Başlangıç koşulu" bloğunu kullanarak başarılı bir ödemeye tepki:

Örnek 2: "Başlangıç koşulu" bloğunu kullanarak başarılı bir ödemeye tepki:

Kullanıcıyı ana sohbet robotu akışından çıkarmak istemiyorsanız, “Koşullu durum yok” bloğunu kullanın — kullanıcılar doğrudan bu bloğa yönlendirilemez, bu nedenle başarılı bir ödemeden sonra ana hunide kalırken aynı zamanda başarılı ödeme hakkında bir bildirim alırlar.

Ancak başarılı ödeme olayına dayalı olarak huniye devam etmek istiyorsanız, “Başlangıç koşulu” bloğunu kullanın. Bu durumda, ödeme bloğunu tamamladıktan sonra kullanıcı, huninizi oluşturmaya devam edebileceğiniz “Başlangıç koşulu” bloğuna yönlendirilecektir.

Koşullu bloklar hakkında daha fazla bilgi aynı adlı makalede verilmiştir. koşullu bloklar hakkında daha fazla bilgi

Başarılı ödeme üzerine, paypal_payment_completed değişkeni True olarak ayarlanır.

Ödeme tamamlandıktan sonra, müşteriye işlem durumuyla ilgili güncel ödeme sistemi verilerini içeren paypal_callback_data değişkeni eklenir. Alınan sözlükten gerekli verileri get yöntemini kullanarak çıkarabilirsiniz.

Tekrarlanan bir ödeme yapmak için, payment_sum değişkenini, daha önce oluşturulan bağlantıyı içeren 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.

Abonelik ödemeleri için

Abonelikle ilgili işlemler için geri arama ayarlama işlevi 01.09.2024 tarihinde eklenmiştir. Bu kategorideki geri aramaların doğru çalışması için, projenizde Paypal ödeme sisteminin entegrasyonunu devre dışı bırakmanız ve bağlamanız gerekir.

Abonelik ödemesi yaparken, bot aşağıdaki mesajlardan birini alacaktır:

  • abonelik etkinleştirme hakkında. Örneğin, subscription_I-PTV5H4MRC1H3_activated;
  • Başarılı bir yinelenen abonelik ödemesi bildirimi. Örneğin, subscription_I-PTV5H4MRC1H3_paid;
  • veya bir abonelik ödeme hatası hakkında. Örneğin, subscription_I-PTV5H4MRC1H3_not_paid;

Yukarıdaki örneklerde “I-PTV5H4MRC1H3” - paypal_subscription_id değişkeni kullanılarak erişilebilen müşterinin abonelik kimliğidir.

Geri arama, müşteriye işlem durumuyla ilgili güncel ödeme sistemi verilerini içeren paypal_subscription_callback_data değişkenini ekleyecektir. Alınan sözlükten gerekli verileri get yöntemini kullanarak çıkarabilirsiniz.

Örnek 1: "Başlangıç koşulu" bloğunu kullanarak abonelik etkinleştirmeye tepki:

Örnek 2: "Koşullu durum yok" bloğunu kullanarak abonelik etkinleştirmeye tepki: