Cara Mengkonfigurasi Robokassa

Mari kita lihat cara menerima pembayaran dalam bot melalui perkhidmatan Robokassa.

  1. Cipta kedai dalam talian dalam akaun Robokassa anda dan nyatakan tetapan teknikal berikut:

Cipta kata laluan ujian dan lakukan persediaan awal dalam mod ujian.

Cara Menyambung Robokassa ke MaviBot

Pergi ke bahagian Pemerolehan dan klik Sambung pada kad Robokassa:

Isi borang dalam tetingkap yang terbuka:

  1. ID Kedai — ID Kedai, yang boleh anda temui dalam tetapan kedai dalam akaun Robokassa anda.
  2. Kata Laluan #1 dan Kata Laluan #2 — urutan unik huruf dan nombor yang dijana.
  3. Kadar VAT — nyatakan kod yang sesuai untuk memindahkan nilai VAT. Medan ini menetapkan kadar cukai dalam daftar tunai. Ia ditentukan secara berasingan untuk setiap jenis produk, tetapi digunakan untuk semua unit produk tertentu bersama-sama.

Nilai yang tersedia:

  • Tiada VAT.
  • VAT pada 0%.
  • VAT pada 5%.
  • VAT dikira pada 12%.
  • VAT dikira pada 16%.

Cara Menjana Pautan Pembayaran

Anda boleh menjana pautan pembayaran dalam blok menggunakan SALAH SATU daripada kaedah yang tersedia:

Butang Pembayaran

Anda boleh menjana pautan pembayaran menggunakan butang dengan fungsi Pembayaran.

Ketahui cara mencipta butang dengan fungsi Pembayaran di sini.

Mari kita semak semua parameter butang yang tersedia.

Parameter Butang Pembayaran Wajib

Untuk menjana pautan pembayaran, nyatakan parameter wajib berikut dalam tetapan butang:

  • Jumlah
  • Nama produk

Jumlah — nyatakan harga produk dalam rubel.

Nama produk — medan ini hanya boleh mengandungi huruf Inggeris atau Rusia, nombor dan tanda baca. Panjang maksimum ialah 100 aksara. Maklumat ini dipaparkan dalam antara muka Robokassa dan dalam resit elektronik yang diterima oleh pelanggan selepas pembayaran berjaya.

JANGAN gunakan tanda petik berganda dalam nama produk. Alih keluar atau gantikan dengan tanda petik tunggal.

Kotak semak pembayaran automatik — membolehkan pembayaran berulang.

Kotak semak pemberitahuan klik — membolehkan penjejakan klik pada pautan pembayaran. Jika didayakan, pemberitahuan tentang klik akan muncul dalam perbualan pelanggan di MaviBot.

Anda boleh mengkonfigurasi logik bot selanjutnya berdasarkan pemberitahuan ini.

Banyak sistem pembayaran menyokong daftar tunai dalam talian berasaskan awan yang diperlukan di bawah Undang-undang Persekutuan No. 54-FZ.

Semak keperluan resit di tapak web penyedia pembayaran pilihan anda untuk mengelakkan masalah dengan pihak berkuasa cukai.

Data Resit

Buka menu Data resit untuk memaparkan parameter resit:

Nama produk — diperlukan untuk menjana resit.

JANGAN gunakan tanda petik berganda dalam nama produk. Alih keluar atau gantikan dengan tanda petik tunggal.

Jumlah dalam rubel — nyatakan jumlah pembayaran berdasarkan kuantiti produk. Jika kuantiti ialah 1, jumlah dalam rubel adalah sama dengan nilai yang dimasukkan dalam medan Jumlah wajib.

Kuantiti — kuantiti atau berat produk. Anda boleh menghantar integer atau nombor perpuluhan menggunakan titik, contohnya:

5

atau

10.3

Pembolehubah Pelanggan Dicipta Secara Automatik Apabila Menggunakan Butang Pembayaran

Sebaik sahaja pengguna menerima blok yang mengandungi butang Pembayaran, pembolehubah pelanggan berikut dicipta secara automatik:

Pembolehubah perkhidmatan pelanggan:

__payments

menyimpan jumlah pembayaran dan pengecam pautan pembayaran yang dijana. Ia diperlukan untuk mengenal pasti webhook yang diterima daripada penyedia pembayaran.

Pembolehubah perkhidmatan __payments TIDAK BOLEH dipadam atau diubah suai.

Pembolehubah pelanggan:

error_payment_button

dicipta jika ralat berlaku semasa menjana butang pembayaran.

Nilai error_payment_button akan mengandungi sama ada teks ralat atau respons ralat yang dikembalikan oleh penyedia pembayaran.

Nilai pembolehubah menjadi semasa selepas pengguna bergerak ke blok seterusnya.

Cara Memproses Keputusan

Sila ambil perhatian

Robokassa menghantar pemberitahuan hanya untuk transaksi yang berjaya melalui URL Keputusan.

Robokassa tidak menyediakan panggilan balik untuk pembayaran yang tidak berjaya.

URL Kegagalan hanyalah halaman pembayaran tidak berjaya yang mana pembayar diarahkan jika ralat berlaku pada halaman pembayaran.

Pembayaran Berjaya

Selepas mengkonfigurasi pembayaran dengan betul dan menjana pautan pembayaran, uji persediaan.

Jika pembayaran berjaya, panggilan balik akan dihantar SECARA AUTOMATIK ke perbualan pelanggan dalam bahagian Pelanggan.

Panggilan balik terdiri daripada:

  • 10 aksara kunci rahsia penyedia pembayaran;
  • perkataan _success;
  • jumlah pembayaran selepas ruang.

Panggilan balik dijana secara automatik. Anda tidak perlu menciptanya sendiri atau memintanya daripada pasukan sokongan penyedia pembayaran.

Contoh:

ovg58keefc_success 2999

Di mana:

  • ovg58keefc — 10 aksara kunci rahsia penyedia pembayaran;
  • _success — hasil pemprosesan permintaan yang menunjukkan pembayaran berjaya;
  • 2999 — jumlah pembayaran.

Pelaksanaan blok:

Panggilan balik:

Panggilan balik penyedia pembayaran TIDAK KELIHATAN kepada pengguna.

Ia hanya dipaparkan dalam bahagian Pelanggan dan boleh dilihat oleh pengendali atau pentadbir.

Contoh Mengkonfigurasi Respons Panggilan Balik

Dalam blok bersyarat, seperti blok Syarat Mula atau blok Bukan keadaan dengan syarat, nyatakan panggilan balik yang diterima selepas pembayaran.

Pilih sama ada Padanan tepat atau Mengandungi kata kunci sebagai jenis padanan.

Selepas pembayaran, pelanggan akan menerima mesej daripada blok yang dikonfigurasikan untuk bertindak balas kepada panggilan balik:

Ralat Jumlah Pembayaran

Jika jumlah yang dinyatakan dalam tetapan butang berbeza daripada jumlah yang dibayar oleh pelanggan, bot akan menerima secara automatik panggilan balik yang terdiri daripada:

  • 10 aksara kunci rahsia penyedia pembayaran;
  • _different_amounts;
  • ID pembayaran unik selepas ruang.

Contoh:

ovg58keefc_different_amounts 123456

Di mana:

  • ovg58keefc — 10 aksara kunci rahsia penyedia pembayaran;
  • _different_amounts — menunjukkan bahawa jumlah yang dibayar berbeza daripada jumlah dalam pautan pembayaran;
  • 123456 — ID pembayaran unik.

Fungsi get_robokassa_payment_url dalam Kalkulator

Anda boleh menjana pautan pembayaran menggunakan fungsi get_robokassa_payment_url dalam blok Kalkulator.

Dalam medan Kalkulator, tetapkan hasil fungsi get_robokassa_payment_url kepada pembolehubah.

Anda boleh memilih nama pembolehubah sendiri. Tangkapan skrin menunjukkan contoh nama pembolehubah.

Pautan pembayaran akan disimpan dalam pembolehubah ini.

Anda boleh memaparkan pembolehubah sebagai pautan dalam mesej atau meletakkannya dalam butang dengan teks seperti Bayar.

Contoh pautan pembayaran:

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

Banyak sistem pembayaran menyokong daftar tunai dalam talian berasaskan awan yang diperlukan di bawah Undang-undang Persekutuan No. 54-FZ.

Semak keperluan resit di tapak web penyedia pembayaran pilihan anda untuk mengelakkan masalah dengan pihak berkuasa cukai.

Kalkulator

Contoh 1:

Penerangan Parameter

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

Parameter Fungsi

Parameter Penerangan
amount Jumlah pembayaran. Nyatakan harga produk dalam rubel. Parameter wajib.
description Nama produk. Medan ini hanya boleh mengandungi huruf Inggeris atau Rusia, nombor dan tanda baca. Panjang maksimum ialah 100 aksara. Maklumat ini dipaparkan dalam antara muka Robokassa dan dalam resit elektronik yang diterima oleh pelanggan selepas pembayaran berjaya. Parameter wajib.
products_for_receipt Parameter penjanaan resit. Baca lebih lanjut di sini.
recurrent Membolehkan pembayaran berulang. Hantar 1 jika pembayaran berulang didayakan, atau None jika ia dinyahdayakan.
currency Kod mata wang tiga huruf. Nilai mesti sepadan dengan ketat dengan parameter yang diterima oleh Robokassa.

USD — dolar AS;
EUR — euro;
KZT — tenge.

Contoh Kod

Contoh 1: Pautan Pembayaran Tanpa Resit

res = get_robokassa_payment_url(100, 'Beli saya')

Contoh 2: Pautan Pembayaran Dengan Resit

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

res = get_robokassa_payment_url(100, 'Beli saya', receipt, '3', 1, 1)

Anda boleh memaparkan pembolehubah sebagai pautan dalam mesej atau meletakkannya dalam butang dengan teks seperti Beli.

Jika blok mengandungi beberapa fungsi pautan pembayaran dan ralat berlaku, nilai ralat akan disimpan dalam pembolehubah:

error_payment_func

Ralat daripada fungsi terakhir dalam Kalkulator akan disimpan.

Selepas mengkonfigurasi pembayaran dengan betul dan menjana pautan pembayaran, uji persediaan.

Cara Menambah Penerangan Pembayaran

Anda boleh menambah penerangan pembayaran dengan menetapkan pembolehubah:

payment_description

Penerangan akan dipaparkan pada borang pembayaran dan pada resit.

Cara Memproses Keputusan

Jika pembayaran berjaya, panggilan balik akan dihantar SECARA AUTOMATIK ke perbualan pelanggan dalam bahagian Pelanggan.

Panggilan balik terdiri daripada:

  • 10 aksara kunci rahsia penyedia pembayaran;
  • _success;
  • jumlah pembayaran selepas ruang.

Panggilan balik dijana secara automatik. Anda tidak perlu menciptanya sendiri atau memintanya daripada pasukan sokongan penyedia pembayaran.

Contoh:

ovg58keefc_success 1500

Di mana:

  • ovg58keefc — 10 aksara kunci rahsia penyedia pembayaran;
  • _success — hasil pemprosesan permintaan yang menunjukkan pembayaran berjaya;
  • 1500 — jumlah pembayaran.

Sila ambil perhatian

Panggilan balik hanya boleh dilihat oleh anda dalam perbualan pelanggan.

Panggilan balik tidak kelihatan kepada pelanggan, tetapi anda boleh mengkonfigurasi respons kepada pembayaran yang berjaya.

Contoh

Tetapan blok menggunakan fungsi get_robokassa_payment_url:

1. Memaparkan Pautan dalam Teks Mesej

Penting

Pautan pembayaran adalah unik. Anda tidak boleh menyalinnya dan menghantarnya kepada pelanggan lain.

Hantar pautan pembayaran melalui pembolehubah dalam bot.

Panggilan balik selepas pembayaran berjaya:

2. Memaparkan Pautan dalam Butang

Pelaksanaan blok:

Panggilan balik selepas pembayaran berjaya: