Prodamus (BLR)

Yalnızca "İnfobiz" tarifesinde kullanılabilir.

Prodamus nasıl bağlanır

Prodamus'u bağlamak için ödeme formu URL'si ve gizli anahtara ihtiyacınız olacak.

Ödeme formu URL'si kayıttan sonra alırsınız, o şu şekildedir: demo.payform.ru

Gizli anahtarı kişisel hesabınızdan alabilirsiniz; bildirimler için URL adresini de oraya girmeniz gerekir.

Ödeme sisteminin "Prodamus" kişisel hesabındaki form ayarlarında gizli anahtar

Nasıl yapılacağına dair ayrıntılı talimat: https://help.prodamus.ru/payform.ru-onlain-oplaty/prochee/url-dlya-uvedomlenii-i-sekretnyi-klyuch

Bildirim adresi: https://chatter.salebot.pro/prodamus_callback/result

Bu adresi ayarlara iki yerde girmeniz gerekir.

Ana ayarlar sayfasında form çalışma modu seçilebilir: ödemesiz demo modu veya ödeme modu:

Bildirim adresi, ödeme sisteminin ayarlarında iki yerde belirtilmelidir: Form Ayarı sekmesi - normal ödemeler için ve Abonelikler sekmesi - abonelik ödemeleri için.

Bildirim adresi: https://chatter.salebot.pro/prodamus_callback/result

Ayarlamak için abonelik ödemeleri Abonelikler sekmesine gidin ve bildirim adresini girin: https://chatter.mavibot.ai/prodamus_callback/result

Dikkat! URL girdikten sonra mutlaka «Kaydet» düğmesine basın.

Prodamus'u bağlamak için "Tahsilat" bölümüne gitmeniz gerekir

Ardından, yukarıda konuştuğumuz bilgileri forma belirtmeniz yeterlidir:

ÖNEMLİ! ödeme formu URL'si https:// olmadan girilir

Bağlantı bu kadar. Şimdi bu özelliğin nasıl kullanılacağını inceleyelim.

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

Blokta ödeme bağlantısı oluşturulabilir AŞAĞIDAKİLERDEN BİRİYLE mevcut yöntemlerden:

• Ödeme işlevli düğme veya

• Hesaplayıcı'daki get_prodamus_payment_url işlevi veya

• payment_sum değişkeni ve ek parametreler kullanarak bağlantı oluşturma (eski, hâlâ çalışan sürüm)

Ödeme işlevli düğme

Ödeme bağlantısı, "Ödeme" işlevli bir düğmede oluşturulabilir. Böyle bir düğmenin nasıl oluşturulacağı bu makalede anlatılmıştır

Bu düğmenin tüm olası parametrelerini inceleyelim.

Prodamus için Ödeme düğmesinin zorunlu parametreleri

Ödeme bağlantısı oluşturmak için düğme ayarlarında şu belirtilmelidir zorunlu parametreler "Tutar", "Ürün adı", ayrıca "Ödenmiş içerik", eğer sizde kendi çevrimiçi kasanız yoksa ve Prodamus'tan fiş almak istiyorsanız.

Ödeme sayfasına geçtiğinizde, ürün ve fiyat bilgileri önceden doldurulmuş olacaktır; müşterinin yalnızca iletişim bilgilerini girmesi kalır.\n\nDüğme ayarlarında kullanıcının e-postası ve\veya telefon numarası belirtilirse, ödeme sayfasında ödeyen kişinin iletişim bilgileri ve ürün ile fiyat bilgileri gösterilir.

Düğme ayarları penceresi

Metin alanı. Bu metin, mesajdaki ödeme bağlantılı düğmede gösterilecektir

İşlev alanı. Ödeme bağlantısı vermek için düğme oluştururken Ödeme işlevini seçeriz

Ödeme sistemi alanı. Listede projeye bağlı ödeme sistemleri görüntülenir

Projeye ödeme sistemleri bağlı değilse bu tür düğmeler kullanılamaz

Ürün adı alanı (zorunlu). Bu alana ürünün adını girmeniz gerekir. Ürün adı ne kadar doğru girilirse o kadar iyidir. Örneğin: Telefon değil, Xiaomi akıllı telefon model …

YAPILMAMALI kullanmak çift tırnak ürün adında: silin veya tek tırnakla değiştirin.

Tutar alanı (zorunlu). Bu alana ürünün fiyatını giriyoruz.

Ek Bilgi menüsü. Bu düğmeye tıklayınca bağlantı oluşturmak için ek alanlar açılır

• Sipariş açıklaması

• Ruble cinsinden indirim

• Alıcının e-posta değişkeni

• Alıcının telefon numarası değişkeni

• Bağlantı ömrü

• Abonelik için ürün ID'si (otomatik ödemeler oluşturmak için)

• Ödenmiş içerik

Tıklama bildirimi onay kutusu. Ödeme bağlantısına geçişi izlemek için kutucuğu işaretleyebilirsiniz. Bu durumda, düğmeye tıklandığında Salebot'ta müşteriyle yapılan diyaloğa, bağlantıya geçiş yapıldığına dair bir bildirim gelir

Müşteri bağlantıdan geçtikten sonraki geri çağrı

Bu bildirime botun sonraki çalışma mantığı ayarlanabilir.

Birçok ödeme sistemi, 54-FZ gereği gerekli olan bulut tabanlı çevrimiçi kasaları destekler.\nVergi dairesiyle tatsız bir durum yaşamamak için, seçilen ödeme sisteminin sitesindeki fiş düzenleme özelliklerini okuyun.

İşte düğmedeki bağlantıya gidildiğinde açılan ödeme sayfası böyle görünür:

Ödeme sayfası: düğmede yalnızca temel parametreler doldurulmuş

Ödeme bağlantısı oluşturmak için ek parametreler

Sipariş açıklaması alanı. Bu alanda belirtilen bilgi, ödeme sayfasında Ek veriler alanında görüntülenecektir

İndirim alanı. Bu alana ruble cinsinden ya da kuruşlu ruble miktarını girebilirsiniz. Kuruşlu tutar belirtmek için ayırıcı olarak noktayı kullanırız: 50.99\nÖdeme sayfasında Ödenecek Tutar alanında indirim dikkate alınmış olarak gösterilecek, ürünün asıl fiyatı ise üzeri çizili olacaktır.

Alıcının e-posta değişkeni alanı (isteğe bağlı, Telefon Numarası gönderildiyse) Bu alana kullanıcının (müşterinin) e-postası yazılır. Kullanıcının e-postasının saklandığı değişken belirtilebilir.

Örneğin, #{email}

Alıcının telefon numarası değişkeni alanı (isteğe bağlı, E-posta gönderildiyse). Bu alanda, alıcının telefon numarasının 79000000000 biçiminde yazılı olduğu değişken belirtilebilir\nÖrneğin, #{phone}

E-posta ve/veya telefon mutlaka bulunmalıdır

Bağlantı ömrü alanı. gg.aa.yyyy ss:dd formatında tarih belirtilebilir (örneğin 25.01.2021 11:00) veya bağlantının geçerlilik süresini belirlemek için değişkenler kullanılabilir. \nDeğişken kullanım örneği: #{link_expired}

abonelik için ürün ID'si alanı. Otomatik ödeme gerçekleştirmek için ürün ID değerini iletin. Abonelik oluşturmak için abonelik ürünü oluşturmanız gerekir.

Abonelik ürünü nasıl oluşturulur detaylı talimat: https://help.prodamus.ru/payform/rekurrent-i-kluby/kak-sozdat-i-nastroit-podpiski

Abonelik için ürün ID değeri iletilirse ödeme tutarı dikkate alınmaz. Ürün bilgileri Prodamus panelindeki ürün kartından alınacaktır

Ödemede belirtilen telefon numarası, aboneliği yönetmek için gerekli olacaktır.

Eğer iletirseniz abonelik ürünü ID'sio zaman başarılı ödeme geri çağrısında bu ürünün ID'si iletilecektir

Ödenmiş içerik alanı (koşullu zorunlu). Kendi çevrimiçi kasanız yoksa Prodamus aracılığıyla ödemelerin fişlendirilmesi için bu bilgiler gerekir. Bu alana satın alma açıklaması, fiyatı ve içeriğin bulunduğu kaynağa bağlantı girilmelidir.

Örneğin: Örnek 'Saç örgüsü kursu', fiyatı 3000 ruble, kurs sayfası bağlantısı: https://nbu.su/krasota/master-po-pleteniyu-kos/?yclid=13602995275739430911.

Bu veriler FNS'ye aktarım için gereklidir.

Ödeme işlevli düğme

Bağlantının geçerlilik süresini belirtirseniz, durumda

1. Kullanıcı, geçerlilik süresi içinde ödeme bağlantısını istediğinde (yani geçerlilik süresi henüz dolmamışken) ve bu bağlantı diyalogda varsa, ödeme yapamaz ve şu tür bir bildirim alır:

Bağlantının geçerlilik süresi mevcut tarihten daha ileri olmalıdır; aksi halde müşteri böyle bir bağlantıyla ödeme yapamaz.

2. Kullanıcı bağlantıyı istediğinde ve bağlantı zaten etkin değilse\nBu durumda düğme yalnızca görünmez. Ve müşteri değişkenlerinde "error_payment_button" adlı değişken oluşur; içinde şu değer bulunur: "Hata: Bağlantının geçerlilik süresi mevcut tarihten daha ileri olmalıdır".

Kullanıcının doğru ödeme yapabilmesi için böyle bir durumu ayrıca işlemeniz önerilir.

Bu nasıl yapılır?

Benzer bir bildirim geldiyse, error_payment_button == "Hata: Bağlantının geçerlilik süresi mevcut tarihten daha ileri olmalıdır" şeklinde belirteceğiniz koşullu bir blok oluşturun

Metin çıktısı olarak: "Üzgünüz, yetişemediniz ve ödeme bağlantısı artık geçersiz":

"Müşteriler" bölümündeki diyalog

"Başlangıç koşulu" bloğu ayarı

Ödeme işlevli düğme kullanıldığında otomatik oluşturulacak müşteri değişkenleri

Kullanıcı "Ödeme" düğmeli bloğu aldığında, müşteri değişkenleri otomatik olarak oluşturulacaktır:

Sistem değişkeni __payments , bu değişken oluşturulan bağlantının tutarını ve kimliğini saklar, ödeme sisteminden gelen webhook'u tanımlamak için gereklidir.

Sistem değişkeni __payments SİLİNEMEZ veya DEĞİŞTİRİLEMEZ!

Müşteri değişkeni error_payment_button blok oluşturulurken hata oluşursa yaratılır.

error_payment_button değişkeninin değerine ya hata metni ya da ödeme sisteminden gelen hata yanıtı yazılır.

Değişkenlerin değerleri sonraki bloğa geçildiğinde güncel hale gelir

Sonuç nasıl işlenir

Başarılı ödeme.

Başarılı ödemeden sonra botta OTOMATİK OLARAK ödeme sisteminden gelen GERİ ÇAĞRI, ödeme sisteminin gizli anahtarının ilk 10 karakteri, _success kelimesi ve boşlukla ayrılmış ödeme tutarından oluşur. Ayar şemalarında kullanmak için onu kopyalamanız yeterli.

Örneğin: ovg58keefc_success 44burada:

ovg58keefc : ödeme sisteminin gizli anahtarının ilk 10 karakteri

_success : isteğin işlenme sonucu (başarılı ödeme)

44 : ödeme tutarı

Ödeme sisteminden gelen geri çağrıları (bildirimleri) kullanıcı GÖRMEZ. Bunlar yalnızca Müşteriler sekmesinde görünür ve operatör tarafından görülebilir.

Kullanım örneği:\n1. adım. "Ödeme düğmeli" blokta Ödeme işlevli düğmeler ekliyoruz.

2. adım. Bu bloktan "Başarılı ödeme" bloğuna giden bağlantının Koşul alanında geri çağrıyı belirtiriz. Aynı şekilde, "Başlangıç koşulu" bloğunun Koşul alanında başarılı ödeme geri çağrısını belirtirseniz de çalışır.

Önemli: Tam eşleşme veya Anahtar kelime varlığı eşleştirmesi seçimi

❗️Eğer ödemeyi tam olarak koşullu ok üzerindeki yerde kontrol etmeye karar verirseniz, şemanızın mantığını iyi düşünün. Müşteri, içinde geri çağrı bulunan koşullu geçişe sahip bloktan ayrılırsa, bloğa geçiş olmayacaktır. Bu kontrol yöntemini yalnızca müşteri hunideki konumunu (şemadaki yerini) değiştirmiyorsa kullanmak mantıklıdır. \nMüşterinin bloklar arasında hareket ettiği şemalarda, "Başlangıç koşulu" bloğunda geri çağrıyı belirtme seçeneğini kullanmak daha iyidir.

Bloğun Koşul alanındaki başarılı ödeme geri çağrısı.

Otomatik aboneliğe sahip ürünler için başarılı ödeme.

Başarılı ödemeden sonra botta OTOMATİK OLARAK ödeme sisteminin gizli anahtarının ilk 10 karakteri, _success kelimesi ve boşlukla ayrılmış abonelik ürün ID'si

Örneğin: 214009eefc_success 618117burada:

009eefc : ödeme sisteminin gizli anahtarının 10 karakteri

_success : isteğin işlenme sonucu (başarılı ödeme)

618117: abonelik ürününün ID'si

Otomatik abonelikli ürünler için Prodamus'tan gelen geri çağrı örneği

Hatalı ödeme

Ödeme gerçekleştirme hatası durumunda bota OTOMATİK OLARAK ödeme sisteminin gizli anahtarının 10 karakteri, _fail kelimesi ve boşlukla ayrılmış ödeme tutarından oluşan GERİ ÇAĞRI gelir

Örneğin, ovg58keefc_fail 44 burada

ovg58keefc : ödeme sisteminin gizli anahtarının 10 karakteri

_fail : isteğin işlenme sonucu - ödeme yapılmadı veya hata oluştu.

44 : ödeme tutarı

Ödeme sistemine bağlıdır. Tüm ödeme sistemleri ödeme hatası geri çağrısı göndermez.

Düğme ayarlarında belirtilen tutar müşterinin ödediği tutardan farklıysa, o zaman OTOMATİK OLARAK ödeme sisteminin gizli anahtarının 10 karakteri, _different_amounts kelimesi ve boşlukla ayrılmış benzersiz ödeme ID'sinden oluşan GERİ ÇAĞRI gelir

Örneğin: ovg58keefc_different_amounts 123456 burada:

ovg58keefc : ödeme sisteminin gizli anahtarının 10 karakteri

_different_amounts : isteğin işlenme sonucu (ödeme tutarı bağlantıdaki tutardan farklı)

123456 : benzersiz ödeme ID'si

Hesaplayıcı'daki get_prodamus_payment_url işlevi

Ödeme bağlantısı oluşturmak için şu işlevi kullanabilirsiniz get_prodamus_payment_url Hesaplayıcı bloğunda.

Hesaplayıcı alanında değişkene işlevin değerini atarız get_prodamus_payment_url

Değişken adını kendiniz belirlersiniz. Ekranlarda değişken adlarına örnekler verilmiştir.

Bu değişkene ödeme bağlantısı yazılır. Değişken mesajda bağlantı olarak ekrana çıkarılabilir veya "Öde" metinli düğmeye yerleştirilebilir.

ÖDEME bağlantısı ÖRNEĞİ: https://payform.ru/7p3JR8/

Hesaplayıcı

Örnek 1:

Parametre açıklaması

Kopyalamak için örnek kod

Blokta bağlantı almak için birden fazla işlev varsa ve hata oluşursa, hata değeri değişkende yazılır error_payment_func

Hata sonuncu Hesaplayıcıdaki işlevde

payment_sum değişkeni ve ek parametreler kullanarak bağlantı oluşturma

Dikkat: değişken payment_sum zorunlu olmayan değişkenlerden sonra son değeri alır payment_description, product_name vb.

Ödeme bağlantısı oluşturmak için, Hesaplayıcı alanında değişkenin değerini ayarlamanız yeterlidir payment_sum. Hemen ardından değişken oluşur prodamus_pay_url.

ÖDEME bağlantısı ÖRNEĞİ:: https://payform.ru/7p3JR8/

Bu değişkeni mesajda bağlantı olarak ekrana çıkarabilir veya "Öde" metinli düğmeye yerleştirebilirsiniz.

Değişken ilan edilmeden önce payment_sum şu isteğe bağlı değişkenler de belirtilebilir:

İşlev parametreleri	Parametre açıklaması
product_name	ürün adı (belirtilmezse 'Fatura ödemesi order_id' ile doldurulur) - aşağıdaki ekran görüntüsünde nerede gösterildiği belirtilmiştir
payment_description	ürün açıklaması (belirtilmezse 'Fatura ödemesi order_id' ile doldurulur, aşağıdaki ekran görüntüsü) - aşağıdaki ekran görüntüsünde nerede gösterildiği belirtilmiştir
discount_value	indirim tutarı (örneğin discount_value = 25 veya discount_value = 50.25)
customer_phone	alıcının telefon numarası, şu parametre gönderildiyse zorunlu değildir
customer_email	alıcı e-postası
link_expired	ödeme bağlantısının geçerlilik süresi, şu formatta gg.aa.yyyy (örneğin 25.01.2021). Ayrıca "Hesaplayıcı" belirtilebilir: link_expired = current_date + 2 (bağlantı 2 gün boyunca 00:00'a kadar geçerli olacaktır)
link_expired	ayrıca tam saatli tarih, boşlukla ayrılarak şu formatta belirtilebilir gg.aa.yyyy ss:dd (örneğin: 25.01.2021 12:23). Ayrıca standart değişkenleri de kullanabilirsiniz; örneğin bağlantı süresini 30 dakika olarak belirleyelim: time = current_time + 30\nlink_expired = "#{current_date} #{time}"
currency	ödeme para birimi, varsayılan olarak "rub". \nParametrelerin tam listesi: rub usd eur kzt\nBu parametre küçük harfle iletilmelidir.
payment_title	ödeme başlığı (127 karaktere kadar). Belirtilmezse şu metinle doldurulur: “Fatura ödemesi payment_id” (payment_id - Salebot'taki sipariş kimliği)
payment_description	ödemenin kısa açıklaması (127 karaktere kadar)
locale	ödeme sayfasının dili, en-US, fr-XC vb. biçiminde belirtilir. Varsayılan - ‘ru-Ru’. Tam liste şu bağlantıda mevcuttur https://developer.paypal.com/api/rest/reference/locale-codes/
products_for_receipt	50 ila 4000 karakter arası, şu formatta dize "sipariş açıklaması - maliyet - satın alınan kaynağa bağlantı”. Örneğin: “‘Çipura avlama’ kursu, fiyatı 4999 ruble, kurs sayfası bağlantısı: https://www.lovilescha.ru/courses/poimai_kilogram/". Zorunlu, eğer kendi çevrimiçi kasanız yoksa, Prodamus üzerinden ödemelerin fişlenmesi için.
payment_sum	(zorunlu) ödeme tutarı

Değişkenler discount_value, customer_phone, customer_email ve link_expired abonelikler için de geçerlidir.

Uygulama örneği.

İlk blokta ödeme tutarını belirliyoruz:

Sonra gerekli yerde url'yi, prodamus_pay_url bağlantısını gösteriyoruz:

prodamus_available_payment_methods payment_sum ilan edilmeden önce tanımlanır.

Olası değerler:

AC	Rusya Federasyonu'nda çıkarılan kartla ödeme
ACkz	Kazakistan kartıyla ödeme
ACf	Rusya hariç BDT ülkelerinin kartlarıyla ödeme
ACEURNMBX	RF ve RB hariç tüm ülkelerin EUR kartıyla ödeme
SBP	Kart bilgisi girmeden hızlı ödeme. RF kartları için
QW	Qiwi cüzdanı
PC	Юmoney
GP	ödeme terminali
sbol	Sberbank Online fatura - Fatura ile ödeme taksit - Prodamus ile taksitli
installment_5_21	Prodamus ile 3 aylık taksit
installment_6_28	Prodamus ile 6 aylık taksit
installment_10_28	Prodamus ile 10 aylık taksit
installment_12_28	Prodamus ile 12 aylık taksit installment_0_0_3 - Tinkoff'tan 3 aylık taksit
installment_0_0_4	Tinkoff'tan 4 aylık taksit
installment_0_0_6	Tinkoff'tan 6 aylık taksit
installment_0_0_10	Tinkoff'tan 10 aylık taksit
installment_0_0_12	Tinkoff'tan 12 aylık taksit
installment_0_0_24	Tinkoff'tan 24 aylık taksit
installment_0_0_36	Tinkoff'tan 36 aylık taksit
kredi	Tinkoff kredisi
vsegdada_installment_0_0_4	ВсегдаДа'dan 4 aylık taksit (available_payment_methods ile çalışmaz)
vsegdada_installment_0_0_6	ВсегдаДа'dan 6 aylık taksit
vsegdada_installment_0_0_10	ВсегдаДа'dan 10 aylık taksit
vsegdada_installment_0_0_12	Ücretsiz olarak 12 aylık ВсегдаДа taksiti
vsegdada_installment_0_0_24	ВсегдаДа'dan 24 aylık taksit
vsegdada_installment_0_0_36	ВсегдаДа'dan 36 aylık taksit
sbrf_installment_0_0_6	SberBank'tan 6 aylık taksit
sbrf_installment_0_0_10	SberBank'tan 10 aylık taksit
sbrf_installment_0_0_12	SberBank'tan 12 aylık taksit
sbrf_installment_0_0_24	SberBank'tan 24 aylık taksit
sbrf_installment_0_0_36	SberBank'tan 36 aylık taksit
otp_installment_0_0_6	“OTP Bank”tan 6 aylık taksit
otp_installment_0_0_10	“OTP Bank”tan 10 aylık taksit
otp_installment_0_0_12	“OTP Bank”tan 12 aylık taksit
otp_installment_0_0_24	“OTP Bank”tan 24 aylık taksit
otp_installment_0_0_36	“OTP Bank”tan 36 aylık taksit
mts_installment_0_0_6	“MTS Bank”tan 6 aylık taksit
mts_installment_0_0_10	“MTS Bank”tan 10 aylık taksit
mts_installment_0_0_12	“MTS Bank”tan 12 aylık taksit
mts_installment_0_0_24	“MTS Bank”tan 24 aylık taksit
mts_installment_0_0_36	“MTS Bank”tan 36 aylık taksit
monetaworld	RF hariç tüm dünya bankalarının kartları
sbrf_bnpl	Sber'den taksitli

Dikey çizgiyle ayırarak birden fazla değer gönderilebilir. Örneğin: prodamus_available_payment_methods = "AC|PC|QW"

prodamus_currency - belirli bir para biriminde tutar göndermek için ek bir parametre. Olası para birimi değerleri: kzt - tenge için eur - euro için usd - dolar için

Böylece bağlantıda belirtilen tutar belirtilen para biriminde olacaktır.

Callback alındığında payment_callback şu parametreye göre hareket etmelisiniz currency ve currency_sum, içinde para birimi ve para birimindeki tutar bulunacaktır.

Önemli! Sayfanızda gerekli para biriminde ödeme yöntemi olup olmadığını kontrol edin; çünkü yoksa, ödeme yöntemleri olmayan sayfaya yönlendirme yapılır. Yöntemler destek üzerinden bağlanır. Etkin olanları sayfa ayarlarında görebilir veya ödeme bağlantısı oluşturarak kontrol edebilirsiniz

"Продамус" ödeme sistemi ödeme sayfası ayarları

Sayfanız için etkinleştirilen ödeme seçenekleri

Sonuç nasıl işlenir

Başarılı ödeme

Önemli! Başarılı ya da başarısız ödemeden sonra bota, ödemenin başarılı olduğunu anlamanızı sağlayacak callback'ler gelir. Bu callback'leri sistemde kullanıcıdan gelen mesajlar olarak görürsünüz; kullanıcı bunları gönderemesin diye bunlar gizli anahtar ve durum eki içerir, örneğin: 453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_success veya 453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_fail. Ayrıca başarılı ödemeden sonra değişken prodamus_payment_completed şu değere ayarlanır True.

Dikkat! Callback'ler gecikmeli gelir, bu yüzden ödeme bağlantısını kullanıcıya gösterdikten sonra şu tür bir mesaj göndermenizi öneririz: “Ödemeden sonra başarılı ödeme tamamlandı mesajını bekleyin”

ÖNEMLİ! Ödeme butonu işleviyle veya Hesap Makinesi içindeki işlevle oluşturulan bağlantılar için, ödemeden sonra bota OTOMATİK OLARAK ödeme sisteminin gizli anahtarının karakterlerinden, _success kelimesinden ve bir boşlukla ayrılmış ödeme tutarından oluşan bir CALLBACK gelir. Ayar şemalarında kullanmak için onu kopyalamanız yeterli.

Örneğin: ovg58keefc_successburada:

ovg58keefc : gizli anahtar tamamı

_success : isteğin işlenme sonucu (başarılı ödeme)

Örneğin, başarılı ödeme işlemi için bir koşul bloğu ile işleme yapabilir ve kullanıcıya uygun mesajı gösterebilirsiniz:

Karşılaştırma türü "Tam eşleşme"

Tekrar ödeme yapmak için daha önce oluşturulmuş payment_sum bağlantısını mutlaka sıfırlamanız ve ancak ondan sonra fresh bağlantı almak için payment_sum değişkenini yeniden atamanız gerekir

Aboneliği devre dışı bırakma/yeniden etkinleştirme

Ayrıca Продамус'ta aboneliğin etkinleştirilmesi/devre dışı bırakılmasıyla ilgili bildirimler vardır:

1. "Abone aboneliği devre dışı bıraktı" - abonelik manuel olarak iptal edilirse (örneğin abonelikten vazgeçtiyse).

Mevcut ödenmiş dönemin bitiminden önce gelebilir. Bu, sizin takdirinize bağlı bir eylem anlamına gelir - yok saymak veya kontrole almak, aboneyi geri kazanmaya çalışmak.

1. "Abone aboneliği yeniden etkinleştirdi" - aboneliğin geri yüklenmesi.

Abone, mevcut ödenmiş dönemin bitiminden önce aboneliği yeniden etkinleştirirse gelebilir. Bu, sizin takdirinize bağlı bir eylem anlamına gelir - yok saymak veya geri dönüş izleme listesinden silmek.

1. "Aboneliğin devre dışı bırakılması" - abonelik birkaç başarısız tahsilattan sonra devre dışı bırakılırsa

Callback'ten değerler nasıl kaydedilir

Başarılı ödeme bildirimi alındıktan sonra, müşterinin talebine (payment_callback değişkeni) prodamus'tan alınan tüm ödeme verilerini içeren callback yazılır. Buradan gerekli verileri kaydedip kendi isteğinize göre kullanabilirsiniz. Callback örneği:

{"date": "2021-03-30T11:44:43+03:00", "order_id": "757679", "order_num": "", "domain": "demo.payform.ru", "sum": "14.50", "customer_phone": "[phone]", "customer_extra": "Burada ürün açıklaması", "payment_type": "Plastik kart Visa, MasterCard, МИР", "commission": "3.5", "commission_sum": "0.51", "attempt": "1", "discount_value": "10.5", "products[0][name]": "Eğitim materyallerine erişim", "products[0][price]": "14.50", "products[0][quantity]": "1", "products[0][sum]": "14.50", "payment_status": "success", "payment_status_description": "Başarılı ödeme", "payment_init": "manual"}

Bağlantı oluşturulurken değişkenler belirtilebilir product_name ve payment_description. Böylece callback alındığında bunları şöyle çekebilirsiniz

product = get(payment_callback,'products[0][name]')

description = get(payment_callback,'customer_extra')

Dikkat: değişken payment_sum zorunlu olmayan değişkenlerden sonra son değeri alır payment_description, product_name

Tutar şu şekilde alınabilir summa = get(payment_callback,'sum')

Hangi callback'ler kullanılabilir

Başarılı ödeme ile ilgili ana callback'lere ek olarak, kullanıcıyla yapılan sohbette kullanıcının görmediği ve şu metinlere sahip bir mesaj gösterilir:

1. Abone aboneliği devre dışı bıraktı (daha fazla bilgi burada)

2. Abone aboneliği yeniden etkinleştirdi (daha fazla bilgi burada)

3. Abonelik sona erdi

4. Başarısız ödeme - açıklamalı ek (yukarıdaki ekran görüntüsünde)

5. Yaklaşan tahsilat bildirimi - yaklaşan tahsilatın tarih ve saati

6. Şu statüde taksit başvurusu

Müşteriyle diyalogda callback örnekleri:

• Abone aboneliği devre dışı bıraktı

• Abone aboneliği yeniden etkinleştirdi

• Abonelik sona erdi

• Başarısız ödeme - Yetersiz bakiye.

• Başarısız ödeme - Kartın son kullanma tarihi dolmuş.

• Başarısız ödeme - Kart limiti aşıldı.

• Başarısız ödeme - Kart kayıp

• Başarısız ödeme - Sistem hatası

• Başarısız ödeme - İşlem reddedildi. Kartı veren bankayla iletişime geçin.

• Başarısız ödeme - İşlem, kartı veren banka tarafından reddedildi.

• Başarısız ödeme - İşlem banka tarafından reddedildi.

• Yaklaşan tahsilat bildirimi - gg.aa.yyyy ss:dd

• Taksit başvurusu onaylandı

• Taksit başvurusu iptal edildi

• Taksit başvurusu reddedildi

Hata açıklamasını daha ayrıntılı olarak burada okuyabilirsiniz:

Коды ошибокhelp.prodamus.ru

Продамус: hata kodları

İsteğe bağlı olarak kullanıcıya bir mesaj gönderimi ayarlanabilir. Örneğin, otomatik tahsilatın başarısız olduğunu bildiren bir mesaj gönderelim. Şu bildirim için belirli bir nedenden dolayı başarısız ödemeiçin bir yanıt bloğu şu şekilde ayarlanabilir:

Belirli bir nedene sahip Başarısız ödeme bildirimleri için blok örneği

Mesaj göndermek için nedenden bağımsız tüm başarısız tahsilatlar içinşu şekilde ayarlanabilir:

herhangi bir neden açıklamasıyla Başarısız ödeme bildirimleri için blok örneği

Ve metin içeren tüm callback'ler için Başarısız ödemekullanıcıya sizin belirttiğiniz metinle bir mesaj gönderilecektir.

Abonelik ödemeleri nasıl oluşturulur

Abonelik nasıl oluşturulur

Abonelik oluşturmak için abonelik ürünü oluşturmanız gerekir. Bunu nasıl yapacağınıza dair ayrıntılı talimat: https://help.prodamus.ru/payform/rekurrent-i-kluby/kak-sozdat-i-nastroit-podpiski

Sonra abonelik ürününün id'sini kopyalıyoruz, aşağıda nereden alınacağı gösterilmiştir:

Abonelik ürünü oluşturma

Abonelik ödemesi için bağlantı oluşturmak üzere, değişkenin değerini (abonelik ürünü id'si) ayarlamanız gerekir prodamus_subscriptionbunun hemen ardından değişken prodamus_pay_url.

Değişkeni prodamus_pay_url ekranda bir bağlantı olarak gösterebilir veya "Öde" metinli butona yerleştirebilirsiniz. Bağlantı şu şekildedir: https://payform.ru/7p3JR8/

Sonucun işlenmesi, tek seferlik ödemedekiyle aynıdır (yukarıyı okuyun).

Başarılı abonelikten sonra kullanıcıya, ödeme sırasında girilen telefon numarası customer_phone değişkeni eklenecektir. Telefon numarası aboneliği yönetmek için gereklidir.

customer_phone, customer_email gönderilmediyse aboneliği yönetmek için gereklidir

get_prodamus_subscription_url fonksiyonuyla abonelik bağlantısı nasıl oluşturulur

Abonelik ürününün ödeme bağlantısını oluşturmanın başka bir yolunu inceleyelim.

Prodamus panelinde abonelik ürünü oluşturuyoruz. Bunu nasıl yapacağınıza dair ayrıntılı talimat: https://help.prodamus.ru/payform/rekurrent-i-kluby/kak-sozdat-i-nastroit-podpiski

Sonra abonelik ürününün id'sini kopyalıyoruz, aşağıda nereden alınacağı gösterilmiştir:

Abonelik ürünü oluşturma

Abonelik ürünü için ödeme bağlantısı almak için Hesap Makinesi'nde şu fonksiyonu belirtiyoruz

get_prodamus_subscription_url(subscription_id, product_name, expired, customer_phone, customer_email, discount, description, extra_params, products_for_receipt)

Hesaplayıcı

Örnek 1: Abonelik ürünü için ödeme bağlantısı

Parametre açıklaması

Kopyalamak için örnek kod

Blokta bağlantı almak için birden fazla işlev varsa ve hata oluşursa, hata değeri değişkende yazılır error_payment_func

Hata sonuncu Hesaplayıcıdaki işlevde

Abonelik durumu nasıl yönetilir

Yöntem yalnızca gerçek aboneliklerde çalışır, demo modunda kart eşleştirmesi yoktur

Aboneliği yönetmek için zorunlu parametrelerden biri olan customer_phone veya customer_email gönderilmelidir.

Kullanıcının abonelikten çıkmasını sağlamak için bir blok oluşturup şu fonksiyonu çağırmanız gerekir: https://store.salebot.pro/function/delete_subscription_prodamus

Parametrelerle:

{ "customer_phone": "#{customer_phone}", "id_subscription":"#{prodamus_subscription}", "url":"https://demo.payform.ru/", "secret_key":"453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66", "switcher":"0" "profile_id":"12345" }

url - kurucu ayarlarında belirtilen ödeme formu URL'si secret_key - ayarlardaki gizli anahtar id_subscription - abonelik ürününün id'si customer_phone - abonenin telefon numarası switcher = 0 aboneliğin durdurulmasıdır, 1 gönderilirse abonelik yeniden etkinleşir. profile_id - Продамус sistemindeki profil ID'si

Dikkatinizi çekiyoruz!

Profil ID gelirse, değer profile_id değişkenine kaydedilir.

profile_id, aboneliği iptal etmek için customer_phone veya customer_email yerine delete_subscription_prodamus fonksiyonuna gönderilebilir.

Abonelik bloğu ayar örneği:

Fonksiyonun status döndürdüğüne dikkat edin; bunu kaydeder ve kendi takdirinize göre işleyebilirsiniz, başarılı devre dışı bırakma\etkinleştirme durumunda status eşittir ok

Aboneliği yönetme fonksiyonu

prodamus_subscription_switch_status(subscription_id, switcher, customer_phone, customer_email, profile_id)

id_subscription - abonelik ürününün id'si

switcher = 0 aboneliğin durdurulmasıdır, 1 gönderilirse abonelik yeniden etkinleşir.

customer_phone - abonenin telefon numarası - customer_email gönderildiyse isteğe bağlıdır

customer_email - abonenin e-posta adresi - customer_phone gönderildiyse isteğe bağlıdır

profile_id - Продамус sistemindeki profil ID'si

prodamus_subscription_switch_status fonksiyonunun kullanım örneği

Örnek: parametre gönderildi customer_phone, customer_email atlandı stat = prodamus_subscription_switch_status('618117', '0', '75431312321')

Örnek 2: parametre gönderildi customer_email, customer_phone atlandı stat = prodamus_subscription_switch_status('618117', '0', '', '[e-mail]')

Fonksiyon, her şey başarılıysa ok döndürür veya hata açıklamasını döndürür

Abonelikte indirim yönetimi

Fonksiyon, abonelikte sonraki ödemeler için indirim miktarını belirler. İndirim, sınırlı veya sınırsız sayıda tahsilat için ayarlanabilir.

prodamus_subscription_discount(subscription_id, discount, customer_phone, num, profile_id) burada: subscription_id - abonelik ID'si discount - noktadan sonra iki basamağa kadar hassas ondalık sayı nokta, değer sıfırdan büyük olmalı ve aboneliğin temel ücretini aşmamalıdır customer_phone - müşteri telefon numarası şu formatta: [phone] (customer_email değişkeni varsa isteğe bağlı parametre, 1. ödeme sonrası açıklamada belirtildiği gibi) num - İndirimin geçerli olacağı ödeme sayısı (isteğe bağlı parametre; gönderilmezse indirimli ödeme sayısı sınırsız olur)

profile_id - Продамус sistemindeki profil ID'si İstek başarıyla tamamlanırsa fonksiyon 'ok' döndürür, istek hata ile çalışırsa fonksiyon hata açıklamasını döndürür.

İndirim miktarı ve aralık SADECE fonksiyon yeni değerlerle tekrar çağrılırsa yeniden yazılır!

Örnekler:

1. Telefon numarası belirtilmeden, müşteri_phone değişkeninden otomatik alınacağı için, sonraki tüm otomatik ödemeler için 1 ruble tutarında indirim ayarlama ve indirimli tahsilat sayısı varsayılan olarak abonelik süresinin tamamı

r = prodamus_subscription_discount('624034', '1')

Örnek 1

2. Sonraki 3 tahsilat için 2 ruble indirim ayarlama (telefon numarası boş tırnaklarla değiştirilir, çünkü otomatik olarak customer_phone değişkeninden alınacaktır)

r = prodamus_subscription_discount('624034', '2', '', '3')

Örnek 2

3. İndirimi kesirli kısmı yüzdeye kadar olan bir sayı olarak uygulama örneği (ayırıcı nokta), sayısal veriler tırnaksız belirtilir, telefon numarası değişken üzerinden gönderilir

r = prodamus_subscription_discount(#{prodamus_subscription}, 10.25, #{customer_phone}, 3)

Örnek 3

Aboneliğe sonraki ödeme tarihi nasıl ayarlanır

Bu yöntemle aboneliğin sonraki ödeme tarihi kaydırılabilir. Tarih yalnızca mevcut olarak belirlenmiş sonraki ödeme tarihine göre "geleceğe" kaydırılabilir. Böylece kulüpte kalma süresi uzatılır.

Örneğin, aboneler için bonus olarak kullanılabilir.

Bunun için şu fonksiyonu kullanmalısınız:

prodamus_subscription_payment_date(subscription_id, date, customer_phone, profile_id)

burada:

subscription_id - abonelik id'si date - tarih dd.aa.yyyy ss:dd formatında veya dd.aa.yyyy formatında, bu durumda saat 00:00 olur customer_phone - zorunlu değildir; gönderilmezse customer_phone değişkeninden alınır, orada da bulunamazsa çalışmaz profile_id - Продамус sistemindeki profil ID'si

Parametreler Prodamus'a nasıl iletilir

Gerekli parametreleri Prodamus'a iletmek için (örneğin aboneliğin başlangıç tarihi, taksit seçeneğini kapatma vb.), değişken adının başına prodamus_ ekleyin

Böylece ödeme bağlantısı oluşturulurken bu parametreler ödeme sistemine otomatik olarak iletilecektir.

Ödemeyi nasıl test ederim

Yalnızca ödemeyi test ediyoruz!

Entegrasyonu ve ödeme hunisi ayarlarını test ederken hesabınızdan para çekilmemesi için test kartlarını kullanabilirsiniz

Önce ödeme sayfanızı DEMO moduna alın ⤵

"Kaydet" düğmesine basmayı unutmayın

Test ödemesi yapmak için test hesaplarını kullanabilirsiniz

Sberbank test kartları:

МИР Kart numarası 2202 2050 0001 2424 Son kullanma tarihi 05/35 Arka yüzdeki doğrulama kodu 669

MasterCard Kart numarası 5469 9801 0004 8525 Son kullanma tarihi 05/26 Arka yüzdeki doğrulama kodu 041 3-D Secure doğrulama kodu 111111

Visa Kart numarası 4006 8009 0096 2514 Son kullanma tarihi 05/26 Arka yüzdeki doğrulama kodu 941 3-D Secure doğrulama kodu 111111

! Test hesaplarıyla ödeme yapıldığında tüm yapılandırılmış akışlar ve entegrasyonlar normal ödemedeki gibi çalışır !

Form test edildi

Gerçek para ile ödeme almak için formu çalışma moduna geçirmeniz gerekir. Yani demo modu anahtarını, soluk kırmızı olacak konuma getirin