Prodamus (RU)

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

Prodamus nasıl bağlanır

Prodamus’u bağlamak için ödeme formu URL’si ve gizli anahtar gerekecektir.

Ödeme formu URL’si kayıt olduktan sonra alırsınız, şu biçimdedir: demo.payform.ru

Gizli anahtar kişisel hesaptan alınabilir; aynı yerde bildirimler için URL adresi de tanımlanmalıdır.

"Prodamus" ödeme sistemi kişisel hesabındaki form ayarlarında gizli anahtar

Bunu nasıl yapacağınıza 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 adres ayarlarda iki yerde belirtilmelidir.

Ana ayar sayfasında formun ç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

ile çalışma ayarı için abonelik ödemeleri Abonelikler sekmesine gidin ve bildirim adresini belirtin: https://chatter.mavibot.ai/prodamus_callback/result

Dikkat! URL girildikten sonra mutlaka "Kaydet" düğmesine basın.

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

Daha sonra yukarıda bahsedilen bilgileri forma belirtmeniz yeterlidir:

ÖNEMLİ! URL - ödeme formu için https:// olmadan belirtin

Bağlantı bu kadar. Şimdi bu işlevi nasıl kullanacağımıza bakalım.

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

Blok içinde ödeme bağlantısı oluşturabilirsiniz ŞUNLARDAN BİRİYLE mevcut yöntemlerden:

• Ödeme işlevli düğme veya

• Hesaplayıcıda get_prodamus_payment_url işlevi veya

• payment_sum değişkeni ve ek parametreler kullanarak bağlantı oluşturma (eski ç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 belirtilmesi gereken zorunlu parametreler "Tutar", "Ürün adı", ayrıca "Ödenen içerik" parametresi, eğer kendi online kasanız yoksa ve Prodamus’tan makbuz almak istiyorsanız.

Sipariş oluşturma sayfasına geçildiğinde ürün bilgisi ve fiyatı önceden yazılmış olur; müşterinin yalnızca iletişim bilgilerini girmesi gerekir. Düğme ayarlarında kullanıcının e-postası ve/veya telefonu belirtilirse, sipariş oluşturma sayfasında ödeyenin iletişim bilgileri ile ürün ve fiyat bilgisi gösterilir.

Buton 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çiyoruz

Ödeme sistemi alanı. Listede projeye bağlı ödeme sistemleri gösterilir

Projeye herhangi bir ödeme sistemi bağlı değilse bu düğme türü kullanılamaz

Ürün adı alanı (zorunlu). Bu alana ürünün adını yazmanız gerekir. Ürün adı ne kadar doğru belirtilirse o kadar iyidir. Örneğin: Telefon değil, Xiaomi Akıllı Telefon modeli ...

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

Tutar alanı (zorunlu). Bu alanda ürünün fiyatını belirtiriz.

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

• Sipariş açıklaması

• Ruble cinsinden indirim

• Alıcının e-postası için değişken

• Alıcının telefon numarası için değişken

• Bağlantının geçerlilik süresi

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

• Ödenen içerik

Tıklama bildirimi onay kutusu. Ödeme bağlantısı tıklamasını izlemek için onay kutusu işaretlenebilir. Bu durumda düğmeye tıklanınca, müşteriyle olan diyaloğa SaleBot üzerinden bağlantıya geçildiğine dair bir bildirim gelir

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

Bu bildirime göre botun sonraki iş mantığı ayarlanabilir.

Birçok ödeme sistemi bulut tabanlı online kasaları destekler; bunlar 54-FZ gereği zorunludur. Vergi dairesiyle sorun yaşamamak için seçtiğiniz ödeme sisteminin sitesinde fiş düzenleme özelliklerini okuyun.

Ödeme düğmesindeki bağlantıya gidildiğinde açılan ödeme sayfası böyle görünür:

Ödeme sayfası: butonda yalnızca temel parametreler doldurulmuş

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

Sipariş açıklaması alanı. Bu alanda belirtilen bilgiler ödeme sayfasında Ek veriler alanında gösterilecektir

İndirim alanı. Bu alanda indirim tutarını ruble olarak veya kuruşlu ruble olarak belirtebilirsiniz. Kuruşlu tutar belirtmek için ayırıcı olarak nokta kullanılır: 50.99 Ödeme sayfasında Ödenecek tutar alanı indirim dikkate alınarak gösterilir ve ürünün asıl fiyatı üstü çizili olur.

Alıcının e-postası için değişken alanı (telefon numarası gönderildiyse isteğe bağlı) Bu alanda kullanıcının (müşterinin) e-postası belirtilir. Kullanıcının e-postasının saklandığı değişken belirtilebilir.

Örneğin, #{email}

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

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

Bağlantının geçerlilik süresi alanı. gg.aa.yyyy ss:dd biçiminde bir tarih belirtebilir (örneğin 25.01.2021 11:00) veya bağlantının sona erme süresini atamak için değişkenler kullanabilirsiniz. Değişken kullanım örneği: #{link_expired}

abonelik ürününün ID alanı. Otomatik ödeme yapmak 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, ayrıntılı talimat: https://help.prodamus.ru/payform/rekurrent-i-kluby/kak-sozdat-i-nastroit-podpiski

Abonelik ürününün ID değeri iletilirse ödeme tutarı dikkate alınmaz. Ürün verileri Prodamus panelindeki ürün kartından alınır

Ödeme sırasında belirtilen telefon numarası, aboneliği yönetmek için gerekli olacaktır.

Eğer abonelik ürününün ID’siiletilirse, başarılı ödeme geri çağrısında bu ürünün ID’si gönderilir

Ödenen içerik alanı (koşullu zorunlu). Eğer kendi online kasanız yoksa Prodamus üzerinden ödemeyi mali kayda geçirmek için gereklidir. Bu alanda satın almanın açıklamasını, fiyatını ve içerik kaynağına bağlantıyı belirtmeniz gerekir.

Örneğin: "Kazık örme kursu", fiyatı 3000 ruble, kurs sayfası bağlantısı: https://nbu.su/krasota/master-po-pleteniyu-kos/?yclid=13602995275739430911.

Bu veriler GİB’e iletim için gereklidir.

Ödeme işlevli düğme

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

1. Kullanıcı aktif süresi içinde ödeme bağlantısı isterse (yani süresi henüz dolmadıysa) ve bu bağlantı diyalogda varsa, ödeme yapamaz ve aşağıdaki türde bir bildirim alır:

Bağlantının geçerlilik süresi mevcut tarihten sonra olmalıdır, aksi halde müşteri bu bağlantıyla da ödeme yapamaz.

2. Kullanıcı bağlantıyı ister ancak bağlantı zaten pasifse Bu durumda düğme hiç görünmez. Müşterinin değişkenlerinde "error_payment_button" değişkeni oluşur ve içinde şu değer bulunur: "Hata: Bağlantının geçerlilik süresi mevcut tarihten sonra olmalıdır".

Kullanıcının doğru şekilde ödeme yapabilmesi için bu durumun ayrıca işlenmesi tavsiye edilir.

Bu nasıl yapılır?

Bir koşul bloğu oluşturun ve içinde bu tür bir bildirim geldiyse, error_payment_button == "Hata: Bağlantının geçerlilik süresi mevcut tarihten sonra olmalıdır" yazın

Şu metinle: "Üzgünüz, zamanında yetişemediniz ve ödeme bağlantısı artık geçersiz":

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

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

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

Kullanıcı "Ödeme" düğmeli bloğu alır almaz aşağıdaki müşteri değişkenleri otomatik oluşturulacaktır:

Sistem müşteri değişkeni __payments , oluşturulan bağlantının tutarını ve kimliğini saklar; ödeme sisteminden gelen hook’u tanımlamak için gereklidir.

__payments sistem müşteri değişkeni SİLİNEMEZ veya DEĞİŞTİRİLEMEZ!

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

error_payment_button değişkeninin değeri ya hata metnini ya da ödeme sisteminden gelen hata yanıtını içerir.

Değişken değerleri bir sonraki bloğa geçildiğinde güncel olur

Sonuç nasıl işlenir

Başarılı ödeme.

Başarılı ödemeden sonra botta OTOMATİK OLARAK ödeme sisteminin gizli anahtarının ilk 10 karakterinden, _success kelimesinden ve bir boşlukla ödeme tutarından oluşan BİR GERİ ÇAĞRI gelir. Bunu şema ayarlarında kullanmak için sadece kopyalamanız yeterlidir.

Örneğin: ovg58keefc_success 44, burada:

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ülür.

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

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

Önemli: Eşleşme türü Tam eşleşme veya Anahtar kelime varlığı olmalı

❗️Ödemeyi özellikle koşul okunda kontrol etmeye karar verdiyseniz, şemanızın mantığını iyi düşünün. Müşteri geri çağrılı koşullu geçiş bloğunu terk ederse bloğa geçiş olmaz. Bu kontrol yöntemi yalnızca müşteri hunideki konumunu (şemadaki yerini) değiştirmiyorsa mantıklıdır. Müşterinin bloklar arasında hareket ettiği şemalarda, "Başlangıç koşulu" bloğunda geri çağrı belirtilen yöntemi kullanmak daha iyidir.

Başarılı ödeme callback’i, blokun Koşul alanında.

Otomatik aboneliği olan ü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 karakterinden, _success kelimesinden ve bir boşlukla abonelik ürününün ID’sinden oluşan BİR GERİ ÇAĞRI gelir

Örneğin: 214009eefc_success 618117, burada:

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 callback örneği

Hatalı ödeme

Ödeme yapılırken hata oluştuğunda botta OTOMATİK OLARAK ödeme sisteminin gizli anahtarının 10 karakterinden, _fail kelimesinden ve bir boşlukla ödeme tutarından oluşan BİR 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 hatayla sonuçlandı.

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 karakterinden, _different_amounts kelimesinden ve bir boşlukla benzersiz ödeme ID’sinden oluşan BİR 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ıdır)

123456 : benzersiz ödeme ID’si

Hesaplayıcıda get_prodamus_payment_url işlevi

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

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

Değişken adını siz belirlersiniz. Ekran görüntülerinde değişken adlarına örnekler yer alır.

Bu değişkene ödeme bağlantısı yazılacaktır. Değişken mesajda bağlantı olarak gösterilebilir 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 kod örneği

Bir blokta bağlantı almak için birden fazla işlev varsa ve hata oluşursa, hata değeri değişkende kaydedilir error_payment_func

Hata, en son Hesaplayıcıdaki işlev tarafından kaydedilir

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

Dikkat: değişkene payment_sum değeri sonuncu olarak, isteğe bağlı değişkenlerden sonra atanır payment_description, product_name vb.

Ödeme bağlantısı oluşturmak için Hesaplayıcı alanında değişkenin değerini belirlemeniz yeterlidir payment_sum. Bundan hemen sonra değişken oluşacaktır prodamus_pay_url.

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

Bu değişken mesajda bağlantı olarak gösterilebilir veya "Öde" metinli düğmeye yerleştirilebilir.

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

Fonksiyon 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örüntülendiği gösterilmektedir
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örüntülendiği gösterilmektedir
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ının e-postası
link_expired	ödeme bağlantısının geçerlilik süresi, şu biçimde gg.aa.yyyy (örneğin 25.01.2021). Ayrıca "Hesaplayıcı" alanında şunu belirtebilirsiniz: link_expired = current_date + 2 (bağlantı 2 gün boyunca 00:00’a kadar geçerli olacaktır)
link_expired	Ayrıca tam saati boşlukla birlikte şu biçimde belirtebilirsiniz gg.aa.yyyy ss:dd (örneğin: 25.01.2021 12:23). Ayrıca standart değişkenler de kullanılabilir; örneğin bağlantının geçerlilik süresini 30 dakika olarak belirleyelim: time = current_time + 30 link_expired = "#{current_date} #{time}"
currency	ödeme para birimi, varsayılan olarak "rub". Argümanların tam listesi: rub usd eur kzt Bu parametre küçük harfle gönderilmelidir.
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çimde belirtilir. Varsayılan - ‘ru-Ru’. Tam liste https://developer.paypal.com/api/rest/reference/locale-codes/ bağlantısında mevcuttur/
products_for_receipt	50 ile 4000 karakter arasında, şu formatta bir dize "sipariş açıklaması - tutar - satın alınan kaynağa bağlantı”. Örneğin: “‘Levrek Avı’ kursu, fiyatı 4999 ruble, kurs sayfası bağlantısı: https://www.lovilescha.ru/courses/poimai_kilogram/". Zorunlueğer kendi online kasanız yoksa, Prodamus üzerinden ödemeleri mali kayda geçirmek 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 prodamus_pay_url bağlantısını gösteriyoruz:

prodamus_available_payment_methods payment_sum tanımlanmadan önce ilan edilir.

Olası değerler:

AC	RF’de düzenlenmiş kartla ödeme
ACkz	Kazakistan kartıyla ödeme
ACf	RF hariç BDT ülkeleri 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 invoice - Fatura üzerinden ödeme installment - Prodamus’tan taksitli
installment_5_21	Prodamus’tan 3 ay taksitli
installment_6_28	Prodamus’tan 6 ay taksitli
installment_10_28	Prodamus’tan 10 ay taksitli
installment_12_28	Prodamus’tan 12 ay taksitli installment_0_0_3 - Tinkoff’tan 3 ay taksitli
installment_0_0_4	Tinkoff’tan 4 ay taksitli
installment_0_0_6	Tinkoff’tan 6 ay taksitli
installment_0_0_10	Tinkoff’tan 10 ay taksitli
installment_0_0_12	Tinkoff’tan 12 ay taksitli
installment_0_0_24	Tinkoff’tan 24 ay taksitli
installment_0_0_36	Tinkoff’tan 36 ay taksitli
credit	Tinkoff kredisi
vsegdada_installment_0_0_4	ВсегдаДа’dan 4 ay taksitli (available_payment_methods ile çalışmaz)
vsegdada_installment_0_0_6	ВсегдаДа’dan 6 ay taksitli
vsegdada_installment_0_0_10	ВсегдаДа’dan 10 ay taksitli
vsegdada_installment_0_0_12	ВсегдаДа’dan 12 ay faizsiz taksitli
vsegdada_installment_0_0_24	ВсегдаДа’dan 24 ay taksitli
vsegdada_installment_0_0_36	ВсегдаДа’dan 36 ay taksitli
sbrf_installment_0_0_6	SberBank’tan 6 ay taksitli
sbrf_installment_0_0_10	SberBank’tan 10 ay taksitli
sbrf_installment_0_0_12	SberBank’tan 12 ay taksitli
sbrf_installment_0_0_24	SberBank’tan 24 ay taksitli
sbrf_installment_0_0_36	SberBank’tan 36 ay taksitli
otp_installment_0_0_6	OTP Bank’tan 6 ay taksitli
otp_installment_0_0_10	OTP Bank’tan 10 ay taksitli
otp_installment_0_0_12	OTP Bank’tan 12 ay taksitli
otp_installment_0_0_24	OTP Bank’tan 24 ay taksitli
otp_installment_0_0_36	OTP Bank’tan 36 ay taksitli
mts_installment_0_0_6	MTS Bank’tan 6 ay taksitli
mts_installment_0_0_10	MTS Bank’tan 10 ay taksitli
mts_installment_0_0_12	MTS Bank’tan 12 ay taksitli
mts_installment_0_0_24	MTS Bank’tan 24 ay taksitli
mts_installment_0_0_36	MTS Bank’tan 36 ay taksitli
monetaworld	RF hariç dünya bankalarının kartları
sbrf_bnpl	Sber’den taksitli

Birden fazla değer, dikey çizgi ile ayrılarak gönderilebilir. Örneğin: prodamus_available_payment_methods = "AC|PC|QW"

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

O zaman bağlantıda belirtilen tutar, belirtilen para biriminde olacaktır.

Geri çağrı alındığında payment_callback şu parametreye göre hareket edilmelidir currency ve currency_sum, hangi para birimi ve tutarın o para biriminde olduğu bilgisi bulunacaktır.

Önemli! İstediğiniz para biriminde ödeme yöntemi sayfanızda var mı kontrol edin; yoksa ödeme yöntemleri olmayan sayfaya yönlendirilir. Yöntemler destek üzerinden eklenir. Açık olanlar sayfa ayarlarında veya ödeme bağlantısı oluşturulduğunda görülebilir

"Prodamus" ödeme sistemi ödeme sayfası ayarları

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

Sonuç nasıl işlenir

Başarılı ödeme

Önemli! Başarılı ya da başarısız ödemeden sonra botta geri çağrılar gelir; bunlardan ödemenin başarılı olup olmadığını anlayabilirsiniz. Sistemde bu geri çağrıları kullanıcı mesajı gibi görürsünüz; bunların kullanıcı tarafından gönderilememesi için gizli anahtardan ve durum ekinden oluşurlar, örneğin: 453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_success veya 453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_failAyrıca başarılı ödemeden sonra değişken prodamus_payment_completed şuna ayarlanır True.

Dikkat! Geri çağrılar 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ı tamamlanma mesajını bekleyin”

ÖNEMLİ! Ödeme işlevli düğme veya Hesaplayıcıdaki işlev kullanılarak oluşturulan bağlantılar için, ödemeden sonra botta OTOMATİK OLARAK ödeme sisteminin gizli anahtar karakterlerinden, _success kelimesinden ve bir boşlukla ödeme tutarından oluşan BİR GERİ ÇAĞRI gelir. Bunu şema ayarlarında kullanmak için sadece kopyalamanız yeterlidir.

Örneğin: ovg58keefc_success, burada:

ovg58keefc : gizli anahtar tam olarak

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

Örneğin, koşullu bir blokla başarılı ödeme işlenebilir ve kullanıcıya uygun mesaj gösterilebilir:

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

Tekrar ödeme yapmak için payment_sum değerini sıfırlamak, daha önce oluşturulan bağlantıyı temizlemek ve ancak bundan sonra fresh bağlantı almak için payment_sum değişkenini yeniden atamak zorunludur

Aboneliğin devre dışı bırakılması/yeniden etkinleştirilmesi

Prodamus’ta aboneliğin etkinleştirilmesi/devre dışı bırakılmasına ilişkin bildirimler de vardır:

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

Mevcut ödenmiş dönem bitmeden önce gelebilir. İsteğe bağlı olarak görmezden gelme veya kontrol altına alma, aboneliği geri kazanma denemesi anlamına gelir.

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

Abone mevcut ödenmiş dönem bitmeden önce aboneliği yeniden etkinleştirirse gelebilir. İsteğe bağlı olarak görmezden gelme veya geri dönüş izleme listesinden silme anlamına gelir.

1. "Abonelik devre dışı bırakıldı" - birkaç başarısız çekimden sonra abonelik devre dışı bırakılırsa

Geri çağrıdaki 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 ve gelen ödeme ile ilgili tüm verileri içeren geri çağrı yazılır. Buradan gerekli verileri kaydedebilir ve istediğiniz gibi kullanabilirsiniz. Geri çağrı ö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, MIR", "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. O zaman geri çağrı alındığında bunları şöyle çekebilirsiniz

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

description = get(payment_callback,'customer_extra')

Dikkat: değişkene payment_sum değeri sonuncu olarak, isteğe bağlı değişkenlerden sonra atanır payment_description, product_name

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

Hangi geri çağrılar mevcut

Başarılı ödeme ile ilgili ana geri çağrıların dışında, kullanıcıyla yapılan sohbette kullanıcının görmediği ve şu metinleri içeren 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 tamamlandı

4. Başarısız ödeme - açıklamalı not (yukarıdaki ekranda)

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

6. Durumlu taksit başvurusu

Müşteri diyalogundaki geri çağrı örnekleri:

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

• Abone aboneliği yeniden etkinleştirdi

• Abonelik tamamlandı

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

• Başarısız ödeme - Kartın süresi dolmuş.

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

• Başarısız ödeme - Kart kayboldu

• 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çıklamalarını daha ayrıntılı okumak için buraya bakabilirsiniz:

Коды ошибок | Prodamushelp.prodamus.ru

Prodamus: hata kodları

İsteğe bağlı olarak kullanıcıya bir mesaj gönderimi ayarlanabilir. Örneğin, otomatik çekimin başarısız olduğunu belirten bir mesaj gönderelim. Şu bildirim için belirli bir nedene bağlı başarısız ödemebir yanıt bloğu ayarlanabilir, örneğin şöyle:

belirli bir nedene bağlı başarısız ödeme bildirimleri için örnek blok

Mesaj göndermek için nedeni ne olursa olsun tüm başarısız çekimlereşu şekilde ayarlanabilir:

herhangi bir neden açıklamasıyla başarısız ödeme bildirimleri için örnek blok

Ve metin içeren tüm geri çağrılarda 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. Nasıl yapılacağına dair ayrıntılı talimat: https://help.prodamus.ru/payform/rekurrent-i-kluby/kak-sozdat-i-nastroit-podpiski

Daha sonra abonelik ürününün ID’sini kopyalıyoruz, aşağıda nereden alınacağı gösterilmiştir:

Abonelik ürününün oluşturulması

Abonelik ödeme bağlantısı oluşturmak için değişkenin değerini (abonelik ürününün ID’si) belirlemeniz gerekir prodamus_subscriptionhemen ardından değişken oluşacaktır prodamus_pay_url.

Değişken prodamus_pay_url ekrana bağlantı olarak çıkarılabilir veya "Öde" metinli düğmeye yerleştirilebilir. Bağlantı şu biçimdedir: https://payform.ru/7p3JR8/

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

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

customer_phone, customer_email gönderilmemişse aboneliği yönetmek için gereklidir

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

Abonelik ürünü için ödeme bağlantısı oluşturmanın başka bir yoluna bakalım.

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

Daha sonra abonelik ürününün ID’sini kopyalıyoruz, aşağıda nereden alınacağı gösterilmiştir:

Abonelik ürününün oluşturulması

Ürün aboneliği için ödeme bağlantısı almak amacıyla Hesaplayıcı’da şu fonksiyonu belirtiriz

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 kod örneği

Bir blokta bağlantı almak için birden fazla işlev varsa ve hata oluşursa, hata değeri değişkende kaydedilir error_payment_func

Hata, en son Hesaplayıcıdaki işlev tarafından kaydedilir

Abonelik durumu nasıl yönetilir

Yöntem yalnızca gerçek aboneliklerde çalışır, demo modunda kartla bağlantı yoktur

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

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

Şu 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 telefonu switcher = 0 aboneliği durdurur, 1 gönderilirse abonelik tekrar etkinleşir. profile_id - Prodamus sistemindeki profil ID’si

Dikkat edelim!

Eğer profil ID’si gelirse, değer profile_id değişkenine kaydedilir.

Aboneliği iptal etmek için profile_id, customer_phone veya customer_email yerine delete_subscription_prodamus işlevine gönderilebilir.

Abonelik bloğu ayar örneği:

İşlevin status döndürdüğüne dikkat edin; bunu kaydedip istediğiniz gibi 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ği durdurur, 1 gönderilirse abonelik tekrar etkinleşir.

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

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

profile_id - Prodamus 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', '', '[email protected]')

İşlev başarılı olursa ok, hata varsa hata açıklamasını döndürür

Abonelikte indirimleri yönetme

İşlev, sonraki abonelik ödemeleri için indirim tutarını belirler. İndirim sınırlı veya sınırsız sayıda çekim için ayarlanabilir.

prodamus_subscription_discount(subscription_id, discount, customer_phone, num, profile_id) burada: subscription_id - abonelik ID’si discount - iki ondalık basamağa kadar hassasiyetle ondalık sayı nokta, değer sıfırdan büyük olmalı ve aboneliğin temel fiyatını aşmamalıdır customer_phone - müşterinin telefon numarası, şu formatta: [phone] (customer_email değişkeni varsa isteğe bağlı parametre, ilk ödeme sonrası yukarıdaki açıklamada görünür) num - indirimin geçerli olacağı ödeme sayısı (isteğe bağlı parametre; gönderilmezse indirimli ödeme sayısı sınırsızdır)

profile_id - Prodamus sistemindeki profil ID’si İstek başarıyla tamamlanırsa işlev 'ok' döndürür; istek hatayla çalışırsa işlev hata açıklamasını döndürür.

İndirim tutarı ve aralık SADECE işlev yeni değerlerle tekrar çağrılırsa üzerine yazılır!

Örnekler:

1. Tüm sonraki otomatik ödemeler için 1 ruble tutarında indirim tanımlama (telefon numarası belirtilmez, çünkü otomatik olarak customer_phone değişkeninden alınacaktır; indirimli tahsilat sayısı varsayılan olarak abonelik süresinin tamamı için geçerlidir)

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

Örnek 1

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

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

Örnek 2

3. Ondalık kısmı yüzdeye kadar olan bir sayı biçiminde indirim tanımlama örneği (ayırıcı nokta), sayısal veriler tırnaksız belirtilir, telefon numarası değişken üzerinden iletilir

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

Örnek 3

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

Bu yöntemle aboneliğe ait bir sonraki ödeme tarihi ileri alınabilir. Tarih yalnızca mevcut belirlenmiş sonraki ödeme tarihine göre "geleceğe" kaydırılabilir. Böylece kulüpte kalış süresi uzatılır.

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

Bunun için şu işlevi kullanmanız gerekir:

prodamus_subscription_payment_date(subscription_id, date, customer_phone, profile_id)

burada:

subscription_id - abonelik ID'si date - gg.aa.yyyy ss:dd biçiminde tarih veya gg.aa.yyyy, bu durumda saat 00:00 olur customer_phone - zorunlu değildir; gönderilmezse customer_phone değişkeninden alınır, orada da bulunmazsa çalışmaz profile_id - Prodamus sistemindeki profil ID’si

Parametreler Prodamus'a nasıl iletilir

Prodamus'a ihtiyaç duyduğunuz parametreleri (örneğin, abonelik başlangıç tarihi, taksitli ödeme kapatma vb.) iletmek için, değişken adının başına prodamus_ ekleyin

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

Ödeme nasıl test edilir

Sadece ödemeyi test ediyoruz!

Entegrasyon 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 kartlarını kullanabilirsiniz

Sberbank test kartları:

MIR 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ından yapılan ödemelerde, yapılandırılmış tüm huniler ve entegrasyonlar normal ödemede olduğu gibi çalışacaktır !

Form test edildi

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