Robokassa Nasıl Yapılandırılır
Robokassa hizmeti aracılığıyla botta ödeme almayı nasıl uygulayacağımızı inceleyelim.
- Robokassa hizmetinin kişisel hesabınızda bir internet mağazası oluşturun ve aşağıdaki teknik ayarları belirtin:
- Hash hesaplama algoritması: MD5\
- Result Url: https://chatter.mavibot.ai/robokassa\_callback/result\
- Result Url'ye veri gönderme yöntemi: GET\
- Success Url: https://chatter.mavibot.ai/robokassa\_callback/success\
- Success Url'ye veri gönderme yöntemi: GET\
- Fail Url: https://chatter.mavibot.ai/robokassa\_callback/fail\
- Fail Url'ye veri gönderme yöntemi: GET
Test şifreleri oluşturun ve ilk yapılandırmayı test modunda gerçekleştirin.
Robokassa MaviBot'a Nasıl Bağlanır?
"Edinme" bölümüne gidin ve Robokassa kartında "Bağla" düğmesine tıklayın:
ve açılan formu doldurun:
- Mağaza Kimliği alanı — Robokassa kişisel hesabınızdaki mağaza ayarlarında bulabileceğiniz Shop ID.
- Şifre #1, şifre #2 — benzersiz oluşturulmuş rakam+harf dizileri.
- KDV Oranı alanı. KDV değerini iletmek için uygun kodu belirtmek gerekir. Bu alan, yazar kasadaki vergi oranını belirler. Her bir ürün türü için ayrı ayrı belirlenir, ancak belirli bir ürünün tüm birimleri için birlikte geçerlidir.
Şu değerlerle uygulanır:
- KDV'siz.
- %0 oranında KDV.
- %5 oranında KDV.
- %12 hesaplanmış oranında KDV.
- %16 hesaplanmış oranında KDV.
Ödeme Bağlantısı Nasıl Oluşturulur
Blokta bir ödeme bağlantısı oluşturmak için mevcut yöntemlerden BİRİNİ kullanabilirsiniz:
- Ödeme işlevli düğme veya
- Hesap Makinesi'nde get_robokassa_payment_url işlevi veya
- payment_sum değişkeni ve ek parametreler kullanarak bağlantı oluşturma (eski ancak çalışan sürüm)
Ödeme İşlevli Düğme
Ödeme bağlantısı, "Ödeme" işlevine sahip bir düğmede oluşturulabilir.
"Ödeme" işlevine sahip bir düğmenin nasıl oluşturulacağını burada anlattık.
Bu düğmenin tüm olası parametrelerini inceleyelim. Ödeme işlevine sahip bir düğmenin nasıl oluşturulacağı bu makalede anlatılmıştır:
Ödeme düğmesinin zorunlu parametreleri
Bir ödeme bağlantısı oluşturmak için düğme ayarlarında zorunlu parametreleri belirtmek gerekir: Tutar ve Ürün Adı.
Tutar alanı. Bu alanda ürünün ruble cinsinden fiyatını belirtin.
Ürün Adı alanı. Bu alanda yalnızca İngilizce veya Rus alfabesi karakterleri, rakamlar ve noktalama işaretleri kullanılabilir. Maksimum uzunluk — 100 karakter. Bu bilgi, Robokassa arayüzünde ve müşterinin başarılı ödeme sonrası aldığı Elektronik Makbuzda görüntülenir.
Ürün adında çift tırnak KULLANILAMAZ: kaldırın veya tek tırnakla değiştirin.
Otomatik Ödeme onay kutusu. Otomatik ödemeyi etkinleştirmek için.
Tıklama bildirimi ile onay kutusu. Ödeme bağlantısına tıklamayı izlemek için işaretlenebilir. Bu durumda, düğmeye tıklandığında müşteriyle olan diyalogda Salesbot'a bağlantıya tıklandığına dair bir bildirim gelir.
Bu bildirim, botun daha sonraki çalışma mantığını yapılandırmak için kullanılabilir.
Birçok ödeme sistemi bulut tabanlı çevrimiçi yazar kasaları destekler, bunlar 54-FZ gereğince zorunludur.
Seçilen ödeme sisteminin web sitesinde makbuz düzenleme özelliklerini okuyun, vergi dairesiyle zor duruma düşmemek için.
Makbuz oluşturmak için
Makbuz oluşturma verileri menüsü. Tıklandığında, makbuz oluşturma parametrelerini içeren bir açılır menü açılır:
Ürün Adı alanı. Makbuz oluşturmak için zorunludur.
Ürün Adında çift tırnak KULLANILAMAZ: kaldırın veya tek tırnakla değiştirin.
Ruble cinsinden Toplam Tutar alanı. Bu alanda, ürün miktarı dikkate alınarak ödenecek tutar belirtilmelidir. Miktar 1 ise, Ruble cinsinden Toplam Tutar, düğme ayarlarının zorunlu alanındaki Tutar alanındaki değere eşittir.
Miktar alanı. Ürün miktarı veya ağırlığı. Tam sayı veya nokta ile ayrılmış ondalık sayı olarak 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üğmesini içeren bir blok alır almaz, müşteri değişkenleri otomatik olarak oluşturulacaktır:
Müşterinin hizmet değişkeni __payments , tutarı, oluşturulan bağlantının kimliğini saklar ve ödeme sisteminden gelen hook'u tanımlamak için gereklidir.
Müşterinin hizmet değişkeni __payments SİLİNEMEZ veya değiştirilemez!
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ğerine ya hata metni ya da ödeme sisteminden hata içeren yanıt yazılır.
Değişkenlerin değerleri, bir sonraki bloğa geçildiğinde güncel hale gelir.
Sonuç nasıl işlenir
Dikkat!
Robokassa, yalnızca başarılı işlemler için Result URL parametresi aracılığıyla bildirim gönderir. Robokassa hizmetinde başarısız ödemeler için geri arama yoktur.
Fail URL - yalnızca ödeme sayfasında kod hatası oluşması durumunda ödeyicinin yönlendirileceği başarısız ödeme sayfasıdır.
Başarılı ödeme.
Ödemeyi doğru bir şekilde yapılandırdıktan ve ödeme için bir bağlantı oluşturduktan sonra, oluşturulan ayarları test edin. Ödeme başarılı olursa, müşteri diyaloğuna ("Müşteriler" bölümü) OTOMATİK OLARAK bir GERİ ARAMA gelir; bu, ödeme sisteminin gizli anahtarının 10 karakterinden, _success kelimesinden ve bir boşlukla ayrılmış ödeme tutarından oluşur. Geri arama otomatik olarak oluşturulur, kendiniz oluşturmanız veya ödeme sistemi desteğinden talep etmeniz gerekmez.
Örneğin: ovg58keefc_success 2999, burada:
ovg58keefc : ödeme sisteminin gizli anahtarının 10 karakteri
_success : istek işleme sonucu (başarılı ödeme)
2999 : ödeme tutarı
Blok işleme:
Geri arama:
Ödeme sisteminden gelen geri aramalar (bildirimler) kullanıcı tarafından GÖRÜLMEZ. Bunlar yalnızca "Müşteriler" sekmesinde görüntülenir ve operatör/yönetici tarafından görülür.
Geri aramaya tepki yapılandırma örneği
Koşul bloğunda (bu, "Başlangıç Koşulu" bloğu veya "Koşullu Durum Değil" bloğu olabilir), ödeme sırasında gelen geri aramayı belirtmek gerekir.
Önemli: Tam Eşleşme veya Anahtar Kelimelerin Varlığına Göre eşleşme seçimi
Daha sonra, ödeme sırasında müşteriye, geri aramaya tepkinin yapılandırıldığı bloktan bir mesaj gelecektir:
Hatalı ödeme
Düğme ayarlarında belirtilen tutar müşterinin ödediği tutardan farklıysa, bota OTOMATİK OLARAK bir GERİ ARAMA gelir; bu, ödeme sisteminin gizli anahtarının 10 karakterinden, _different_amounts kelimesinden ve bir boşlukla ayrılmış benzersiz ödeme kimliğinden oluşur.
Örneğin: ovg58keefc_different_amounts 123456 , burada:
ovg58keefc : ödeme sisteminin gizli anahtarının 10 karakteri
_different_amounts : istek işleme sonucu (ödeme tutarı bağlantıdaki tutardan farklı)
123456 : benzersiz ödeme kimliği
Hesap Makinesi'nde get_robokassa_payment_url işlevi
Ödeme bağlantısı oluşturmak için bloktaki Hesap Makinesi'nde get_robokassa_payment_url işlevini kullanabilirsiniz.
Hesap Makinesi alanında, değişkene get_robokassa_payment_url işlevinin değerini atayın.
Değişken adını kendiniz belirlersiniz. Ekran görüntülerinde değişken adı örnekleri verilmiştir.
Bu değişkene ödeme bağlantısı yazılacaktır. Değişken, bir mesajda bağlantı olarak görüntülenebilir veya "Öde" metniyle bir düğmeye yerleştirilebilir.
ÖDEME BAĞLANTISI Ö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 yazar kasaları destekler, bunlar 54-FZ gereğince zorunludur.
Seçilen ödeme sisteminin web sitesinde makbuz düzenleme özelliklerini okuyun, vergi dairesiyle zor duruma düşmemek için.
Hesap Makinesi
Örnek 1:
Parametrelerin açıklaması
get_robokassa_payment_url(amount, description, products_for_receipt, recurrent, currency)
İşlev parametreleri:
| Parametre | Parametre değeri |
|---|---|
amount |
**Ödenecek tutar.** Bu alanda ürünün ruble cinsinden fiyatını belirtin. (Zorunlu parametre) |
description |
**Ürün adı.** Bu alanda yalnızca İngilizce veya Rus alfabesi karakterleri, rakamlar ve noktalama işaretleri kullanılabilir. Maksimum uzunluk — 100 karakter. Bu bilgi, Robokassa arayüzünde ve müşterinin başarılı ödeme sonrası aldığı Elektronik Makbuzda görüntülenir. (Zorunlu parametre) |
|
|
**Makbuz oluşturma parametreleri.** Daha fazla bilgi için buraya bakın. |
recurrent |
**Otomatik ödemeyi etkinleştirme.** Otomatik ödeme etkinse, 1 değerini iletin, devre dışıysa None değerini iletin. |
currency |
**Üç harfli para birimi kodu.** Değer, Robokassa hizmeti tarafından kabul edilen parametrelere tam olarak uygun şekilde iletilmelidir. |
Kopyalamak için kod örneği
Örnek 1: Makbuzsuz ödeme bağlantısı
res = get_robokassa_payment_url(100, 'Kup menya')
Ö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, 'Kup menya', receipt, '3', 1, 1)
Değişken, bir mesajda bağlantı olarak görüntülenebilir veya örneğin "Satın Al" metniyle bir düğmeye yerleştirilebilir.
Blokta bağlantı almak için birden fazla işlev varsa ve bir hata oluşursa, hata değeri
error_payment_funcdeğişkenine yazılacaktır.
Hata, Hesap Makinesi'ndeki son işleve göre yazılacaktır.
Ödemeyi doğru bir şekilde yapılandırdıktan ve ödeme için bir bağlantı oluşturduktan sonra, oluşturulan ayarları test edin.
Ödeme Açıklaması Nasıl Eklenir
payment_description değişkenini ayarlayarak ödemeye bir açıklama ekleyebilirsiniz.
Bu açıklama, ödeme formunda ve makbuzda 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 bir GERİ ARAMA gelir; bu, ödeme sisteminin gizli anahtarının 10 karakterinden, _success kelimesinden ve bir boşlukla ayrılmış ödeme tutarından oluşur. Geri arama otomatik olarak oluşturulur, kendiniz oluşturmanız veya ödeme sistemi desteğinden talep etmeniz gerekmez.
Örneğin: ovg58keefc_success 1500, burada:
ovg58keefc : Ödeme sisteminin gizli anahtarının 10 karakteri
_success : İstek işleme sonucu (başarılı ödeme)
1500 : Ödeme tutarı
Dikkatinizi çekeriz!
Geri bildirim yalnızca sizin tarafınızdan müşteriyle olan diyalogda görülebilir.
Müşteri geri bildirimi görmez, ancak başarılı ödeme işleme için bir tepki ayarlayabilirsiniz.
Örnek
get_robokassa_payment_url: fonksiyonuna sahip blok ayarları
- Bağlantıyı metin içinde veriyorsanız:
Önemli!
Ödeme bağlantısı benzersizdir: kopyalanıp başka müşterilere yönlendirilemez!
Ödeme bağlantısını botta bir değişken aracılığıyla yönlendirin (bkz. Şekil 17).
Başarılı ödemede geri bildirim:
- Düğmede bağlantı:
Blok işleme:
Başarılı ödemede geri bildirim:
payment_sum değişkeni ve ek parametreler kullanarak bağlantı oluşturma
Ödemeyi, ödeme tutarını belirtmenin yeterli olduğu payment_sum değişkenini kullanarak bir bağlantı oluşturarak da kabul edebilirsiniz.
Dikkat: payment_sum değişkenine, isteğe bağlı payment_description, product_name vb. değişkenlerden sonra en son değer atanır.
Ödeme bağlantısı oluşturmak için payment_sum değişkeninin değerini ayarlamanız gerekir, hemen ardından robokassa_pay_url değişkeni görünecektir. Bu değişkeni ekrana bağlantı olarak çıkarabilir veya "Öde" metniyle bir düğmeye yerleştirebilirsiniz.
Blok işleme ÖRNEĞİ (ödeme bağlantıları):
Önemli!
Ödeme bağlantısı benzersizdir: kopyalanıp başka müşterilere yönlendirilemez!
Ödeme bağlantısını botta bir değişken aracılığıyla yönlendirin
Bağlantıyı bir düğmede iletmek için, düğmedeki url alanında değişkeni belirtin:
payment_sum aracılığıyla ödeme bağlantısı oluştururken ödeme sonucu
Başarılı ödemeden sonra bot bir geri bildirim alacaktır. Sistemde bu geri bildirimi kullanıcıdan gelen bir mesaj olarak görürsünüz, kullanıcının gönderememesi için Robokassa hizmetinin ilk parolasından ve success durumu eklenmesinden oluşur, örneğin: qxgZ7zkNX4HHnG8UpZ61_success.
Ayrıca başarılı ödemeden sonra robokassa_payment_completed değişkeni True olarak ayarlanır.
Bu geri bildirim kullanıcı tarafından GÖRÜLMEZ, yalnızca operatöre görüntülenir
Karşılaştırma türü "Tam eşleşme" olmalıdır
Tekrarlanan ödeme yapmak için payment_sum'ı, daha önce oluşturulan bağlantıyı sıfırlamak ve ardından yeni bir bağlantı almak için payment_sum değişkenini yeniden atamak zorunludur
Değişkenleri sıfırlama örneği:
robokassa_pay_url=''
payment_sum=0
Ödeme tamamlandıktan sonra müşteriye, gerçekleştirilen işlemle ilgili ödeme sisteminin yanıt verilerini içeren robokassa_callback_data değişkeni eklenecektir. Elde edilen sözlükten get yöntemi kullanılarak gerekli veriler çıkarılabilir.
Test şeması nasıl oluşturulur
Robokassa hizmetiyle çalışmayı test etmenize ve hızlı bir şekilde başlamanıza olanak tanıyan örnek bir şema:
Şekilde, kullanıcıya ne kadar ödemek istediğinin sorulduğu ilk blok örneği gösterilmektediь.
Aşağıdaki şekilde ok ayarları gösterilmektedir, burada "Kullanıcı veri girer" anahtarı etkinleştirilmeli ve alana payment_sum değişkeni yazılmalıdır:
Daha sonraki ödeme bloğuna bir düğme ekleyin ve url satırına robokassa_pay_url değişkenini ayarlayın:
Şema aşağıdaki gibi çalışacaktır:
Düğmeye tıklandığında, müşterinin yazdığı tutar ödemeye hazır olacaktır.
Ödemeden sonra, üzerinde bir tepki de ayarlanabilen bir geri bildirim gelecektir.
Önemli!
Robokassa'da başarısız ödeme geri bildirimi yoktur.
Bunun için bir koşul içeren başka bir blok ekleyin ve koşul satırına "qxgZ7zkNX4HHnG8UpZ61_success" türünde bir geri bildirim yazın:
Kontrol türünü mutlaka "Tam eşleşme" olarak ayarlayın
Şema aşağıdaki gibi çalışacaktır:
Fişleme talebi nasıl oluşturulur
"Ödeme" fonksiyonuna sahip düğmede
Bir düğme oluştururken, "Fiş oluşturma verileri" açılır menüsünde "Ürün adı", "Ruble cinsinden tam tutar", "Miktar", "KDV oranı", "Vergilendirme sistemi" alanlarını doldurun.
Daha fazla ayrıntı "Fiş oluşturma için" bölümünde.
payment_sum değişkenini kullanarak
Bağlantı oluşturma, payment_sum değişkeninin değerini ayarladığınız anda gerçekleştiğinden, products_for_receipt ve robokassa_sno değişkenlerini ayarlamanız gerekir.
Önemli:
- payment_sum değişkeni aracılığıyla bağlantı oluştururken, vergilendirme sistemi robokassa_sno değişkeninde ayarlanır.
- payment_sum, tüm ürünlerin toplam maliyetine (tüm sum parametrelerinin toplamı) eşit olmalıdır.
Ö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 fonksiyonları için
get_robokassa_payment_url fonksiyonunu veya robokassa_recurrent_payment fonksiyonunu çağırırken, aşağıdaki açıklamaya göre taxation ve products_for_receipt değişkenlerini argüman olarak iletinе.
Fonksiyonlar, ürün terminolojisini dikkate alarak bir bağlantı hazırlayacak ve bir fişleme talebi oluşturacaktır.
Önemli:
taxation ve products_for_receipt değişkenleri her bir ödeme için ayrı ayrı ayarlanmalıdır.
Robokassa hizmeti bu parametreleri saklamaz ve terminolojisi iletilmemiş ödemelerin fişlemesini gerçekleştiremez.
- products_for_receipt - ürün terminolojisini içeren dizi.
Her bir ürün birimi, name, quantity, sum, tax, payment_method, payment_object ve nomenclature_code parametrelerini içeren bir sözlük olarak temsil edilmelidir.
!** products_for_receipt aşağıdaki formatta belirtilmelidir:
[
{"name": "Ürün adı", "quantity": "Ürün miktarı", "sum": "Ürün maliyeti", "tax": "KDV oranı"},
{"name": "Ürün adı 2", "quantity": "Ürün 2 miktarı", "sum": "Ürün maliyeti", "tax": "KDV oranı"}
]
burada,
1) name - ürün adı. Ürün adında tırnak işareti gibi özel karakterler kullanıyorsanız, bunların mutlaka kaçış karakteriyle kullanılması gerekir.
2) quantity - ürün miktarı veya ağırlığı (nokta ile ayrılmış tam veya ondalık sayı)
3) sum veya amount (zorunlu, iki ad seçeneği) - bu ürünün tüm miktarı için olası tüm indirimler, bonuslar ve özel fiyatlar dikkate alınarak ruble cinsinden tam tutar.
4) tax veya vat_code - (zorunlu, iki ad seçeneği, değer ada bağlıdır) - KDV oranı. Bu parametre, KKD'deki vergi oranını ayarlar.
**tax için değerler: **
| Değer | Açıklama |
|---|---|
| none | KDV'siz |
| vat0 | %0 KDV |
| vat5 | %5 KDV |
| vat12 | %12 KDV |
| vat16 | %16 KDV |
vat_code için değerler:
| Değerler | Açıklama |
|---|---|
| '1' | KDV'siz |
| '2' | %0 KDV |
| '8' | %5 KDV |
| '15' | %12 KDV |
| '14' | %16 KDV |
5) method veya payment_method - (iki ad seçeneği, isteğe bağlı parametre) hesaplama yöntemi işareti.
| Parametrenin olası değerleri: | Değerin anlamı: |
|---|---|
| full_prepayment | %100 ön ödeme. Hesaplama konusunun tesliminden önce tam ön ödeme |
| prepayment | ön ödeme. Hesaplama konusunun tesliminden önce kısmi ön ödeme |
| advance | avans |
| full_payment | tam hesaplama. Hesaplama konusunun teslimi anında avans (ön ödeme) dahil tam ödeme; |
| partial_payment | kısmi hesaplama ve kredi. Hesaplama konusunun teslimi anında kısmi ödeme ve ardından kredili ödeme; |
| credit | krediyle teslim. Hesaplama konusunun teslimi anında ödeme yapılmadan teslim ve ardından kredili ödeme; |
| credit_payment | kredi ödemesi. Hesaplama konusunun kredili tesliminden sonra ödeme (kredi ödemesi). |
6) object veya payment_object - (iki ad seçeneği, isteğe bağlı parametre) hesaplama konusu (iletilmezse, commodity (mal) olacaktır)
| Parametrenin olası değerleri | Değerin anlamı |
|---|---|
| commodity | Mal. ÖTV'ye tabi olmayan satılan mal hakkında (malı tanımlayan ad ve diğer bilgiler) |
| excise | ÖTV'ye tabi mal. Satılan ÖTV'ye tabi mal hakkında (malı tanımlayan ad ve diğer bilgiler) |
| job | İş. Yapılan iş hakkında (işi tanımlayan ad ve diğer bilgiler) |
| service | Hizmet. Sunulan hizmet hakkında (hizmeti tanımlayan ad ve diğer bilgiler) |
| gambling_bet | Şans oyunu bahsi. Şans oyunları düzenleme faaliyeti yürütülürken bahis kabulü hakkında |
| gambling_prize | şans oyunu kazancı. Şans oyunları düzenleme faaliyeti yürütülürken kazanç olarak nakit para ödenmesi hakkında |
| lottery | piyango bileti. Piyango biletleri, elektronik piyango biletleri satışında, piyango düzenleme faaliyeti yürütülürken piyango bahislerinin kabulünde nakit para alınması hakkında |
| lottery_prize | piyango kazancı. Piyango düzenleme faaliyeti yürütülürken kazanç olarak nakit para ödenmesi hakkında |
| intellectual_activity | fikri mülkiyet sonuçlarının sağlanması. Fikri mülkiyet faaliyeti sonuçlarını veya kişiselleştirme araçlarını kullanma haklarının sağlanması hakkında |
| payment | ödeme. Avans, depozito, ön ödeme, kredi, ödeme karşılığı katkı, ceza, para cezası, ücret, bonus ve diğer benzer hesaplama konuları hakkında |
| agent_commission | acentelik ücreti. Ödeme acentesi (alt acente), banka ödeme acentesi (alt acente), komisyoncu, vekil veya diğer acente olan kullanıcının ücreti hakkında; |
| composite | bileşik hesaplama konusu. Her birine yukarıdaki işaretlerden birinin değeri atanabilen konulardan oluşan hesaplama konusu hakkında |
| another | diğer hesaplama konusu. Yukarıdaki hesaplama konularına ait olmayan hesaplama konusu hakkında |
| property_right | mülkiyet hakkı |
| non-operating_gain | faaliyet dışı gelir |
| insurance_premium | sigorta primleri |
| sales_tax | ticaret vergisi |
| resort_fee | tatil yeri ücreti |
- nomenclature_code - (koşullu olarak zorunlu) ürün etiketi: ürün ambalajında basıldığı şekliyle iletilir.
Bu parametre yalnızca zorunlu etiketlemeye tabi ürünleri satan mağazalar için zorunludur.
Etiket kodu, ürün ambalajında, barkodun yanında veya QR kodu şeklinde bulunur.
Önemli! Fişleştirme için fiş parametrelerini iletmek önemlidir.
Doğru fiş formatı şu şekilde iletilir:
rec = [{"name": "Paket 1 ay", "quantity": 1, "sum": 4800, "tax": "none"}]
response = robokassa_recurrent_payment(4800, 'Aviator Uçuş Okulunda Eğitim', 'ru', rec, 'osn')
burada kendi verilerinizi girmeniz gerekir.
Kurs sayfasında ödeme alırken fiş oluşturma
Kurs ayarlarında "Ödeme" bölümünde Robokassa ödeme sistemini seçmeniz gerekir:
Ödeme sistemi ayarlarında (daha önce yapmadıysanız) "Edinme" bölümünde "KDV Oranı" alanını doldurun.
Hangi hatalar oluşabilir
Hata kodu 40
"Aynı numaraya sahip bir faturanın tekrar ödenmesi mümkün değildir."
Başarılı bir ödemeden sonra, yeni bir ödeme numarası oluşturmak için diyaloğu "Veri Toplama Sonu" bloğuna taşımak gerekir.
Hata kodu 34
"Mağaza için yinelenen ödeme hizmetine izin verilmiyor."
Hata kodu 31
"Geçersiz ödeme tutarı."
Bu hata, müşteri fatura kesmek için ödeme sayfasına yönlendirilirken ortaya çıkabilir. Bu, ödemenin yapılması gereken tutarı iletmediğiniz veya sıfıra eşit bir tutar ilettiğiniz anlamına gelir.
Hata kodu 29
"Geçersiz İmza parametresi"
Bunun birkaç nedeni olabilir, ancak hepsi ödemeyi başlatan komut dosyasıyla (daha doğrusu, değişkenlerden oluşan İmza parametresini oluşturan kısmı) ilgilidir. Bu hata oldukça yaygındır ve işte 3 olası neden:
- Birincisi: geçersiz Mağaza Kimliği (MerchantLogin);
- İkincisi: yanlış Parola 1 (MerchantPass1);
- Üçüncüsü: kasa yazılım koduna eklenmiş ancak hesaplama formülüne dahil edilmemiş ek parametreler (shp_) kullanıyorsunuz - veya tam tersi, hesaplama formülünde belirtilmiş ancak kodda yok. Bunlar kullanılıyorsa, hem ödeme parametrelerinde hem de İmza hesaplama formülünde alfabetik sırayla iletin.
Önemli nokta! Test modunda çalışıyorsanız, IsTest=1 parametresini ileterek veya modül/bot ayarlarında işaretleyerek, yalnızca test teknik parola çiftini kullanın (mağaza kartınızın "Teknik Ayarlar" sekmesi).
Hata kodu 23
"Test ödemesi oluşturulamıyor. Mağazanın test parametre ayarları yok."
Bu, test ödemesi yapmadan önce "Teknik Ayarlar" sekmesinin "Test Ödemeleri Parametreleri" bloğunda gerekli tüm verileri doldurmadığınız anlamına gelir.
Hata kodu 25
"Mağaza etkinleştirilmedi."
Bu hata sık karşılaşılan bir durumdur ve 2 nedeni olabilir.
- Birincisi: durum gerçekten böyledir – mağazayı etkinleştirmeniz ve ancak o zaman fatura kesmeniz gerekir.
- İkincisi: sitedeki teknik ayarlarda Mağaza Kimliğini yanlış belirttiniz. Doğru olanı Kişisel Hesabınızın "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 hizmetinin otomatik ödemeleri nasıl yapılır
Robokassa hizmeti için otomatik ödeme bağlama adım adım talimatı
Adım 1. Ödeme düğmesinde otomatik ödemeleri etkinleştirin
Ödeme bağlantısı verdiğiniz bloğun ayarlarına gidin ve düğme ayarlarına geçin:
Ardından düğme ayarlarında "Otomatik Ödemeler" onay kutusunu bulun ve etkinleştirin:
Tüm ödeme düğmelerinde otomatik ödemeleri kabul etmek istiyorsanız, otomatik ödemeleri ödeme sistemi bağlantı ayarlarında etkinleştirebilirsiniz:
Adım 2. Normal bir ödeme yapın.
Ardından, yukarıda açıklandığı gibi normal bir ödeme yapmanız gerekir (ödeme bağlantısı alın ve müşterinin ödemesini sağlayın). Başarılı ödemeden sonra müşteride ödeme kimliği ile robokassa_previous_invoice_id değişkeni görünecektir.
robokassa_previous_invoice_id değişkeni sonraki ödemeler için zorunludur.
Silinirse, bir sonraki otomatik ödeme YAPILAMAZ.
Dikkat edin!\
****"Test Modunda Ödemeler" onay kutusunu devre dışı bırakın (etkinse), aksi takdirde ödeme kimliği ile robokassa_previous_invoice_id değişkeni oluşturulmaz!\
Adım 3. Otomatik tahsilatı planlayın
Başarılı Ödeme bloğundan, zamanlayıcılı bir ok ile otomatik ödeme bloğuna plan yapın. Örnek olarak, bir sonraki ödemeyi 30 gün sonra planlayalım.\
İlgili blokta otomatik ödemenin gerçekleşmesi için Hesap Makinesi alanına robokassa_recurrent_payment fonksiyon çağrısını eklemeniz ve parametreleri belirtilen sırayla iletmeniz gerekir:\
- payment_amount - ödenecek tutar (ruble cinsinden ürün fiyatı)
- description - ürün adı. Bu alanda yalnızca İngilizce veya Rus alfabesi karakterleri, rakamlar ve noktalama işaretleri kullanılabilir. Maksimum uzunluk — 100 karakter. Bu bilgi, Robokassa arayüzünde ve başarılı ödemeden sonra müşterinin aldığı Elektronik Makbuzda görüntülenir.\
- country - alan adı bölgesi ('ru' veya 'kz')
- products_for_receipt - fiş oluşturma parametreleri.
Ayrıntılar "Fişleştirme isteği nasıl oluşturulur -> get_robokassa_payment_url ve robokassa_recurrent_payment fonksiyonları için bölümünde
- taxation - vergilendirme sistemi.\
Ayrıntılar "Fişleştirme isteği nasıl oluşturulur -> get_robokassa_payment_url ve robokassa_recurrent_payment fonksiyonları için bölümünde
Otomatik ödeme isteği örneği:
Otomatik ödeme yapılırken robokassa ödeme bağlantısı ve payment_sum değişkeni OLMAMALIDIR!
Adım 4. Düzenli tahsilatları planlayın ve otomatik ödemelerden vazgeçme seçeneğini yapılandırın.
Ödemelerin düzenli olarak tekrarlanması için bir döngü planlayın - örneğin 30 gün gecikmeli bir ok.
Otomatik ödemeleri iptal etme seçeneğiniz varsa, bir sonraki ödemenin yapılmaması için müşteriden robokassa_previous_invoice_id değişkenini silmeniz gerekir.
Bunun için Hesap Makinesi alanında değişkeni silin:
robokassa_previous_invoice_id = ""
Otomatik ödemeler etkinken normal ödeme
Otomatik ödemeler etkinse ancak abonelik olmadan (otomatik ödemeler olmadan) bir bağlantı gerekiyorsa, bağlantıyı oluşturmadan önce robokassa_manual_recurrent_disable değişkenini 1 değerine ayarlamanız gerekir.
Hesap Makinesi alanında değişkeni bildirelim:
robokassa_manual_recurrent_disable = 1
Dikkat!\
Otomatik ödemelerdeki geri arama, başarılı ödemelerde gelen geri arama ile aynıdır.\
Geri aramaya nasıl tepki verileceğini "Sonuç nasıl işlenir" bölümünde anlattık.
Robokassa hizmetinin sohbet botlarından talepleri nelerdir?
Robokassa hizmetinin resmi yanıtı:
Ürünü bir pazaryerinde açıklama ve fiyat etiketiyle yerleştirebilir ve botta ödeme alabilirsiniz, açıklama, fiyat etiketi, iletişim bilgileri ve ürün teslimatının/hizmet sunumunun elektronik olduğunu belirten tek sayfalık bir site yapabilirsiniz. Bir pazaryerindeki ürüne veya siteye bağlantımız olmalıdır, çünkü botunuzda ne sattığınızı ve hangi bottan sattığınızı bilemeyiz.
Telegram kanal bağlantısını URL olarak dahil etmiyoruz. Ayrıca site içeriği için gereksinimler: "Site işlevsel olmalı, içerikle doldurulmuş, çalışan dahili bağlantılara sahip olmalı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 özelliklerini ve güncel fiyatı içermelidir.
Sitenizde güncel bilgiler bulunmalıdır: telefon, e-posta, sipariş verme ve teslimat süreleri, ödeme, teslimat ve iade koşulları.
Her site ayrı ayrı değerlendirilir.
Telegram'da Robokassa
RobokassaPaymentTestBot test botunun bağlanması.
- Connect Robokassa Test seçeneğini seçerken kullanıcı RobokassaPaymentTestBot botuna gider.
- Kullanıcı /başlat düğmesine basar.
- Kullanıcı bottan "Mağaza Kimliğini girin" yanıtını alır.
- Robokassa hizmetindeki mağazadan kimliği girmek gerekir.
- Bot, mağazada belirtilen numaraya sms göndererek mağaza sahipliğini onaylamanızı isteyecektir: "*%%%% numarasına SMS gönderildi" burada %%%% - telefon numarasının son 4 hanesi
- Kullanıcı 6 haneli kodu girer.
- Her şey başarılı olursa kullanıcıya şu mesaj gösterilecektir: "@BotName botunu Robokassa'ya başarıyla bağladınız. @BotFather size yeni bir token bildirecek."
- Bundan sonra BotFather'da ödemelerin bağlandığı bir ödeme tokeni belirir.
Canlı bot RobokassaPaymentBot'un bağlanması.
- Connect Robokassa Live seçeneğini seçerken kullanıcı RobokassaPaymentBot botuna gider,
- Kullanıcı /başlat düğmesine basar.
- Kullanıcı bottan "Mağaza Kimliğini girin" yanıtını alır.
- Robokassa hizmetindeki mağazadan kimliği girmek gerekir.
- Bot, mağazada belirtilen numaraya sms göndererek mağaza sahipliğini onaylamanızı isteyecektir: "*%%%% numarasına SMS gönderildi", burada %%%% - telefon numarasının son 4 hanesi
- Kullanıcı 6 haneli kodu girer.
- Her şey başarılı olursa kullanıcıya şu mesaj gösterilecektir: "@BotName botunu Robokassa'ya başarıyla bağladınız. @BotFather size yeni bir token bildirecek."
- Bundan sonra BotFather'da ödemelerin bağlandığı bir ödeme tokeni belirir.
Ödeme sonuçlarının işlenmesi burada açıklanana benzer.