Қалай қосу керек
bePaid төлем жүйесін қосу үшін сізге Дүкен ID, құпия кілт және ашық кілт қажет. Оларды алғаннан кейін MaviBot баптауларына көшеміз.
MaviBot-та "Эквайринг" бөлімін ашып, bePaid таңдаңыз. Алынған деректерді енгізу қажет.
Соңғы өріс пайдалану еліне байланысты API хостингінің ауыстырғышы екенін ескеріңіз: Беларусь немесе Ресей.
Төлем сілтемесін қалай құру керек
Төлем сілтемесін жасау үшін payment_sum айнымалысының мәнін орнату қажет (мысалы 150 немесе 100.55 (нүкте арқылы!)), осыдан кейін бірден bepaid_pay_url айнымалысы пайда болады. Бұл айнымалыны экранға сілтеме ретінде шығаруға немесе "Төлеу" мәтіні бар батырмаға орналастыруға болады.
Сілтеме келесідей көрінеді:
https://checkout.bepaid.by/widget/hpp.html?token=a05eabd3f9368725efbc175614c7d469da08f198cc51916b07fb75e53f9a3e1a
Сондай-ақ, payment_sum айнымалысының мәнін орнатпас бұрын, төлемді баптау үшін келесі міндетті емес айнымалыларды орнатуға болады.
Әдепкі бойынша Беларусь рублі орнатылған, егер басқа валюта қажет болса, currency айнымалысының мәнін орнату керек
Төлем аяқталғаннан кейін клиентке жасалған операция бойынша төлем жүйесінің жауап деректерін қамтитын bepaid_callback_data айнымалысы қосылады. Алынған сөздіктен get әдісі арқылы қажетті деректерді алуға болады.
Төлемдерді қалай тестілеу керек
Сынақ төлемін жүргізу үшін payment_sum айнымалысын көрсетпес бұрын, test_payments айнымалысын кез келген мәнмен орнату керек.
Ботты жауынгерлік режимде іске қосқанда оны алып тастауды ұмытпаңыз!
Тестілеуге арналған карталар:
4200000000000000 success
4005550000000019 failed
Егер бірдеңе жұмыс істемесе, деректерді ресми сайттағы деректермен салыстырыңыз: https://docs.bepaid.by/ru/test-integration#test-card-number
Төлем сілтемесін құру мысалы
100 беларусь рублі мөлшерінде төлем сілтемесін жасайық (әдепкі валюта)
Назар аударыңыз, алдымен баптаулар үшін қосымша айнымалыларды, содан кейін payment_sum орнатамыз. Айнымалыларды бір блокта емес, тізбекте бұрын да орнатуға болады, бұл мысал.
Әрі қарай қажетті жерде сілтемесі бар bepaid_pay_url айнымалысын шығарамыз
Жазылымдарды басқару
Төлем жүйесінің интеграциясы клиенттеріңіз үшін жазылымдар жасау мүмкіндігін береді.
MaviBot функционалын қолданар алдында, bePaid жеке кабинетінде жазылым жоспарын жасаңыз.
Егер жеке кабинетте "Жоспарлар" және "Жазылымдар" мәзірі көрсетілмесе, менеджеріңізге хабарласыңыз.
Жазылымды құру және төлем сілтемесін алу
get_bepaid_subscription_url функциясын қолданыңыз, оған plan_id параметрін беріңіз, мұнда
Орындау нәтижесінде функция жазылымды жасап, оны төлеуге сілтемені қайтарады.
Сілтемені клиентке жіберіп, төлемнің аяқталуын күтіңіз.
Төлем сәтті болған кезде, жазылым белсендіріледі, мәмілеге bepaid_subscription_id және bepaid_subscription_status айнымалылары қосылады, ал ботқа коллбэк келеді ("Нәтижені қалай өңдеу керек" бөлімін қараңыз).
Жазылым туралы ақпарат алу
Клиенттің ағымдағы жазылымының деректерін алу үшін get_bepaid_subscription_info функциясын шақырыңыз, оған subscription_id параметрін беріңіз (мәнді bepaid_subscription_id айнымалысынан алуға болады).
Жазылымды болдырмау
Жазылымды болдырмау үшін cancel_bepaid_subscription функциясын қолданыңыз.
Бұл функция жалғыз subscription_id параметрін қабылдайды (мәнді bepaid_subscription_id айнымалысынан алуға болады).
Сәтті болдырмау кезінде bepaid_subscription_status айнымалысы “canceled” мәнін қабылдайды, ал ботқа коллбэк келеді ("Нәтижені қалай өңдеу керек" бөлімін қараңыз).
Жазылым күйлері
Рекуррентті төлемдер
Сондай-ақ, bePaid жеке кабинетінде жоспар жасамай-ақ жазылым жүйесін ұйымдастыруға болады.
Ол үшін сізге клиенттің карта токені қажет.
Карта токенін алу үшін клиент payment_sum арқылы жасалған сілтеме бойынша орнату төлемін жасауы керек.
payment_sum мәнін орнатпас бұрын, bepaid_contract айнымалысын орнатыңыз, онда токен бойынша болашақ төлемдердің мақсатын көрсетіңіз: “recurring” берілген мерзімділікпен тұрақты төлемдер үшін немесе “card_on_file” тұрақты емес төлемдер үшін (мысалы, көрсетілген қызмет үшін кейінгі төлем).
“card_on_file” опциясы барлық эквайерлермен қолданылмайды. Егер оны қолданғыңыз келсе, аккаунт менеджеріңізге хабарласыңыз.
Сәтті төлемнен кейін мәмілеге bepaid_client_card_token айнымалысы қосылады, онда клиенттің карта токені сақталады. Бұл токен клиенттің қатысуынсыз оның картасынан ақшаны есептен шығаруға мүмкіндік береді.
Содан кейін воронканы баптаңыз және автоматты есептен шығару үшін күнді немесе шартты орнатыңыз және make_bepaid_token_payment калькулятор функциясын шақырыңыз, оған қажетті параметрлерді беріңіз.
Параметрлердің реттілігі:
amount -> currency -> description -> contract
Параметрлердің сипаттамасы:
contract мәні орнату төлеміне сілтеме жасау кезінде көрсетілген мәнге сәйкес келуі керек!
Егер төлем сәтті өтсе, функция “bePaid токені бойынша сәтті есептен шығару” хабарын қайтарады, сіз сәтті төлем туралы коллбэк аласыз, ал мәміленің bepaid_token_payment_completed айнымалысы “True” мәнін қабылдайды.
Егер төлем өтпесе, функция сәтсіз төлемнің себебін көрсететін хабарды қайтарады, ботқа “_fail” жұрнағы бар коллбэк келеді, ал мәміленің bepaid_token_payment_completed айнымалысы “False” мәнін қабылдайды.
Банк клиенттен төлемді аяқтауды сұрауы мүмкін. Бұл жағдайда функция 3-D Secure аутентификациясынан өту сұрауы бар сілтемені қайтарады.
Нәтижені қалай өңдеу керек
Клиенттің әрекеттеріне жауап ретінде ботқа құпия кілттің алғашқы 20 таңбасынан және операция түрі мен нәтижесіне байланысты жұрнақтан тұратын коллбэктер келеді.
Жүйеде коллбэк пайдаланушыдан келген хабарлама ретінде көрінеді, бірақ пайдаланушының өзі оны көрмейді.
Төлемдер үшін
Жазылымға қатысы жоқ төлем нәтижесінде сізге келесі хабарламалардың бірі келеді:
номерКлюча_success - сәтті төлем кезінде;
номерКлюча_fail - сәтсіз төлем кезінде;
Соңғы төлемнің күйін bepaid_payment_completed (клиенттің қатысуымен жасалған төлемдер үшін) және bepaid_token_payment_completed (карта токені бойынша акцептсіз төлемдер үшін) айнымалылары арқылы да бақылауға болады.
Жазылымдар үшін
Бірінші немесе қайталанатын төлем кезінде жазылым сәтті белсендірілгеннен кейін ботқа номерКлюча_success хабары келеді.
Егер жазылым болдырылса, сіз номерКлюча_canceled аласыз.
Жазылым бойынша төлем сәтсіз болған жағдайда, сізге номерКлюча**_fail** хабары келеді.