Prodamus'a Bağlanma

Prodamus'a bağlanmak için ödeme formu URL'sine ve gizli bir anahtara ihtiyacınız vardır.

Ödeme formu URL'si kayıt sonrasında sağlanır. Örnek:

demo.payform.ru

Gizli anahtarı Prodamus hesabınızdan alabilirsiniz. Ayrıca ödeme bildirimlerinin gönderileceği URL'yi de belirtmeniz gerekir.

Bunun nasıl yapılandırılacağına dair ayrıntılı talimatlar

Bildirim URL'si:
https://chatter.mavibot.ai/prodamus_callback/result

Bu URL, ayarlarda iki yerde belirtilmelidir.

Ana ayarlar sayfasında ödeme formu çalışma modunu seçebilirsiniz:

  • Gerçek ödemeler olmadan demo modu
  • Ödeme kabul etmek için canlı mod

Bildirim URL'si, ödeme sistemi ayarlarının iki bölümünde belirtilmelidir:

  • Tek seferlik ödemeler için Form Ayarları sekmesinde
  • Abonelik ödemeleri için Abonelikler sekmesinde

Bildirim URL'si:
https://chatter.mavibot.ai/prodamus_callback/result

Abonelik ödemelerini yapılandırmak için Abonelikler sekmesini açın ve bildirim URL'sini girin:

https://chatter.mavibot.ai/prodamus_callback/result

Önemli: URL'yi girdikten sonra Kaydet'e tıkladığınızdan emin olun.

Mavibot'ta Prodamus'a bağlanmak için Acquiring bölümünü açın.

Ardından ilgili alanlara ödeme formu URL'sini ve gizli anahtarı girin.

Önemli: Ödeme formu URL'sini girerken https:// eklemeyin.

Bağlantı artık tamamlandı. Şimdi bu işlevselliğin nasıl kullanılacağına bakalım.

Ödeme Bağlantısı Oluşturma

Ödeme Butonu

Ödeme işlevine sahip bir buton kullanılarak bir ödeme bağlantısı oluşturulabilir.

Ödeme butonu oluşturma kılavuzuna bakın:
/docs/chatbot-builder-buttons-payment-button

Aşağıdaki bölümlerde mevcut tüm buton ayarları açıklanmaktadır.

Gerekli Parametreler

Bir ödeme bağlantısı oluşturmak için aşağıdaki alanlar gereklidir:

  • Tutar
  • Ürün Adı
  • Fiş için Ürünler (yalnızca kendi çevrimiçi yazar kasanız yoksa ve Prodamus'un mali fiş oluşturmasını istiyorsanız gereklidir)

Müşteri ödeme sayfasını açtığında ürün bilgisi ve fiyat zaten doldurulmuştur. Müşterinin yalnızca iletişim bilgilerini girmesi gerekir.

Müşterinin e-posta adresi ve/veya telefon numarası buton ayarlarında belirtilmişse, ödeme sayfasında da önceden doldurulacaktır.

Buton Ayarları

Metin – Ödeme butonunda görüntülenen metin.

İşlev – Bir ödeme bağlantısı oluşturmak için Ödeme'yi seçin.

Ödeme Sistemi – Projeye bağlı ödeme sistemlerini görüntüler.

Herhangi bir ödeme sistemi bağlı değilse, bu buton türü kullanılamaz.

Ürün Adı (gerekli) – Tam ürün adını belirtin.

Örneğin, şunun yerine:

Telefon

şunu kullanın:

Xiaomi Akıllı Telefon, Model ...

Not: Ürün adında çift tırnak işaretine (") izin verilmez. Bunları kaldırın veya tek tırnak işaretiyle değiştirin.

Tutar (gerekli) – Ödeme tutarı.

Ek Parametreler

İsteğe bağlı alanları yapılandırmak için Ek Bilgiler'e tıklayın:

  • Sipariş açıklaması
  • İndirim (RUB)
  • Müşteri e-posta değişkeni
  • Müşteri telefon değişkeni
  • Bağlantı son kullanma tarihi
  • Abonelik ürün kimliği
  • Fiş için ürünler

Tıklamada Bildir – Müşteri ödeme butonuna tıkladığında müşteri sohbetinde bir bildirim almak istiyorsanız bu seçeneği etkinleştirin.

Bu bildirim, ek sohbet robotu mantığı oluşturmak için kullanılabilir.

Birçok ödeme sağlayıcısı, vergi uyumu için gereken bulut yazar kasaları destekler. Fiş oluşturma ve maliyetlendirme hakkında bilgi için ödeme sağlayıcınızın belgelerine bakın.

Buton tarafından açılan ödeme sayfası şöyle görünür:

Ek Ödeme Bağlantısı Ayarları

Sipariş Açıklaması – Bu alana girilen metin, ödeme sayfasında Ek Bilgiler bölümünde görüntülenir.

İndirim – İndirim tutarını RUB cinsinden belirtin. Ayırıcı olarak nokta kullanılarak ondalık değerler desteklenir (örneğin, 50.99).

Ödeme sayfasında indirim otomatik olarak uygulanır. Orijinal fiyatın üzeri çizilir ve indirimli tutar toplam ödeme olarak görüntülenir.

Müşteri E-posta Değişkeni (telefon numarası sağlanmışsa isteğe bağlı) – Müşterinin e-posta adresi veya bunu içeren bir değişken, örneğin:

#{email}

Müşteri Telefon Değişkeni (e-posta adresi sağlanmışsa isteğe bağlı) – Müşterinin telefon numarasını şu formatta içeren bir değişken:

79000000000

Örneğin:

#{phone}

Bir e-posta adresi veya telefon numarası sağlanmalıdır.

Bağlantı Son Kullanma Tarihi – Son kullanma tarihini şu formatta belirtin:

dd.MM.yyyy HH:mm

Örnek:

25.01.2021 11:00

Ayrıca bir değişken de kullanabilirsiniz, örneğin:

#{link_expired}

Abonelik Ürün Kimliği – Yinelenen bir ödeme oluşturmak için abonelik ürün kimliğini girin.

Abonelik ürünleri oluşturma hakkında bilgi için Prodamus belgelerine bakın.

Bir abonelik ürün kimliği belirtilmişse:

  • ödeme tutarı yok sayılır;
  • ürün bilgisi Prodamus'taki abonelik ürününden yüklenir;
  • abonelik yönetimi için müşterinin telefon numarası gereklidir;
  • başarılı bir ödemeden sonra geri arama, abonelik ürün kimliğini içerir.

Fiş için Ürünler (koşullu olarak gerekli) – Kendi çevrimiçi yazar kasanızı kullanmıyorsanız, Prodamus aracılığıyla ödeme maliyetlendirmesi için gereklidir.

Ürün açıklamasını, fiyatını ve satın alınan içeriğe bir bağlantı belirtin.

Örnek:

"İleri Düzey Fotoğrafçılık" Kursu, fiyat 3000 RUB,
https://example.com/course

Bağlantı Son Kullanma Davranışı

Bir bağlantı son kullanma tarihi belirtirseniz, ödeme butonu bağlantının hala geçerli olup olmamasına bağlı olarak farklı davranır.

Süresi Dolmuş Bağlantı

Müşteri, süresi dolduktan sonra ödeme bağlantısını açarsa, ödeme tamamlanamaz ve aşağıdaki mesajı görürler:

Not: Son kullanma tarihi geçerli tarihten daha sonra olmalıdır. Aksi takdirde, müşteri ödemeyi tamamlayamaz.

Etkin Olmayan Ödeme Butonu

Müşteri, bağlantının süresi dolduktan sonra ödeme butonunu talep ederse, buton görüntülenmez.

Bunun yerine, aşağıdaki müşteri değişkeni oluşturulur:

error_payment_button

Değer:

Hata: Bağlantı son kullanma tarihi geçerli tarihten daha sonra olmalıdır.

Bu durumu sohbet robotu akışınızda ele almanızı öneririz.

Şunu kontrol eden bir koşul oluşturun:

error_payment_button == "Hata: Bağlantı son kullanma tarihi geçerli tarihten daha sonra olmalıdır."

Koşul karşılanırsa, şöyle bir mesaj gönderin:

Üzgünüz, ödemeyi zamanında tamamlayamadınız. Ödeme bağlantısının süresi doldu.

Ödeme Butonu Tarafından Oluşturulan Müşteri Değişkenleri

Bir müşteri Ödeme butonu içeren bir mesaj aldığında, Mavibot otomatik olarak aşağıdaki değişkenleri oluşturur.

__payments

Ödeme tutarını ve oluşturulan ödeme bağlantısı tanımlayıcısını depolayan bir sistem değişkeni. Ödeme sisteminden alınan geri aramaları eşleştirmek için kullanılır.

Önemli: __payments sistem değişkenini değiştirmeyin veya silmeyin.

error_payment_button

Bu değişken, ödeme butonu oluşturulurken bir hata oluşursa otomatik olarak oluşturulur.

Mavibot tarafından oluşturulan hata mesajını veya ödeme sistemi tarafından döndürülen hatayı içerir.

Değişken değerleri, sohbet robotu bir sonraki bloğa geçtikten sonra kullanılabilir hale gelir.

Ödeme Sonuçlarını İşleme

Başarılı Ödeme

Başarılı bir ödemeden sonra, Mavibot otomatik olarak aşağıdaki geri aramayı alır:

<gizli_anahtarın_ilk_10_karakteri>_success <ödeme_tutarı>

Örnek:

ovg58keefc_success 44

Burada:

  • ovg58keefc — Prodamus gizli anahtarının ilk 10 karakteri.
  • _success — başarılı bir ödemeyi belirtir.
  • 44 — ödeme tutarı.

Müşteriler ödeme geri aramalarını asla görmez. Bunlar yalnızca Müşteriler bölümünde görünür ve sohbet robotu mantığı oluşturmak için kullanılabilir.

Örnek

Adım 1

Ödeme butonunu içeren bir blok oluşturun.

Adım 2

Bir Tetikleyici bloğu oluşturun veya sonraki bloğa giden bir ok yapılandırın.

Ödeme geri aramasını tetikleyiciye veya eşleştirme koşuluna yapıştırın.

Sohbet robotunuz genel ödeme işleme gerektiriyorsa, aynı geri arama Başlangıç Koşulu bloğunda da yapılandırılabilir.

Önemli: Eşleştirme türü olarak Tam eşleşme veya Anahtar kelimeler içerir kullanın.

Not: Geri aramaları belirli bir okta işliyorsanız, geri arama geldiğinde müşterinin hala o oku içeren blokta olduğundan emin olun. Aksi takdirde, geçiş gerçekleşmez. Müşterilerin bloklar arasında hareket edebildiği sohbet robotu akışları için, geri aramaları bunun yerine Başlangıç Koşulu bloğunda işlemeniz önerilir.

Başarılı Abonelik Ödemesi

Abonelik ürünleri için geri arama formatı:

<gizli_anahtarın_ilk_10_karakteri>_success <abonelik_ürün_kimliği>

Örnek:

214009eefc_success 618117

Burada:

  • 214009eefc — gizli anahtarın ilk 10 karakteri.
  • _success — başarılı ödeme.
  • 618117 — abonelik ürün kimliği.

Başarısız Ödeme

Ödeme başarısız olursa, Mavibot aşağıdaki geri aramayı alır:

<gizli_anahtarın_ilk_10_karakteri>_fail <ödeme_tutarı>

Örnek:

ovg58keefc_fail 44

Burada:

  • ovg58keefc — gizli anahtarın ilk 10 karakteri.
  • _fail — ödeme başarısız oldu.
  • 44 — ödeme tutarı.

Not: Tüm ödeme sağlayıcıları başarısız ödemeler için geri arama göndermez.

Ödeme Tutarı Uyuşmazlığı

Ödenen tutar, ödeme butonunda belirtilen tutardan farklıysa, Mavibot aşağıdaki geri aramayı alır:

<gizli_anahtarın_ilk_10_karakteri>_different_amounts <ödeme_kimliği>

Örnek:

ovg58keefc_different_amounts 123456

Burada:

  • ovg58keefc — gizli anahtarın ilk 10 karakteri.
  • _different_amounts — ödenen tutarın beklenen tutardan farklı olduğunu belirtir.
  • 123456 — benzersiz ödeme kimliği.

get_prodamus_payment_url Hesap Makinesi İşlevi

Hesap Makinesi bloğunda get_prodamus_payment_url işlevini kullanarak bir ödeme bağlantısı oluşturabilirsiniz.

İşlev sonucunu herhangi bir değişkene atayın.

Herhangi bir değişken adı seçebilirsiniz. Aşağıdaki ekran görüntüleri örnek değişken adlarını kullanır.

Oluşturulan ödeme bağlantısı değişkende saklanır ve bir mesajda kullanılabilir veya bir butona eklenebilir.

Ödeme bağlantısı örneği:

https://payform.ru/7p3JR8/

Örnek

Fonksiyon Sözdizimi

your_variable = get_prodamus_payment_url(
    amount,
    product_name,
    expired,
    customer_phone,
    customer_email,
    discount,
    description,
    extra_params,
    products_for_receipt
)

Parametreler

Parametre Açıklama
amount Zorunlu. Ödeme tutarı. Tam sayı veya ondalık değer kabul eder (örneğin, 25 veya 52.5).
product_name Zorunlu. Ürün adı.
expired Ödeme bağlantısının son kullanma tarihi. Desteklenen biçimler: dd.MM.yyyy veya dd.MM.yyyy HH:mm. Ayrıca current_date + 2 gibi değişkenler veya ifadeler de kullanabilirsiniz. Bu parametreyi atlamak için '', "" veya None değerini girin.
customer_phone Müşteri telefon numarası. customer_email sağlanmışsa isteğe bağlıdır. Atlamak için '' veya "" girin.
customer_email Müşteri e-posta adresi. customer_phone sağlanmışsa isteğe bağlıdır. Atlamak için '' veya "" girin.
discount İndirim tutarı. Tam sayı veya ondalık değer kabul eder (örneğin, 25 veya 63.5). Atlamak için '' veya "" girin.
description Ürün açıklaması. Atlanırsa, Prodamus otomatik olarak Payment for order order_id kullanır. Atlamak için '' veya "" girin.
extra_params Fonksiyon argümanlarına dahil olmayan ek Prodamus API parametreleri. Atlamak için '', "" veya None girin.
products_for_receipt "ürün açıklaması - fiyat - satın alınan içerik URL'si" biçiminde makbuz verileri. Kendi çevrimiçi yazar kasanız olmadan Prodamus fiskalizasyonu kullanıyorsanız zorunludur.

Son Kullanma Tarihi Örnekleri

İki gün sonra sona erer:

expired = current_date + 2

30 dakika içinde sona erer:

time = current_time + 30
expired = "#{current_date} #{time}"

extra_params Örneği

extra_params = {
    "payments_limit": "3",
    "payment_method": "vsegdada_installment_0_0_6"
}

Desteklenen parametrelerin tam listesi için Prodamus REST API belgelerine bakın.

Örnek

extra_params = {
    "payments_limit": "3"
}

products_for_receipt = "Photography Course, price 4999 RUB, https://example.com/course"

payment_link = get_prodamus_payment_url(4999, "Photography Course", "27.03.2023 17:00", "79167777771", "[email protected]", 20, "The best photography course", extra_params, products_for_receipt)

Bu örnekte:

  • extra_params ek ödeme parametrelerini içerir.
  • products_for_receipt mali makbuz bilgilerini içerir.
  • payment_link oluşturulan ödeme URL'sini saklar.

Aynı Hesap Makinesi bloğunda birden fazla ödeme bağlantısı işlevi kullanılırsa ve bunlardan biri başarısız olursa, hata error_payment_func değişkenine yazılır. Yalnızca son işlev hatası saklanır.

payment_sum Kullanarak Ödeme Bağlantısı Oluşturma

Not: payment_sum değeri, payment_description, product_name ve diğerleri gibi tüm isteğe bağlı değişkenlerden sonra uygulanır.

get_prodamus_payment_url() işlevini çağırmak yerine, Hesap Makinesi bloğunda payment_sum değişkenine bir değer atayarak basitçe bir ödeme bağlantısı oluşturabilirsiniz.

payment_sum atandıktan sonra, Mavibot otomatik olarak ödeme bağlantısını içeren prodamus_pay_url değişkenini oluşturur.

Örnek:

https://payform.ru/7p3JR8/

Bu değişkeni bir mesajda görüntüleyebilir veya bir düğmenin URL'si olarak kullanabilirsiniz.

İsteğe Bağlı Değişkenler

Aşağıdaki değişkenler payment_sum atanmadan önce tanımlanabilir.

Değişken Açıklama
product_name Ürün adı. Atlanırsa, varsayılan değer Payment for order order_id olur.
payment_description Ödeme sayfasında gösterilen ürün açıklaması.
discount_value İndirim tutarı. Örnek: 25 veya 50.25.
customer_phone Müşteri telefon numarası.
customer_email Müşteri e-posta adresi.
link_expired Ödeme bağlantısının son kullanma tarihi.
currency Ödeme para birimi. Desteklenen değerler: rub, usd, eur, kzt. Küçük harf olmalıdır.
payment_title Ödeme başlığı (en fazla 127 karakter). Varsayılan olarak Payment payment_id şeklindedir.
locale Ödeme sayfası dili (örneğin, ru-RU, en-US, fr-FR).
products_for_receipt Makbuz bilgileri. Kendi çevrimiçi yazar kasanız olmadan Prodamus fiskalizasyonu kullanıyorsanız zorunludur.
payment_sum Zorunlu. Ödeme tutarı.

Bağlantı Son Kullanma Süresi

Son kullanma tarihini birkaç şekilde belirtebilirsiniz.

Belirli bir tarih:

25.01.2021

Belirli bir tarih ve saat:

25.01.2021 12:23

Değişkenleri kullanma:

time = current_time + 30
link_expired = "#{current_date} #{time}"

Veya:

link_expired = current_date + 2

Örnek

Öncelikle ödeme tutarını belirleyin.

Ardından, ödeme bağlantısını göndermeniz gereken her yerde oluşturulan prodamus_pay_url değişkenini kullanın.

Kullanılabilir Ödeme Yöntemleri

prodamus_available_payment_methods değişkeni payment_sum'dan önce tanımlanmalıdır.

Desteklenen değerler şunları içerir:

Değer Açıklama
AC Rus banka kartları
ACkz Kazakistan banka kartları
ACf BDT banka kartları (Rusya hariç)
ACEURNMBX EUR kartları (Rusya ve Beyaz Rusya hariç)
SBP Hızlı Ödeme Sistemi (Rusya)
QW QIWI Cüzdanı
PC YooMoney
GP Ödeme terminali
sbol Sberbank Online
invoice Fatura ödemesi
installment Prodamus taksitleri
credit T-Bank kredisi
monetaworld Uluslararası kartlar (Rusya hariç)

Birden çok ödeme yöntemi, dikey çubuk (|) ile ayrılarak belirtilebilir.

Örnek:

prodamus_available_payment_methods = "AC|PC|QW"

Para Birimi

Ödeme para birimini prodamus_currency değişkenini kullanarak belirtebilirsiniz.

Desteklenen değerler:

  • kzt
  • usd
  • eur

Oluşturulan ödeme sayfası, tutarı seçilen para biriminde görüntüleyecektir.

payment_callback geri aramasını işlerken aşağıdaki alanlara dikkat edin:

  • currency
  • currency_sum

Bunlar, ödeme para birimini ve ödenen tutarı içerir.

Hiçbir ödeme yöntemi belirtilmezse, ödeme sayfası kullanılabilir ödeme yöntemlerini göstermez. Öncelikle Prodamus hesabınızda gerekli ödeme yöntemlerini etkinleştirin.

Ödeme Sonuçlarını İşleme

Ödeme Geri Aramaları

Başarılı veya başarısız bir ödemeden sonra Mavibot, ödeme durumunu belirlemek için kullanılabilecek geri aramalar alır.

Geri aramalar, konuşmada sistem mesajları olarak görünür. Müşteriler bu mesajları asla görmez veya göndermez.

Örnekler:

Başarılı ödeme:

453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_success

Başarısız ödeme:

453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_fail

Başarılı bir ödemeden sonra, aşağıdaki müşteri değişkeni otomatik olarak oluşturulur:

prodamus_payment_completed = True

Not: Geri aramalar hafif bir gecikmeyle alınır. Ödeme bağlantısını gönderdikten sonra, müşteriye ödeme onayının birkaç dakika sürebileceğini bildirmeniz önerilir.

Örnek mesaj:

Ödemeyi tamamladıktan sonra, lütfen ödeme onayını bekleyin.

Geri Arama Biçimi

Ödeme düğmesi veya get_prodamus_payment_url() işlevi tarafından oluşturulan ödeme bağlantıları, başarılı bir ödemeden sonra aşağıdaki geri aramayı döndürür:

<secret_key>_success

Örnek:

ovg58keefc_success

Burada:

  • <secret_key> Prodamus gizli anahtarınızdır.
  • _success başarılı bir ödemeyi belirtir.

Örnek

Geri aramayı bekleyen ve ardından sohbet robotu akışına devam eden bir tetikleyici veya koşullu blok oluşturun.

Önemli: Eşleme türü olarak Tam eşleme kullanın.

Başarılı bir ödemeden sonra başka bir ödeme bağlantısı oluşturmak istiyorsanız, önce mevcut ödeme bilgilerini sıfırlayın.

Ayar:

payment_sum = 0

Ardından, yeni bir ödeme bağlantısı oluşturmak için payment_sum'a yeni bir değer atayın.

Abonelik Geri Aramaları

Prodamus ayrıca abonelik durumuyla ilgili geri aramalar gönderir.

Örnekler şunları içerir:

  • Müşteri tarafından iptal edilen abonelik
  • Müşteri tarafından yeniden etkinleştirilen abonelik
  • Birkaç başarısız ödeme denemesinden sonra devre dışı bırakılan abonelik

Abonelik İptal Edildi

Müşteri aboneliğini manuel olarak iptal ettiğinde gönderilir.

Mevcut ücretli fatura dönemi hala aktif kalabilir.

Bu geri aramayı şunlar için kullanabilirsiniz:

  • olayı yok saymak;
  • ekibinize bildirim göndermek;
  • müşteriye bir elde tutma mesajı göndermek.

Abonelik Yeniden Etkinleştirildi

Müşteri daha önce iptal edilmiş bir aboneliği geri yüklediğinde gönderilir.

İş mantığınıza bağlı olarak, bu geri aramayı yok sayabilir veya müşteriyi bir elde tutma iş akışından kaldırabilirsiniz.

Abonelik Devre Dışı Bırakıldı

Birkaç başarısız yinelenen ödeme denemesinden sonra gönderilir.

Geri Arama Verilerini Kaydetme

Başarılı bir ödemeden sonra, tam geri arama yükü aşağıdaki değişkende saklanır:

payment_callback

Prodamus tarafından döndürülen tüm ödeme bilgilerini içerir.

Örnek:

{
  "date": "2021-03-30T11:44:43+03:00",
  "order_id": "757679",
  "sum": "14.50",
  "customer_phone": "+77777777777",
  "customer_extra": "Product",
  "payment_status": "success"
}

Ödeme bağlantısını oluştururken product_name ve payment_description belirttiyseniz, bunları geri aramadan alabilirsiniz.

Örnek:

product = get(payment_callback, "products[0][name]")
description = get(payment_callback, "customer_extra")

Ödeme tutarını alın:

amount = get(payment_callback, "sum")

Not: payment_sum değeri her zaman payment_description ve product_name gibi isteğe bağlı değişkenlerden sonra atanır.

Kullanılabilir Geri Aramalar

Başarılı ödeme geri aramalarına ek olarak, Prodamus sohbet robotunuzu otomatikleştirmek için kullanılabilecek çeşitli sistem geri aramaları gönderir.

Abonelik Olayları

  • Müşteri tarafından iptal edilen abonelik
  • Müşteri tarafından yeniden etkinleştirilen abonelik
  • Süresi dolan abonelik

Ödeme Başarısızlık Olayları

Ödeme sağlayıcısına bağlı olarak, başarısızlık nedeniyle birlikte geri aramalar alabilirsiniz, örneğin:

  • Ödeme başarısız oldu – Yetersiz bakiye
  • Ödeme başarısız oldu – Kartın süresi doldu
  • Ödeme başarısız oldu – Kart limiti aşıldı
  • Ödeme başarısız oldu – Kart kayıp olarak bildirildi
  • Ödeme başarısız oldu – Sistem hatası
  • Ödeme başarısız oldu – İşlem, banka tarafından reddedildi
  • Ödeme başarısız oldu – İşlem, banka tarafından reddedildi

Diğer Olaylar

  • Yaklaşan yinelenen ödeme bildirimi
  • Taksit başvurusu onaylandı
  • Taksit başvurusu iptal edildi
  • Taksit başvurusu reddedildi

Bu geri aramalardan herhangi birine tepki veren sohbet robotu akışları oluşturabilirsiniz.

Örneğin, yinelenen bir ödeme başarısız olduğunda müşterilere otomatik olarak bildirim gönderebilirsiniz.

Belirli bir başarısızlık nedenini işlemek için, ilgili geri aramayla eşleşen bir tetikleyici oluşturun.

Nedeni ne olursa olsun tüm başarısız ödemeleri işlemek için, geri aramanın aşağıdakileri içerip içermediğini kontrol eden bir koşul kullanın:

Payment failed

Payment failed metnini içeren herhangi bir geri arama, yapılandırılan sohbet robotu eylemini tetikleyecektir.

Abonelik Ödemeleri

Abonelik Oluşturma

Abonelik ödemelerini kabul etmeden önce, Prodamus hesabınızda bir abonelik ürünü oluşturun.

Ayrıntılı talimatlar için Prodamus belgelerine bakın.

Abonelik ürününü oluşturduktan sonra, Abonelik Ürün Kimliği'ni kopyalayın.

Abonelik Ürün Kimliği'ni aşağıdaki değişkene atayın:

prodamus_subscription

Mavibot aşağıdaki değişkeni otomatik olarak oluşturur:

prodamus_pay_url

Oluşturulan URL bir mesajda görüntülenebilir veya bir düğmeye eklenebilir.

Örnek:

https://payform.kz/7p3JR8/

Abonelik ödemeleri, tek seferlik ödemelerle tamamen aynı şekilde işlenir.

Başarılı bir abonelik ödemesinden sonra, müşterinin telefon numarası otomatik olarak customer_phone değişkenine kaydedilir.

customer_email sağlanmazsa, abonelik yönetimi için customer_phone gereklidir.

get_prodamus_subscription_url

Ayrıca Hesap Makinesi'ni kullanarak abonelik ödeme bağlantıları da oluşturabilirsiniz.

Fonksiyon:

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

Örnek

Parametreler

Parametre Açıklama
subscription_id Gerekli. Prodamus hesabınızdaki Abonelik Ürün Kimliği.
product_name Gerekli. Ürün adı.
expired Ödeme bağlantısının son kullanma tarihi. dd.MM.yyyy veya dd.MM.yyyy HH:mm biçimlerini destekler. Değişkenler de desteklenir.
customer_phone Müşteri telefon numarası. customer_email belirtilmişse isteğe bağlıdır.
customer_email Müşteri e-posta adresi. customer_phone belirtilmişse isteğe bağlıdır.
discount İndirim tutarı.
description Ürün açıklaması.
extra_params Ek Prodamus API parametreleri.
products_for_receipt Makbuz bilgileri. Kendi online yazarkasanız olmadan Prodamus fişlemesi kullanılırken gereklidir.

Örnek

extra_params = {
    "payments_limit": "3"
}

products_for_receipt = "Fotoğrafçılık Kursu aboneliği, 2000 RUB/ay, https://example.com/course"

subscription_link = get_prodamus_subscription_url(618988, "Fotoğrafçılık Kursu", "27.03.2023 17:02", "79167777771", "[email protected]", 20, "Premium abonelik", extra_params, products_for_receipt)

Aynı Hesap Makinesi bloğunda birden fazla ödeme bağlantısı fonksiyonu yürütülürse ve bunlardan biri başarısız olursa, hata error_payment_func değişkeninde saklanır.

Abonelik Durumunu Yönetme

Abonelik yönetimi yalnızca aktif abonelikler için kullanılabilir. Demo modunda, herhangi bir ödeme kartı bağlı olmadığı için desteklenmez.

Bir aboneliği yönetmek için aşağıdaki parametrelerden en az biri mevcut olmalıdır:

  • customer_phone
  • customer_email

Bir aboneliği iptal etmek veya yeniden etkinleştirmek için aşağıdaki fonksiyonu kullanın:

delete_subscription_prodamus

Örnek parametreler:

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

Parametreler

Parametre Açıklama
url Mavibot'ta yapılandırılan ödeme formu URL'si.
secret_key Prodamus gizli anahtarınız.
id_subscription Abonelik Ürün Kimliği.
customer_phone Abonenin telefon numarası.
switcher Abonelik eylemi: 0 – devre dışı bırak, 1 – yeniden etkinleştir.
profile_id Prodamus'taki müşteri profil kimliği.

Prodamus tarafından bir profil kimliği döndürülürse, otomatik olarak profile_id değişkenine kaydedilir. Abonelikleri yönetirken bu değişkeni customer_phone veya customer_email yerine kullanabilirsiniz.

Örnek:

Fonksiyon bir durum değeri döndürür.

İşlem başarılı olursa:

status = ok

prodamus_subscription_switch_status

Ayrıca Hesap Makinesi'ni kullanarak abonelikleri yönetebilirsiniz.

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

Parametreler

Parametre Açıklama
subscription_id Abonelik Ürün Kimliği.
switcher 0 – aboneliği devre dışı bırak, 1 – aboneliği yeniden etkinleştir.
customer_phone Müşteri telefon numarası. customer_email sağlanmışsa isteğe bağlıdır.
customer_email Müşteri e-posta adresi. customer_phone sağlanmışsa isteğe bağlıdır.
profile_id Prodamus'taki müşteri profil kimliği.

Örnek 1

Müşterinin telefon numarasını kullanarak bir aboneliği devre dışı bırakın.

status = prodamus_subscription_switch_status(
    "618117",
    "0",
    "75431312321"
)

Örnek 2

Müşterinin e-posta adresini kullanarak bir aboneliği devre dışı bırakın.

status = prodamus_subscription_switch_status(
    "618117",
    "0",
    "",
    "[email protected]"
)

Fonksiyon, işlem başarılı olursa ok döndürür. Aksi takdirde bir hata mesajı döndürür.

Abonelik İndirimlerini Yönetme

Gelecekteki yinelenen ödemelere indirim uygulamak için aşağıdaki fonksiyonu kullanın.

İndirim, sınırlı sayıda ödeme için veya süresiz olarak uygulanabilir.

prodamus_subscription_discount(
    subscription_id,
    discount,
    customer_phone,
    num,
    profile_id
)

Parametreler

Parametre Açıklama
subscription_id Abonelik Kimliği.
discount İndirim tutarı. Sıfırdan büyük olmalı ve abonelik fiyatını aşmamalıdır.
customer_phone Müşteri telefon numarası. customer_phone değişkeninden alınabiliyorsa isteğe bağlıdır.
num İndirimin uygulanması gereken gelecekteki ödeme sayısı. Atlanırsa indirim kalıcıdır.
profile_id Prodamus'taki müşteri profil kimliği.

Başarılı olursa fonksiyon şunu döndürür:

ok

Aksi takdirde bir hata açıklaması döndürür.

İndirimi veya ödeme sayısını güncellemek, fonksiyonun yeni değerlerle tekrar çağrılmasını gerektirir.

Örnekler

Kalıcı indirim

Tüm gelecekteki abonelik ödemelerine 1 tutarında bir indirim uygulayın.

result = prodamus_subscription_discount(
    "624034",
    "1"
)

Sonraki üç ödeme için indirim

result = prodamus_subscription_discount(
    "624034",
    "2",
    "",
    "3"
)

Ondalık indirim

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

Bir Sonraki Abonelik Ödeme Tarihini Değiştirme

Bir sonraki yinelenen ödemeyi, planlanan tarihini değiştirerek erteleyebilirsiniz.

Yeni ödeme tarihi, mevcut planlanan ödeme tarihinden her zaman daha sonra olmalıdır.

Bu özellik, örneğin bir müşterinin abonelik süresini bir bonus olarak uzatmak için kullanılabilir.

Aşağıdaki fonksiyonu kullanın:

prodamus_subscription_payment_date(
    subscription_id,
    date,
    customer_phone,
    profile_id
)

Parametreler

Parametre Açıklama
subscription_id Abonelik Kimliği.
date dd.MM.yyyy veya dd.MM.yyyy HH:mm biçiminde yeni ödeme tarihi. Saat belirtilmezse 00:00 kullanılır.
customer_phone Müşteri telefon numarası. İsteğe bağlı. Atlanırsa değer customer_phone değişkeninden alınır.
profile_id Prodamus'taki müşteri profil kimliği.

Prodamus'a Ek Parametreler Gönderme

Bir ödeme bağlantısı oluştururken Prodamus tarafından desteklenen ek parametreler (abonelik başlangıç tarihleri veya taksit ayarları gibi) gönderebilirsiniz.

Sadece adı prodamus_ önekiyle başlayan bir değişken oluşturun.

Örnek:

prodamus_some_parameter

Bir ödeme bağlantısı oluşturulduğunda, prodamus_ önekine sahip tüm değişkenler otomatik olarak Prodamus'a gönderilen isteğe dahil edilir.

Ödemeleri Test Etme

Yalnızca ödeme süreci simüle edilir.

Entegrasyonunuzu ve sohbet robotu akışlarınızı yapılandırırken, gerçek fonları çekmemek için Prodamus test kartlarını kullanabilirsiniz.

İlk olarak, ödeme sayfanızı Demo moduna geçirin.

Modu değiştirdikten sonra Kaydet'e tıklamayı unutmayın.

Test Kartları

MIR

Alan Değer
Kart Numarası 2202 2050 0001 2424
Son Kullanma Tarihi 05/35
CVV 669

Mastercard

Alan Değer
Kart Numarası 5469 9801 0004 8525
Son Kullanma Tarihi 05/26
CVV 041
3-D Secure Kodu 111111

Visa

Alan Değer
Kart Numarası 4006 8009 0096 2514
Son Kullanma Tarihi 05/26
CVV 941
3-D Secure Kodu 111111

Önemli: Test kartları, gerçek ödemelerle aynı sohbet robotu mantığını, geri aramaları, otomasyonları ve entegrasyonları tetikler.

Test tamamlandıktan sonra, gerçek ödemeleri kabul etmeye başlamak için ödeme sayfasını Canlı moda geçirin.

Demo modu geçişi kapalı olmalıdır (kırmızı anahtar devre dışı).