Robokassa (KZ)

Robokassa nasıl yapılandırılır

Robokassa hizmeti aracılığıyla botta ödemelerin nasıl alınacağını ele alalım.

1. Robokassa hizmetinin kişisel hesabında bir çevrimiçi mağaza oluşturun ve teknik ayar verilerini belirtin:

- Hash hesaplama algoritması: MD5 - Result Url: https://chatter.mavibot.ai/robokassa_callback/result - Result Url üzerinden veri gönderme yöntemi: GET - Success Url: https://chatter.mavibot.ai/robokassa_callback/success - Success Url üzerinden veri gönderme yöntemi: GET - Fail Url: https://chatter.mavibot.ai/robokassa_callback/fail - Fail Url üzerinden veri gönderme yöntemi: GET

Test parolaları oluşturun ve ilk yapılandırmayı test modunda yapın.

Robokassa MaviBot'a nasıl bağlanır?

“Ek tahsilat” bölümüne gidin ve Robokassa plakasında “Bağlan”a tıklayın:

ve açılan pencerede formu doldurun:

1. Mağaza Kimliği alanı — Robokassa kişisel hesabındaki mağaza ayarlarında bulabileceğiniz Shop ID.

2. Şifre #1, şifre #2 — rakamlar ve harflerden oluşan benzersiz, oluşturulmuş diziler.

3. KDV Oranı alanı. KDV değerini iletmek için uygun kod belirtilmelidir. Bu alan, KKT'de 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 birlikte uygulanır.

Şu değerlerle kullanılır:

• KDV'siz.

• %0 oranında KDV.

• %5 oranında KDV

• %12 hesaplama oranında fiş KDV'si.

• %16 hesaplama oranında fiş KDV'si.

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

Blokta ödeme bağlantısı oluşturmak AŞAĞIDAKİ YÖNTEMLERDEN BİRİYLE mümkündür:

• Ödeme işlevli düğme veya

• Hesaplayıcıdaki get_robokassa_payment_url işlevi veya

• payment_sum değişkeni ve ek parametreler kullanılarak 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.

“Ödeme” işlevli düğmenin nasıl oluşturulacağını burada anlattık

Bu düğmenin tüm olası parametrelerini ele alalım. Ödeme işlevli düğmenin nasıl oluşturulacağı bu makalede anlatılmıştır:

Ödeme düğmesinin zorunlu parametreleri

Ödeme bağlantısı oluşturmak için düğme ayarlarında zorunlu parametreleri belirtmek gerekir: Tutar ve Ürün adı.

Tutar alanı. Bu alana ürünün ruble cinsinden fiyatını giriyoruz

Ürün adı alanı. Bu alanda yalnızca İngilizce veya Rus alfabesi karakterleri, rakamlar ve noktalama işaretleri kullanılabilir. 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.

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

Otomatik ödeme onay kutusu. Otomatik ödemeyi bağlamak için

tıklama bildirimi onay kutusu. Ödeme bağlantısına yönlendirmeyi izlemek için işaret koyabilirsiniz. Bu durumda, düğmeye tıklandığında müşteriyle olan diyaloğa SaleBot'a bağlantıya yönlendirme yapıldığına dair bir bildirim gelir

Bu bildirim için botun sonraki çalışma mantığı yapılandırılabilir.

Birçok ödeme sistemi bulut tabanlı çevrimiçi kasaları destekler; bunlar 54-FZ kapsamında gereklidir. Vergi dairesiyle rahatsız edici bir duruma düşmemek için seçtiğiniz ödeme sisteminin sitesinde fiş düzenleme özelliklerini okuyun.

Fiş oluşturmak için

Fiş oluşturma verileri menüsü. Tıklandığında fiş oluşturma parametrelerini içeren açılır menü açılır:

Ürün adı alanı. Fiş oluşturmak için zorunlu.

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

Ruble cinsinden tam tutar alanı. Bu alanda, ürün miktarı dikkate alınarak ödenecek tutar belirtilmelidir. Miktar 1 ise, Ruble cinsinden tam tutar, düğme ayarlarının zorunlu alanındaki Tutar alanının değerine eşittir

Miktar alanı. Ürünün miktarı veya ağırlığı. Tam sayı veya ondalık sayı nokta ile iletilebilir. Örnek: 5 veya 10.3

Ö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 şu müşteri değişkenleri otomatik olarak oluşturulur:

Şek. 9. payments değişkeni

Müşterinin hizmet değişkeni __payments , oluşturulan bağlantının tutarını ve kimliğini saklar; ödeme sisteminden gelen webhook'un tanımlanması için gereklidir.

Müşterinin hizmet değişkeni __payments SİLİNEMEZ veya DEĞİŞTİRİLEMEZ!

Müşteri değişkeni error_payment_button düğme oluşturulurken bir hata oluşursa oluşturulur.

error_payment_button değişkeninin değeri ya hata metni ya da hatalı ödeme sistemi yanıtı olarak yazılır.

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

Sonuç nasıl işlenir

Dikkat!

Robokassa yalnızca Result URL parametresi üzerinden başarılı işlemler için bildirim gönderir. Robokassa hizmetinde başarısız ödemeler için geri çağırım yoktur.

Fail URL yalnızca başarısız ödeme sayfasıdır; ödeme sayfasında bir kod hatası oluşması durumunda ödeme yapan kişi buraya yönlendirilir.

Başarılı ödeme.

Ödemeyi doğru şekilde yapılandırıp işlemi gerçekleştirmek için bağlantıyı oluşturduktan sonra oluşturduğunuz ayarları test edin. Ödeme başarılı olursa müşteri diyaloğuna ("Müşteriler" bölümü) OTOMATİK OLARAK ödeme sisteminin gizli anahtarının 10 karakterinden, _success kelimesinden ve bir boşlukla ödeme tutarından oluşan bir GERİ ÇAĞIRIM gelir. Geri çağırım otomatik olarak oluşturulur, bunu kendiniz oluşturmanız veya ödeme sistemi desteğinden istemeniz gerekmez,

Örneğin: ovg58keefc_success 2999, burada:

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

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

2999: ödeme tutarı

Bloğun işlenmesi:

Geri çağırım:

Ödeme sisteminden gelen geri çağrımları (bildirimleri) kullanıcı GÖRMEZ. Bunlar yalnızca “Müşteriler” sekmesinde görüntülenir ve operatör/yönetici tarafından görülür.

Geri çağrıma tepki yapılandırma örneği

Koşullu blokta (bu hem “Başlangıç koşulu” bloğu hem de “Koşullu durum olmayan” bloğu olabilir) ödeme sırasında gelen geri çağrımı belirtmek gerekir.

Önemli: eşleşme türü olarak Tam eşleşme veya Anahtar kelimelerin varlığı

Sonrasında ödeme yapıldığında müşteriye geri çağrıma tepki ayarlanmış bloktan mesaj gelir:

Hatalı ödeme

Eğer düğme ayarlarında belirtilen tutar müşterinin ödediği tutardan farklıysa, bota OTOMATİK OLARAK ödeme sisteminin gizli anahtarının 10 karakterinden, _different_amounts kelimesinden ve bir boşlukla benzersiz ödeme kimliğinden oluşan bir GERİ ÇAĞIRIM 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 kimliği

Hesaplayıcıdaki get_robokassa_payment_url işlevi

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

Hesaplayıcı alanında değişkene işlevin değerini atayacağız get_robokassa_payment_url

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

Bu değişkene ödeme bağlantısı yazılır. Değişken, bir mesajda bağlantı olarak ekrana verilebilir veya “Öde” metinli düğmede yerleştirilebilir.

ÖDEME bağlantısı ÖRNEĞİ:: https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=test_salebot&OutSum=800&InvId=1412&IsTest=1&SignatureValue=0427369c3bd068bae30935f896060dda

Birçok ödeme sistemi bulut tabanlı çevrimiçi kasaları destekler; bunlar 54-FZ kapsamında gereklidir. Vergi dairesiyle rahatsız edici bir duruma düşmemek için seçtiğiniz ödeme sisteminin sitesinde fiş düzenleme özelliklerini okuyun.

Hesaplayıcı

Örnek 1:

Parametrelerin açıklaması

Kopyalama için kod örneği

Değişkeni bir mesajda bağlantı olarak ekrana verebilir veya örneğin “Satın Al” metinli düğmede yerleştirebilirsiniz.

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

Hata son Hesaplayıcıdaki işlevde

Ödemeyi doğru şekilde yapılandırıp işlemi gerçekleştirmek için bağlantıyı oluşturduktan sonra oluşturduğunuz ayarları test edin.

Ödeme açıklaması nasıl eklenir

payment_description değişkenini ayarlayarak ödemeye açıklama ekleyebilirsiniz payment_description

Bu açıklama ödeme formunda ve fişte görüntülenecektir.

Sonuç nasıl işlenir

Ödeme başarılı olursa müşteri diyaloğuna ("Müşteriler" bölümü) OTOMATİK OLARAK ödeme sisteminin gizli anahtarının 10 karakterinden, _success kelimesinden ve bir boşlukla ödeme tutarından oluşan bir GERİ ÇAĞIRIM gelir. Geri çağırım otomatik olarak oluşturulur, bunu kendiniz oluşturmanız veya ödeme sistemi desteğinden istemeniz gerekmez,

Örneğin: ovg58keefc_success 1500, burada:

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

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

1500: ödeme tutarı

Dikkat!

Geri çağırım yalnızca sizin müşteri diyaloğunuzda görünür.

Müşteri geri çağrımı görmez, ancak başarılı ödeme işlenmesine tepki ayarlayabilirsiniz.

Örnek

İşlevli bloğun ayarları get_robokassa_payment_url:

1. Bağlantıyı metin içinde veriyorsanız:

Önemli!

Ödeme bağlantısı benzersizdir: kopyalanıp daha sonra başka müşterilere gönderilemez!

Ödeme bağlantısını botta bir değişken üzerinden gönderin (bkz. şek. 17).

Başarılı ödeme durumunda geri çağırım:

1. Düğmedeki bağlantı:

Bloğun işlenmesi:

Başarılı ödeme durumunda geri çağırım:

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

Ödemeyi, yalnızca ödeme tutarını belirtmeniz yeterli olan payment_sum değişkeni kullanarak bağlantı oluşturarak da alabilirsiniz.

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

Ödeme bağlantısı oluşturmak için değişkenin değerini ayarlamanız gerekir payment_sum, hemen ardından değişken oluşur robokassa_pay_url. Bu değişken mesajda bağlantı olarak görüntülenebilir veya “Öde” metni bulunan düğmede yerleştirilebilir.

BLOĞUN İŞLENMESİ ÖRNEĞİ (ödeme bağlantıları):

Önemli!

Ödeme bağlantısı benzersizdir: kopyalanıp daha sonra başka müşterilere gönderilemez!

Ödeme bağlantısını botta bir değişken üzerinden gönderin

Bağlantıyı düğmeye aktarmak için, url alanındaki düğmede değişkeni belirtin:

payment_sum üzerinden ödeme bağlantısı oluştururken ödeme sonucu

Başarılı ödemeden sonra bota bir geri çağırım gelir. Bu geri çağrımı sistemde, kullanıcıdan gelen bir mesaj olarak görürsünüz; bunları kullanıcının gönderememesi için, Robokassa hizmetinin ilk şifresi ve success durum eki içerirler, örneğin: qxgZ7zkNX4HHnG8UpZ61_success.

Ayrıca başarılı ödemeden sonra değişken robokassa_payment_completed şuna ayarlanır True.

Bu geri çağırımı GÖRMEZ kullanıcı, bunlar yalnızca operatöre görüntülenir

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

Tekrar ödeme yapmak için önceden oluşturulmuş bağlantıyı mutlaka sıfırlamanız gerekir payment_sum, sonra payment_sum değişkenini yeniden atayıp yeni bağlantı alırsınız Değişkenleri sıfırlama örneği: robokassa_pay_url='' payment_sum=0

Ödeme tamamlandıktan sonra müşteriye şu değişken eklenir robokassa_callback_data, gerçekleşen işlem için ödeme sisteminin yanıt verilerini içeren. Alınan sözlükten gerekli veriler şu yöntemle çıkarılabilir get.

Test şeması nasıl oluşturulur

Robokassa hizmetiyle test etmeyi ve hızlıca çalışmaya başlamayı sağlayacak şema örneği:

Resimde, kullanıcıya ne kadar ödeme yapmak istediğinin sorulduğu ilk bloğun örneği gösteriliyor.

Aşağıdaki şekilde ok ayarları, içinde “Kullanıcı veri giriyor” anahtarı açık olmalı ve alana değişken yazılmalıdır payment_sum:

Daha sonra bir sonraki ödeme bloğunda bir düğme ekleyin ve url satırına değişkeni ayarlayın robokassa_pay_url:

Şema şu şekilde çalışır:

Düğmeye tıklandığında, müşterinin yazdığı tutar ödenebilir durumda olur.

Ödemeden sonra bir geri çağırım gelir, buna da tepki ayarlanabilir.

Önemli!

Robokassa'da başarısız ödeme için bir geri çağırım yoktur.

Bunun için koşullu başka bir blok ekleyin ve koşul satırına “qxgZ7zkNX4HHnG8UpZ61_success":

Kontrol türünü mutlaka “Tam eşleşme” olarak ayarlayın

Şema şu şekilde işleyecektir:

Fiskalizasyon isteği nasıl oluşturulur

“Ödeme” işlevli düğmede

Düğme oluşturulurken “Fiş oluşturma verileri” açılır menüsünde “Ürün adı”, “Ruble cinsinden tam tutar”, “Miktar”, “KDV oranı”, “Vergi sistemi” alanlarını doldurun.

Daha fazlası “Fiş oluşturmak için".

payment_sum değişkeni kullanılarak

Bağlantı oluşturma, payment_sum değişkeninin değerini ayarladığınız anda yapıldığından, products_for_receipt ve robokassa_sno değişkenlerini tanımlamanız gerekir.

Önemli:

• payment_sum değişkeni üzerinden bağlantı oluşturulurken, vergi sistemi robokassa_sno değişkeninde tanımlanır.

• payment_sum, tüm ürünlerin toplam maliyetine eşit olmalıdır (sum parametrelerinin toplamı).

Örnek:

session_timeout = 7200

product_name = İlk ödeme

robokassa_sno = osn

products_for_receipt = [{"name": "Ürün adı", "quantity": 2, "sum": 2, "tax": "none"}, {"name": "Ürün adı 2", "quantity": 1, "sum": 6, "tax": "none"}]

payment_sum = 10

get_robokassa_payment_url ve robokassa_recurrent_payment işlevleri için

İşlevler çağrıldığında get_robokassa_payment_url veya işlevi robokassa_recurrent_payment argüman olarak değişkenleri iletin taxation ve products_for_receipt aşağıdaki açıklamaya göre.

İşlevler, ürün kalemini dikkate alarak bağlantıyı hazırlayacak ve fiskalizasyon isteği oluşturacaktır.

Önemli:

Değişkenler taxation ve products_for_receipt her ayrı ödeme için ayarlanmalıdır.

Robokassa hizmeti bu parametreleri saklamaz ve kendisine ürün kalemi iletilmemiş ödemelerin fiskalizasyonunu gerçekleştiremez.

1. products_for_receipt - ürün kalemini içeren dizi.

Ürünün her bir birimi, şu parametreleri içeren bir sözlük olarak temsil edilmelidir name, quantity, sum, tax, payment_method, payment_object ve nomenclature_code.

! products_for_receipt şu biçimde belirtilmelidir:

[

{"name": "Ürün adı", "quantity": "Ürün miktarı", "sum": "Ürün fiyatı", "tax": "KDV oranı"},

{"name": "Ürün adı 2", "quantity": "Ürün miktarı 2", "sum": "Ürün fiyatı", "tax": "KDV oranı"}

]

burada,

1) name - ürün adı. Ürün adında özel karakterler, örneğin tırnak işaretleri kullanıyorsanız, bunları mutlaka escape etmelisiniz.

2) quantity - ürünün miktarı veya ağırlığı (nokta ile yazılan tam veya ondalık sayı)

3) sum veya amount (zorunlu, iki isim varyantı) - ilgili ürünün tüm miktarı için tüm olası indirimler, bonuslar ve özel fiyatlar dikkate alınarak ruble cinsinden tam tutar.

4) tax veya vat_code - (zorunlu, iki isim varyantı, değer isme bağlıdır) - KDV oranı. Bu parametre KKT'de vergi oranını belirler.

tax için değerler:

Değer	Açıklama
none	KDV'siz
vat0	%0 oranında KDV
vat5	%5 oranında KDV
vat12	%12 oranında KDV
vat16	%16 oranında KDV

vat_code için değer:

5) method veya payment_method - (iki isim varyantı, isteğe bağlı parametre) hesaplama yönteminin işareti.

Parametrenin olası değerleri:	Değerin anlamı:
full_prepayment	yüzde 100 peşin ödeme. Hesap konusu teslim edilmeden önce tam ön ödeme
prepayment	peşin ödeme. Hesap konusu teslim edilmeden önce kısmi ön ödeme
advance	avans
full_payment	tam hesaplaşma. Hesap konusu teslim edilirken avans (ön ödeme) dahil olmak üzere tam ödeme;
partial_payment	kısmi hesaplaşma ve kredi. Hesap konusu teslim edilirken kısmi ödeme ve ardından krediyle ödeme;
credit	krediyle teslim. Hesap konusu, teslim anında ödeme olmadan teslim edilir ve ardından krediyle ödenir;
credit_payment	kredi ödemesi. Hesap konusu teslim edildikten sonra krediyle ödeme (kredinin ödenmesi).

6) object veya payment_object - (isim için iki seçenek, isteğe bağlı parametre) hesap kalemi (iletilmezse commodity (ürün) olacaktır)

Parametrenin olası değerleri	Değerin ne ifade ettiği
commodity	Ürün. Satışı yapılan ürün hakkında, ÖTV'ye tabi ürün hariç (ürünün adı ve ürünü açıklayan diğer bilgiler)
excise	ÖTV'ye tabi ürün. Satışı yapılan ÖTV'ye tabi ürün hakkında (ürünün adı ve ürünü açıklayan diğer bilgiler)
job	İş. Yapılan iş hakkında (işin adı ve işi açıklayan diğer bilgiler)
service	Hizmet. Sunulan hizmet hakkında (hizmetin adı ve hizmeti açıklayan diğer bilgiler)
gambling_bet	Kumar oyunu bahsi. Kumar faaliyetlerinin yürütülmesi sırasında bahis kabulü hakkında
gambling_prize	kumar oyunu kazancı. Kumar faaliyetlerinin yürütülmesi sırasında kazanç olarak para ödenmesi hakkında
lottery	piyango bileti. Piyango biletlerinin, elektronik piyango biletlerinin satışı sırasında ve piyango faaliyetlerinin yürütülmesi sırasında piyango bahislerinin kabulü sırasında para kabulü hakkında
lottery_prize	piyango kazancı. Piyango faaliyetlerinin yürütülmesi sırasında kazanç olarak para ödenmesi hakkında
intellectual_activity	fikri faaliyet sonuçlarının sağlanması. Fikri faaliyet sonuçlarını veya bireyselleştirme araçlarını kullanma haklarının sağlanması hakkında
payment	ödeme. Avans, depozito, ön ödeme, kredi, ödeme hesabına katkı, gecikme faizi, ceza, ücret, bonus ve diğer benzer hesap kalemleri hakkında
agent_commission	acente ücreti. Ödeme acentesi (alt acente), banka ödeme acentesi (alt acente), komisyoncu, vekil veya diğer bir acente olan kullanıcının ücreti hakkında;
composite	bileşik hesap kalemi. Yukarıda listelenen işaretlerin her biri için bir değer atanabilen kalemlerden oluşan hesap kalemi hakkında
another	diğer hesap kalemi. Yukarıda listelenen hesap kalemlerine dahil olmayan hesap kalemi hakkında
property_right	mülkiyet hakkı
non-operating_gain	faaliyet dışı gelir
insurance_premium	sigorta primleri
sales_tax	ticaret vergisi
resort_fee	turizm vergisi

7) nomenclature_code - (koşullu zorunlu) ürün işaretlemesi: ürün ambalajında basılı olduğu şekilde iletilir.

Parametre yalnızca zorunlu işaretlemeye tabi ürünler satan mağazalar için zorunludur.

İşaretleme kodu ürün ambalajında, barkodun yanında veya QR kodu biçiminde bulunur.

Önemli! Fiskalizasyon için fiş parametrelerini iletmek önemlidir.

Fişin doğru formatı şu şekilde iletilir:

rec = [{"name": "1 aylık paket", "quantity": 1, "sum": 4800, "tax": "none"}]

response = robokassa_recurrent_payment(4800, 'Aviator Uçuş Okulu'nda eğitim, 'ru', rec, 'osn')

burada kendi verilerinizi girmeniz gerekir.

Kurslar sayfasında ödeme kabul ederken fiş oluşturma

Kurs ayarlarında "Ödeme" bölümünde Robokassa ödeme sistemini seçmeniz gerekir:

Ödeme sistemi ayarlarında "Tahsilat" bölümündeki (daha önce yapmadıysanız) "KDV oranı" alanını doldurun.

Ne tür hatalar olabilir

Hata kodu 40

«Aynı numarayla faturanın yeniden ödenmesi mümkün değildir».

Başarılı ödeme sonrası, yeni bir ödeme numarası oluşması için diyaloğu "Veri toplama sonu" bloğuna geçirmeniz gerekir.

Hata kodu 34

«Tekrarlayan ödeme hizmeti mağaza için izinli değildir».

Hata kodu 31

«Ödeme tutarı geçersiz».

Bu hata, müşterinin fatura oluşturmak için ödeme sayfasına yönlendirilmesi sırasında oluşabilir. Bu, ödeme yapmanız için bize iletmeniz gereken tutarı göndermediğiniz veya sıfıra eşit bir tutar gönderdiğiniz anlamına gelir.

Hata kodu 29

«Geçersiz Signature parametresi»

Burada birkaç neden olabilir, ancak hepsi ödeme başlatmasından sorumlu betikle (daha doğrusu, değişkenlerden oluşan formüle göre parameterSignature parametresini oluşturan kısmıyla) ilgilidir. Bu hata oldukça sık görülür ve işte 3 olası neden:

• Birincisi: geçersiz Mağaza Kimliği (MerchantLogin);

• İkincisi: yanlış Şifre 1 (MerchantPass1);

• Üçüncüsü: ek parametreler kullanıyorsunuz (shp_), bunlar kasa yazılımının koduna eklenmiş ancak hesaplama formülüne eklenmemiştir - ya da tam tersi, hesaplama formülünde belirtilmiş ama kodda yoktur. Eğer kullanılıyorsa, bunları alfabetik sırayla iletin – hem ödeme parametrelerinde hem de Signature hesaplama formülünde.

Önemli! Test modunda çalışıyorsanız, IsTest=1 parametresini göndererek veya modül/bot ayarlarında kutucuğu işaretleyerek yalnızca teknik şifrelerin test çiftini kullanın (mağazanızın kartındaki "Teknik ayarlar" sekmesi).

Hata kodu 23

«Test ödemesi oluşturulamaz. Mağazanın test parametreleri ayarlanmış değil».

Bu, test ödemesini gerçekleştirmeden önce "Teknik ayarlar" sekmesindeki "Test ödemesi gerçekleştirme parametreleri" bölümünde gerekli tüm verileri doldurmadığınız anlamına gelir.

Hata kodu 25

«Mağaza etkinleştirilmedi».

Bu hata sık görülür ve burada 2 neden olabilir.

• Birincisi: bu gerçekten böyledir – mağazayı etkinleştirmek ve ancak ondan sonra fatura kesmek gerekir.

• İkincisi: Mağaza Kimliğini sitedeki teknik ayarlarda yanlış girdiniz. Doğrusunu Kişisel Hesap'taki "Mağazalarım" bölümünde görebilirsiniz. "Teknik ayarlar" sekmesine gidin ve "Mağaza Kimliği" alanını bulun. Kimliği kopyalayın ve site ayarlarına girin.

Robokassa hizmetinde otomatik ödemeler nasıl yapılır

Hizmet için otomatik ödeme bağlantısının adım adım talimatı Robokassa

Adım 1. Ödeme düğmesinde otomatik ödemeleri etkinleştirin

Ödeme bağlantısını verdiğiniz bloğun ayarlarına gidin ve düğme ayarlarını açın:

Ardından düğme ayarlarında "Otomatik ödemeler" onay kutusunu bulun ve etkinleştirin:

Tüm ödeme düğmelerinde otomatik ödeme almak istiyorsanız, bunları ödeme sistemi bağlantı ayarlarından etkinleştirebilirsiniz:

Adım 2. Normal bir ödeme gerçekleştirin. Ardından yukarıda açıklandığı gibi normal bir ödeme gerçekleştirmelisiniz (ödeme bağlantısını alın ve müşterinin onu ödemesini sağlayın). Başarılı ödemeden sonra müşteride değişken görünecektir robokassa_previous_invoice_id ödeme kimliği ile.

Değişken robokassa_previous_invoice_id sonraki ödemeler için zorunludur. Silinirse, sonraki otomatik ödeme YAPILAMAZ.

Dikkat!

Devre dışı bırakın onay kutusunu "Test modunda ödemeler" (eğer sizde aktifse), aksi halde ödeme kimliğiyle birlikte robokassa_previous_invoice_id değişkeni oluşturulmayacaktır!

Normal ödeme için bağlantı oluşturma örneği

Adım 3. Otomatik tahsilatı planlıyoruz

"Başarılı ödeme" bloğundan, zamanlayıcılı bir oku otomatik ödeme bloğuna planlıyoruz. Örnek olarak, sonraki ödemeyi 30 gün sonra planlayalım.

Otomatik ödemenin ilgili blokta gerçekleşmesi için, Hesaplayıcı alanına şu işlev çağrısını eklemek gerekir robokassa_recurrent_payment, parametreleri belirtilen sırayla ileterek:

1. payment_amount - ödeme tutarı (ürünün ruble cinsinden fiyatı)

2. description - ürün adı. Bu alanda yalnızca İngilizce veya Rus alfabesindeki karakterler, rakamlar ve noktalama işaretleri kullanılabilir. Maksimum uzunluk 100 karakterdir. Bu bilgi Robokassa arayüzünde ve müşterinin başarılı ödemeden sonra aldığı Elektronik Makbuzda gösterilir.

3. country - alan adı uzantısı (‘ru’ veya ‘kz’)

4. products_for_receipt - fiş oluşturmak için parametreler.

Daha fazla bilgi için "Fiskalizasyon isteği nasıl oluşturulur ->" bölümüne bakın get_robokassa_payment_url ve robokassa_recurrent_payment işlevleri için

1. taxation - vergi sistemi.

Daha fazla bilgi için "Fiskalizasyon isteği nasıl oluşturulur ->" bölümüne bakın get_robokassa_payment_url ve robokassa_recurrent_payment işlevleri için

Otomatik ödeme isteği örneği:

Otomatik ödeme yapılırken Robokassa ödeme bağlantısı ve değişken olmamalıdır payment_sum!

Adım 4. Düzenli tahsilatları planlıyor ve otomatik ödemelerden vazgeçme seçeneğini ayarlıyoruz. Ödemeleri düzenli olarak tekrarlamak için bir döngü planlıyoruz - örneğin 30 günlük bir gecikmeli ok.

Döngü - Otomatik ödeme bloğuna tekrar geçiş

Otomatik ödemeleri iptal etme seçeneğiniz varsa, sonraki ödemenin yapılmaması için müşterinin değişkenini silmeniz gerekir robokassa_previous_invoice_id Bunun için Hesaplayıcı alanında değişkeni siliyoruz: robokassa_previous_invoice_id = ""

Otomatik ödemeler açıkken normal ödeme

Otomatik ödemeler etkinse, ancak abonelik olmadan (otomatik ödeme olmadan) bir bağlantı gerekiyorsa, bağlantı oluşturulmadan önce robokassa_manual_recurrent_disable değişkenini 1 değerine ayarlamak gerekir Hesaplayıcı alanında değişkeni tanımlayalım: robokassa_manual_recurrent_disable = 1

Otomatik Ödemeler açıkken normal ödeme bağlantısı oluşturmak için blok ayarları

Dikkat!

Otomatik ödemelerdeki callback, başarılı ödemelerde gelen callback ile aynıdır.

Callback'e nasıl tepki verileceğini "Sonuç nasıl işlenir"

Robokassa hizmetinin sohbet botları için gereksinimleri nelerdir

Robokassa hizmetinin resmi yanıtı:

Ürünü açıklama ve fiyat etiketiyle pazara koyabilir ve botta ödeme alabilirsiniz, açıklama, fiyat etiketi, iletişim bilgileri ve ürün/hizmet teslimatının elektronik olduğuna dair bilgi içeren tek sayfalık bir site yapabilirsiniz. Pazardaki ürüne veya siteye bir bağlantı olması gerekir; çünkü botunuzda ne sattığınızı ve hangi botta olduğumuzu bilemeyiz.

Telegram kanalına URL olarak bağlantı eklemiyoruz. Ayrıca site içeriği gereksinimleri: "Site çalışır durumda olmalı, içeriği dolu olmalı ve iç bağlantıları çalışmalıdır."

Sitenizdeki ürün ve hizmetler ayrıntılı olarak açıklanmalıdır: Açıklama, sunulan ürün ve hizmetlerin özelliklerini, tüketici niteliklerini ve güncel fiyatını içermelidir.

Sitenizde güncel bilgiler mutlaka yer almalıdır: telefon, e-posta, sipariş verme kuralları ve siparişin yerine getirilme süreleri, ödeme, teslimat ve iade koşulları.

Her site ayrı ayrı değerlendirilir.

Telegram'da Robokassa

RobokassaPaymentTestBot test botunun bağlanması.

1. "Connect Robokassa Test" seçildiğinde kullanıcı RobokassaPaymentTestBot botuna yönlendirilir.

2. Kullanıcı /başlat düğmesine basar.

3. Kullanıcı bottan «Mağaza ID'sini girin» yanıtını alır.

4. Robokassa hizmetindeki mağaza ID'sini girmeniz gerekir.

5. Bot, mağazada belirtilen numaraya SMS göndererek mağaza sahipliğini doğrulamanızı isteyecektir: «*%%%% numarasına SMS gönderildi» burada %%%% telefon numarasının son 4 hanesidir

6. Kullanıcı 6 haneli kodu girer.

7. Her şey başarılı olursa kullanıcıya şu mesaj gösterilir: “@BotName botunu Robokassa'ya başarıyla bağladınız. @BotFather size yeni token'ı bildirecek.”

8. Bundan sonra BotFather'da ödemelerin bağlandığı ödeme token'ı görünür.

RobokassaPaymentBot canlı botunun bağlanması.

1. "Connect Robokassa Live" seçildiğinde kullanıcı RobokassaPaymentBot botuna yönlendirilir,

2. Kullanıcı /başlat düğmesine basar.

3. Kullanıcı bottan «Mağaza ID'sini girin» yanıtını alır.

4. Robokassa hizmetindeki mağaza ID'sini girmeniz gerekir.

5. Bot, mağazada belirtilen numaraya SMS göndererek mağaza sahipliğini doğrulamanızı isteyecektir: «*%%%% numarasına SMS gönderildi», burada %%%% telefon numarasının son 4 hanesidir

6. Kullanıcı 6 haneli kodu girer.

7. Her şey başarılı olursa kullanıcıya şu mesaj gösterilir: “@BotName botunu Robokassa'ya başarıyla bağladınız. @BotFather size yeni token'ı bildirecek.”

8. Bundan sonra BotFather'da ödemelerin bağlandığı ödeme token'ı görünür.

Ödeme sonuçlarının işlenmesi yukarıda açıklanana benzer burada