Robokassa-ны қалай конфигурациялау керек

Робокасса қызметі арқылы ботта төлемдерді қалай қабылдау керектігін қарастырайық.

  1. Robokassa тіркелгіңізде интернет-дүкен жасаңыз және келесі техникалық параметрлерді көрсетіңіз:

Сынақ құпия сөздерін жасаңыз және бастапқы орнатуды сынақ режимінде орындаңыз.

Robokassa-ны MaviBot-қа қалай қосу керек

Acquiring бөліміне өтіп, Robokassa картасында Қосу түймесін басыңыз:

Ашылған терезедегі пішінді толтырыңыз:

  1. Store ID — Дүкен идентификаторы, оны Robokassa тіркелгіңіздегі дүкен параметрлерінен таба аласыз.
  2. Құпия сөз №1 және Құпия сөз №2 — әріптер мен сандардың бірегей жасалған тізбектері.
  3. ҚҚС мөлшерлемесі — ҚҚС мәнін беру үшін сәйкес кодты көрсетіңіз. Бұл өріс кассадағы салық мөлшерлемесін орнатады. Ол өнімнің әрбір түрі үшін жеке анықталады, бірақ сол нақты өнімнің барлық бірліктеріне қолданылады.

Қолжетімді мәндер:

  • ҚҚС жоқ.
  • 0% ҚҚС.
  • 5% ҚҚС.
  • 12% есептелген ҚҚС.
  • 16% есептелген ҚҚС.

Төлем сілтемесін қалай жасау керек

Блокта төлем сілтемесін КЕЛЕСІ әдістердің БІРІН пайдаланып жасауға болады:

Төлем түймесі

Төлем функциясы бар түймені пайдаланып төлем сілтемесін жасауға болады.

Төлем функциясы бар түймені қалай жасау керектігін мына жерден біліңіз.

Барлық қолжетімді түйме параметрлерін қарастырайық.

Төлем түймесінің міндетті параметрлері

Төлем сілтемесін жасау үшін түйме параметрлерінде келесі міндетті параметрлерді көрсетіңіз:

  • Сома
  • Өнім атауы

Сома — өнім бағасын рубльмен көрсетіңіз.

Өнім атауы — бұл өрісте тек ағылшын немесе орыс әріптері, сандар және тыныс белгілері болуы мүмкін. Ең ұзындығы 100 таңба. Бұл ақпарат Robokassa интерфейсінде және төлем сәтті аяқталғаннан кейін клиент алатын электрондық чекте көрсетіледі.

Өнім атауында ҚОС ТЫРНАҚШАНЫ пайдаланбаңыз. Оларды алып тастаңыз немесе жалғыз тырнақшамен ауыстырыңыз.

Автоматты төлем құсбелгісі — қайталанатын төлемдерді қосады.

Басу туралы хабарландыру құсбелгісі — төлем сілтемесін басуларды бақылауды қосады. Қосылған болса, MaviBot-тағы клиент әңгімесінде басу туралы хабарландыру пайда болады.

Осы хабарландыру негізінде боттың одан әрі логикасын конфигурациялауға болады.

Көптеген төлем жүйелері №54-ФЗ Федералдық заңына сәйкес талап етілетін бұлтты онлайн-кассаларды қолдайды.

Салық органдарымен проблемаларды болдырмау үшін таңдалған төлем провайдерінің веб-сайтындағы чек талаптарын қарап шығыңыз.

Чек деректері

Чек параметрлерін көрсету үшін Чек деректері мәзірін ашыңыз:

Өнім атауы — чек жасау үшін қажет.

Өнім атауында ҚОС ТЫРНАҚШАНЫ пайдаланбаңыз. Оларды алып тастаңыз немесе жалғыз тырнақшамен ауыстырыңыз.

Рубльдегі жалпы сома — өнім санына негізделген жалпы төлем сомасын көрсетіңіз. Егер саны 1 болса, рубльдегі жалпы сома міндетті Сома өрісіне енгізілген мәнге тең.

Саны — өнімнің саны немесе салмағы. Нүкте арқылы бүтін немесе ондық санды бере аласыз, мысалы:

5

немесе

10.3

Төлем түймесін пайдаланған кезде автоматты түрде жасалатын клиент айнымалылары

Пайдаланушы Төлем түймесі бар блокты алғаннан кейін келесі клиент айнымалылары автоматты түрде жасалады:

Қызметтік клиент айнымалысы:

__payments

төлем сомасын және жасалған төлем сілтемесінің идентификаторын сақтайды. Ол төлем провайдерінен алынған вебхукты анықтау үшін қажет.

__payments қызметтік айнымалысын ЖОЮҒА НЕМЕСЕ ӨЗГЕРТУГЕ БОЛМАЙДЫ.

Клиент айнымалысы:

error_payment_button

төлем түймесін жасау кезінде қате орын алса жасалады.

error_payment_button мәні қате мәтінін немесе төлем провайдері қайтарған қате жауабын қамтиды.

Айнымалы мәндері пайдаланушы келесі блокқа ауысқаннан кейін өзекті болады.

Нәтижені қалай өңдеу керек

Назар аударыңыз

Robokassa Нәтиже URL арқылы тек сәтті транзакциялар туралы хабарландыруларды жібереді.

Robokassa сәтсіз төлемдер үшін кері қоңырауларды (callback) қамтамасыз етпейді.

Сәтсіз URL — бұл төлем бетінде қате орын алса, төлеуші қайта бағытталатын сәтсіз төлем беті ғана.

Сәтті төлем

Төлемді дұрыс конфигурациялап, төлем сілтемесін жасағаннан кейін, орнатуды сынап көріңіз.

Егер төлем сәтті болса, Клиенттер бөліміндегі клиент әңгімесіне АВТОМАТТЫ ТҮРДЕ кері қоңырау (callback) жіберіледі.

Кері қоңырау мыналардан тұрады:

  • төлем провайдерінің құпия кілтінің 10 таңбасы;
  • _success сөзі;
  • бос орыннан кейінгі төлем сомасы.

Кері қоңырау автоматты түрде жасалады. Оны өзіңіз жасаудың немесе төлем провайдерінің қолдау қызметінен сұраудың қажеті жоқ.

Мысал:

ovg58keefc_success 2999

Мұндағы:

  • ovg58keefc — төлем провайдерінің құпия кілтінің 10 таңбасы;
  • _success — сәтті төлемді көрсететін сұрауды өңдеу нәтижесі;
  • 2999 — төлем сомасы.

Блоктың орындалуы:

Кері қоңырау:

Төлем провайдерінің кері қоңыраулары пайдаланушыға КӨРІНБЕЙДІ.

Олар тек Клиенттер бөлімінде көрсетіледі және операторға немесе әкімшіге көрінеді.

Кері қоңырауға жауапты конфигурациялау мысалы

Шартты блокта, мысалы, Бастау шарты блогында немесе Шарты бар күйсіз блокта, төлемнен кейін алынған кері қоңырауды көрсетіңіз.

Сәйкестік түрі ретінде Нақты сәйкестік немесе Кілт сөздерді қамтиды таңдаңыз.

Төлемнен кейін клиент кері қоңырауға жауап беру үшін конфигурацияланған блоктан хабарлама алады:

Төлем сомасының қатесі

Егер түйме параметрлерінде көрсетілген сома клиент төлеген сомадан өзгеше болса, бот автоматты түрде келесіден тұратын кері қоңырауды алады:

  • төлем провайдерінің құпия кілтінің 10 таңбасы;
  • _different_amounts;
  • бос орыннан кейінгі бірегей төлем идентификаторы.

Мысал:

ovg58keefc_different_amounts 123456

Мұндағы:

  • ovg58keefc — төлем провайдерінің құпия кілтінің 10 таңбасы;
  • _different_amounts — төленген соманың төлем сілтемесіндегі сомадан өзгеше екенін көрсетеді;
  • 123456 — бірегей төлем идентификаторы.

Калькулятордағы get_robokassa_payment_url функциясы

Калькулятор блогында get_robokassa_payment_url функциясын пайдаланып төлем сілтемесін жасауға болады.

Калькулятор өрісінде get_robokassa_payment_url функциясының нәтижесін айнымалыға тағайындаңыз.

Айнымалы атауын өзіңіз таңдай аласыз. Скриншоттарда айнымалы атауларының мысалдары көрсетілген.

Төлем сілтемесі осы айнымалыда сақталады.

Айнымалыны хабарламада сілтеме ретінде көрсетуге немесе Төлеу сияқты мәтіні бар түймеге орналастыруға болады.

Төлем сілтемесінің мысалы:

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

Көптеген төлем жүйелері №54-ФЗ Федералдық заңына сәйкес талап етілетін бұлтты онлайн-кассаларды қолдайды.

Салық органдарымен проблемаларды болдырмау үшін таңдалған төлем провайдерінің веб-сайтындағы чек талаптарын қарап шығыңыз.

Калькулятор

1-мысал:

Параметрлердің сипаттамасы

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

Функция параметрлері

Параметр Сипаттамасы
amount Төлем сомасы. Өнім бағасын рубльмен көрсетіңіз. Міндетті параметр.
description Өнім атауы. Бұл өрісте тек ағылшын немесе орыс әріптері, сандар және тыныс белгілері болуы мүмкін. Ең ұзындығы 100 таңба. Бұл ақпарат Robokassa интерфейсінде және төлем сәтті аяқталғаннан кейін клиент алатын электрондық чекте көрсетіледі. Міндетті параметр.
products_for_receipt Чек жасау параметрлері. Толығырақ мына жерде.
recurrent Қайталанатын төлемдерді қосады. Қайталанатын төлемдер қосылған болса 1 мәнін, ал қосылмаған болса None мәнін беріңіз.
currency Үш әріпті валюта коды. Мән Robokassa қабылдайтын параметрлерге қатаң сәйкес келуі керек.

USD — АҚШ доллары;
EUR — еуро;
KZT — теңге.

Код мысалдары

1-мысал: Чексіз төлем сілтемесі

res = get_robokassa_payment_url(100, 'Buy me')

2-мысал: Чекпен төлем сілтемесі

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

res = get_robokassa_payment_url(100, 'Buy me', receipt, '3', 1, 1)

Айнымалыны хабарламада сілтеме ретінде көрсетуге немесе Сатып алу сияқты мәтіні бар түймеге орналастыруға болады.

Егер блокта бірнеше төлем сілтемесі функциялары болса және қате орын алса, қате мәні айнымалыда сақталады:

error_payment_func

Калькулятордағы соңғы функцияның қатесі сақталады.

Төлемді дұрыс конфигурациялап, төлем сілтемесін жасағаннан кейін, орнатуды сынап көріңіз.

Төлем сипаттамасын қалай қосу керек

Айнымалыны орнату арқылы төлем сипаттамасын қосуға болады:

payment_description

Сипаттама төлем формасында және чекте көрсетіледі.

Нәтижені қалай өңдеу керек

Егер төлем сәтті болса, Клиенттер бөліміндегі клиент әңгімесіне АВТОМАТТЫ ТҮРДЕ кері қоңырау (callback) жіберіледі.

Кері қоңырау мыналардан тұрады:

  • төлем провайдерінің құпия кілтінің 10 таңбасы;
  • _success;
  • бос орыннан кейінгі төлем сомасы.

Кері қоңырау автоматты түрде жасалады. Оны өзіңіз жасаудың немесе төлем провайдерінің қолдау қызметінен сұраудың қажеті жоқ.

Мысал:

ovg58keefc_success 1500

Мұндағы:

  • ovg58keefc — төлем провайдерінің құпия кілтінің 10 таңбасы;
  • _success — сәтті төлемді көрсететін сұрауды өңдеу нәтижесі;
  • 1500 — төлем сомасы.

Назар аударыңыз

Кері қоңырау клиент әңгімесінде тек сізге ғана көрінеді.

Кері қоңырау клиентке көрінбейді, бірақ сіз сәтті төлемге жауапты конфигурациялай аласыз.

Мысал

get_robokassa_payment_url функциясын пайдаланатын блоктың параметрлері:

1. Сілтемені хабарлама мәтінінде көрсету

Маңызды

Төлем сілтемесі бірегей. Оны көшіріп, басқа клиенттерге жіберуге болмайды.

Төлем сілтемесін боттағы айнымалы арқылы жіберіңіз.

Сәтті төлемнен кейінгі кері қоңырау:

2. Сілтемені түймеде көрсету

Блоктың орындалуы:

Сәтті төлемнен кейінгі кері қоңырау: