Robokassa Nasıl Yapılandırılır

Bir bot aracılığıyla Robokassa hizmeti üzerinden ödeme almayı inceleyelim.

  1. Robokassa hesabınızda bir çevrimiçi mağaza oluşturun ve aşağıdaki teknik ayarları belirtin:

Test şifreleri oluşturun ve ilk kurulumu test modunda gerçekleştirin.

Robokassa'yı MaviBot'a Bağlama

Ödeme Alma bölümüne gidin ve Robokassa kartında Bağlan'a tıklayın:

Açılan penceredeki formu doldurun:

  1. Mağaza Kimliği — Robokassa hesabınızdaki mağaza ayarlarında bulabileceğiniz Mağaza Kimliği.
  2. Şifre #1 ve Şifre #2 — benzersiz, oluşturulmuş harf ve rakam dizileri.
  3. KDV oranı — KDV değerini iletmek için uygun kodu belirtin. Bu alan, yazarkasadaki vergi oranını ayarlar. Her ürün türü için ayrı ayrı belirlenir, ancak belirli bir ürünün tüm birimleri için geçerlidir.

Mevcut değerler:

  • KDV yok.
  • %0 KDV.
  • %5 KDV.
  • %12 olarak hesaplanan KDV.
  • %16 olarak hesaplanan KDV.

Ödeme Bağlantısı Nasıl Oluşturulur

Bir blokta AŞAĞIDAKİ YÖNTEMLERDEN BİRİNİ kullanarak bir ödeme bağlantısı oluşturabilirsiniz:

Ödeme Düğmesi

Ödeme işlevine sahip bir düğme kullanarak bir ödeme bağlantısı oluşturabilirsiniz.

Ödeme işlevine sahip bir düğmenin nasıl oluşturulacağını buradan öğrenin.

Mevcut tüm düğme parametrelerini inceleyelim.

Gerekli Ödeme Düğmesi Parametreleri

Bir ödeme bağlantısı oluşturmak için düğme ayarlarında aşağıdaki gerekli parametreleri belirtin:

  • Tutar
  • Ürün adı

Tutar — ürün fiyatını ruble cinsinden belirtin.

Ürün adı — bu alan yalnızca İngilizce veya Rusça harfler, sayılar ve noktalama işaretleri içerebilir. Maksimum uzunluk 100 karakterdir. Bu bilgi, Robokassa arayüzünde ve başarılı ödemeden sonra müşterinin aldığı elektronik makbuzda görüntülenir.

Ürün adında ÇİFT TIRNAK İŞARETİ KULLANMAYIN. Bunları kaldırın veya tek tırnak işaretleriyle değiştirin.

Otomatik ödeme onay kutusu — yinelenen ödemeleri etkinleştirir.

Tıklama bildirimi onay kutusu — ödeme bağlantısına tıklamaların izlenmesini etkinleştirir. Etkinleştirilirse, MaviBot'taki müşteri konuşmasında tıklama hakkında bir bildirim görünecektir.

Bu bildirime dayanarak daha fazla bot mantığı yapılandırabilirsiniz.

Birçok ödeme sistemi, 54-FZ sayılı Federal Yasa kapsamında gerekli olan bulut tabanlı çevrimiçi yazarkasaları destekler.

Vergi makamlarıyla sorun yaşamamak için seçtiğiniz ödeme sağlayıcısının web sitesindeki makbuz gereksinimlerini inceleyin.

Makbuz Verileri

Makbuz parametrelerini görüntülemek için Makbuz verileri menüsünü açın:

Ürün adı — makbuz oluşturmak için gereklidir.

Ürün adında ÇİFT TIRNAK İŞARETİ KULLANMAYIN. Bunları kaldırın veya tek tırnak işaretleriyle değiştirin.

Ruble cinsinden toplam tutar — ürün miktarına göre toplam ödeme tutarını belirtin. Miktar 1 ise, ruble cinsinden toplam tutar, gerekli Tutar alanına girilen değere eşittir.

Miktar — ürünün miktarı veya ağırlığı. Nokta kullanarak bir tam sayı veya ondalık sayı iletebilirsiniz, örneğin:

5

veya

10.3

Ödeme Düğmesi Kullanıldığında Otomatik Oluşturulan Müşteri Değişkenleri

Kullanıcı, Ödeme düğmesi içeren bir blok alır almaz, aşağıdaki müşteri değişkenleri otomatik olarak oluşturulur:

Hizmet müşteri değişkeni:

__payments

ödeme tutarını ve oluşturulan ödeme bağlantısının tanımlayıcısını saklar. Ödeme sağlayıcısından alınan webhook'u tanımlamak için gereklidir.

__payments hizmet değişkeni SİLİNMEMELİ veya DEĞİŞTİRİLMEMELİDİR.

Müşteri değişkeni:

error_payment_button

ödeme düğmesi oluşturulurken bir hata oluşursa oluşturulur.

error_payment_button değeri, hata metnini veya ödeme sağlayıcısı tarafından döndürülen hata yanıtını içerecektir.

Değişken değerleri, kullanıcı bir sonraki bloğa geçtikten sonra güncel hale gelir.

Sonuç Nasıl İşlenir

Lütfen dikkat edin

Robokassa, yalnızca başarılı işlemler için Sonuç URL'si aracılığıyla bildirim gönderir.

Robokassa, başarısız ödemeler için geri arama sağlamaz.

Başarısızlık URL'si, yalnızca ödeme sayfasında bir hata oluşursa ödeyenin yönlendirildiği başarısız ödeme sayfasıdır.

Başarılı Ödeme

Ödemeyi doğru yapılandırdıktan ve ödeme bağlantısını oluşturduktan sonra kurulumu test edin.

Ödeme başarılı olursa, Müşteriler bölümündeki müşteri konuşmasına OTOMATİK OLARAK bir geri arama gönderilecektir.

Geri arama şunlardan oluşur:

  • Ödeme sağlayıcısının gizli anahtarının 10 karakteri;
  • _success kelimesi;
  • bir boşluktan sonra ödeme tutarı.

Geri arama otomatik olarak oluşturulur. Bunu kendiniz oluşturmanız veya ödeme sağlayıcısının destek ekibinden talep etmeniz gerekmez.

Örnek:

ovg58keefc_success 2999

Burada:

  • ovg58keefc — ödeme sağlayıcısının gizli anahtarının 10 karakteri;
  • _success — başarılı bir ödemeyi belirten istek işleme sonucu;
  • 2999 — ödeme tutarı.

Blok yürütme:

Geri arama:

Ödeme sağlayıcısı geri aramaları kullanıcı tarafından GÖRÜLMEZ.

Bunlar yalnızca Müşteriler bölümünde görüntülenir ve operatör veya yönetici tarafından görülebilir.

Geri Arama Yanıtı Yapılandırma Örneği

Bir Başlangıç koşulu bloğu veya Koşullu durum dışı bloğu gibi bir koşullu blokta, ödemeden sonra alınan geri aramayı belirtin.

Eşleştirme türü olarak Tam eşleşme veya Anahtar kelimeler içerir seçeneğini belirleyin.

Ödemeden sonra müşteri, geri aramaya yanıt verecek şekilde yapılandırılmış bloktan mesajı alacaktır:

Ödeme Tutarı Hatası

Düğme ayarlarında belirtilen tutar, müşteri tarafından ödenen tutardan farklıysa, bot otomatik olarak aşağıdakilerden oluşan bir geri arama alacaktır:

  • Ödeme sağlayıcısının gizli anahtarının 10 karakteri;
  • _different_amounts;
  • bir boşluktan sonra benzersiz ödeme kimliği.

Örnek:

ovg58keefc_different_amounts 123456

Burada:

  • ovg58keefc — ödeme sağlayıcısının gizli anahtarının 10 karakteri;
  • _different_amounts — ödenen tutarın ödeme bağlantısındaki tutardan farklı olduğunu belirtir;
  • 123456 — benzersiz ödeme kimliği.

Hesap Makinesindeki get_robokassa_payment_url İşlevi

Blok Hesap Makinesi'ndeki get_robokassa_payment_url işlevini kullanarak bir ödeme bağlantısı oluşturabilirsiniz.

Hesap Makinesi alanında, get_robokassa_payment_url işlevinin sonucunu bir değişkene atayın.

Değişken adını kendiniz seçebilirsiniz. Ekran görüntüleri örnek değişken adlarını gösterir.

Ödeme bağlantısı bu değişkende kaydedilecektir.

Değişkeni bir mesajda bağlantı olarak görüntüleyebilir veya Öde gibi metin içeren bir düğmeye yerleştirebilirsiniz.

Örnek ödeme bağlantısı:

https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=test_salebot&OutSum=800&InvId=1412&IsTest=1&SignatureValue=0427369c3bd068bae30935f896060dda

Birçok ödeme sistemi, 54-FZ sayılı Federal Yasa kapsamında gerekli olan bulut tabanlı çevrimiçi yazarkasaları destekler.

Vergi makamlarıyla sorun yaşamamak için seçtiğiniz ödeme sağlayıcısının web sitesindeki makbuz gereksinimlerini inceleyin.

Hesap Makinesi

Örnek 1:

Parametre Açıklaması

get_robokassa_payment_url(amount, description, products_for_receipt, recurrent, currency)

İşlev Parametreleri

Parametre Açıklama
amount Ödeme tutarı. Ürün fiyatını ruble cinsinden belirtin. Gerekli parametre.
description Ürün adı. Bu alan yalnızca İngilizce veya Rusça harfler, sayılar ve noktalama işaretleri içerebilir. Maksimum uzunluk 100 karakterdir. Bu bilgi, Robokassa arayüzünde ve başarılı ödemeden sonra müşterinin aldığı elektronik makbuzda görüntülenir. Gerekli parametre.
products_for_receipt Makbuz oluşturma parametreleri. Daha fazlasını burada okuyun.
recurrent Yinelenen ödemeleri etkinleştirir. Yinelenen ödemeler etkinse 1 veya devre dışıysa None iletin.
currency Üç harfli para birimi kodu. Değer, Robokassa tarafından kabul edilen parametrelerle tam olarak eşleşmelidir.

USD — ABD doları;
EUR — euro;
KZT — tenge.

Kod Örnekleri

Örnek 1: Makbuzsuz Ödeme Bağlantısı

res = get_robokassa_payment_url(100, 'Beni satın al')

Örnek 2: Makbuzlu Ödeme Bağlantısı

receipt = [{"name":"DDDDDDDD","amount":"44","quantity":"1","vat_code":"5","method":"full_payment","object":"commodity"}]

res = get_robokassa_payment_url(100, 'Beni satın al', receipt, '3', 1, 1)

Değişkeni bir mesajda bağlantı olarak görüntüleyebilir veya Satın al gibi metin içeren bir düğmeye yerleştirebilirsiniz.

Blok birkaç ödeme bağlantısı işlevi içeriyorsa ve bir hata oluşursa, hata değeri değişkende kaydedilecektir:

error_payment_func

Hesap Makinesi'ndeki son işlevden gelen hata kaydedilecektir.

Ödemeyi doğru yapılandırdıktan ve ödeme bağlantısını oluşturduktan sonra kurulumu test edin.

Ödeme Açıklaması Nasıl Eklenir

Değişkeni ayarlayarak bir ödeme açıklaması ekleyebilirsiniz:

payment_description

Açıklama, ödeme formunda ve makbuzda görüntülenecektir.

Sonuç Nasıl İşlenir

Ödeme başarılı olursa, Müşteriler bölümündeki müşteri konuşmasına OTOMATİK OLARAK bir geri arama gönderilecektir.

Geri arama şunlardan oluşur:

  • Ödeme sağlayıcısının gizli anahtarının 10 karakteri;
  • _success;
  • bir boşluktan sonra ödeme tutarı.

Geri arama otomatik olarak oluşturulur. Bunu kendiniz oluşturmanız veya ödeme sağlayıcısının destek ekibinden talep etmeniz gerekmez.

Örnek:

ovg58keefc_success 1500

Burada:

  • ovg58keefc — ödeme sağlayıcısının gizli anahtarının 10 karakteri;
  • _success — başarılı bir ödemeyi belirten istek işleme sonucu;
  • 1500 — ödeme tutarı.

Lütfen dikkat edin

Geri arama, müşteri konuşmasında yalnızca sizin tarafınızdan görülebilir.

Geri arama müşteri tarafından görülmez, ancak başarılı bir ödemeye yanıt yapılandırabilirsiniz.

Örnek

get_robokassa_payment_url işlevini kullanan bir bloğun ayarları:

1. Bağlantının Mesaj Metninde Görüntülenmesi

Önemli

Ödeme bağlantısı benzersizdir. Kopyalamamalı ve diğer müşterilere göndermemelisiniz.

Ödeme bağlantısını bottaki bir değişken aracılığıyla gönderin.

Başarılı ödemeden sonra geri arama:

2. Bağlantının Bir Düğmede Görüntülenmesi

Blok yürütme:

Başarılı ödemeden sonra geri arama: