Модуль данейта «Дойка»

Рашэнне для прыёма грашовых ахвяраванняў на рахункі грамадскіх арганізацый праз банкаўскія карткі (метадам эквайрынгу).

Модуль у першую чаргу створаны для некамерцыйныя грамадскіх арганізацый, якія маюць грашовы рахунак і ўласны сайт ці старонку, якая ўтрымлівае інфармацыю пра арганізацыю.

Модуль падтрымлівае плацёжныя сістэмы:

Visa
Mastercard
БелКарт

Сістэмныя патрабаванні

Сэрвернае асяроддзе сумяшчальнае з Laravel версіі 5.4.*
Старонка выкарыстоўвае пратакол HTTPS (для забеспячення бяспекі плацежных дадзенных).

Усталяванне

Аўтаматычнае

Запампоўваем у корань сайта змесціва архіва https://github.com/diglabby/doika_1.2/archive/master.zip
Адкрываем {your_site}/install-doika.php
Дзейнічаем згодна з інфармацыяй на экране

Уручную (для распрацоўшчыкаў)

Заходзім у рэпазіторый https://github.com/diglabby/doika_1.2.git і ствараем для сябе fork
Дадаем змесціва fork рэпазіторыя ў корань вашага сайта з дапамогай git clone. Пераключаемся на branch, з якой плануем працаваць з дапамогай git checkout (напрыклад, git checkout dev)
Імпартуем файл doika.sql у базу дадзеных. Можна выкарыстоўваць існуючую базу дадзенных ці стварыць новую спецыяльна для модуля
Рыхтуем канфіг файл. Для гэтага ў тэчцы doika ствараем копію файла .env.example і надаем яму імя .env
Дадаем у файл .env свае дадзеныя DB_DATABASE={your_database} DB_USERNAME={your_username} DB_PASSWORD={your_password}

Канфігурацыя

Перш за ўсё неабходна залагініцца. Адкрываем {your_site}/doika, дзе {your_site} адрас вашага сайта. Дадзенныя для ўвахода: e-mail адрэс sample@sample.com пароль 123456. Пасля ўвахода можна змяніць гэтыя дадзенныя на свае ў раздзеле "Канфігурацыя модуля" {your_site}/doika/show-configurations
Далей неабходна стварыць кампанію па збору сродкаў. Заходзім па адрасе {your_site}/doika/create. Запаўняем патрэбныя дадзеныя і захоўваем кампанію
Вяртаемся на Галоўную {your_site}/doika/show-list, націскаем на неабходную кампанію для рэдагавання
Капіруем змесціва поля Шорткод, устаўляем яго ў html-код ў тое месца сваей старонкі, дзе будзе адлюстроўвацца модуль
Завяршальны крок. Падключаем бібліятэку модуля. На старонцы з модулем у html-кодзе ў блоку неабходна размясціць <script src="client-side/doika-loader.js"></script>. Захоўваем файл.
Ідзем на {your_site} праз браўзер, знаходзім старонку, дзе ўсталяваны модуль і перагружаем яе кантрольна CTRL+SHIFT+R
Модуль гатовы для выкарыстання.

Падключаем магчымасць рабіць тэставыя плацяжы

Каб пераключыцца ў тэставы рэжым заходзім на старонку канфігурацыі {your_site}/doika/show-configurations і адзначаем "Падключыць тэставыя плацяжы". Захоўваем змены. Гэта жа можна зрабіць з дапамогай mysql каманды UPDATE doika_configurations SET configuration_value='1' WHERE configuration_name='is_test'; Каб выйсці з тэставага рэжыму трэба ўстанавіць замест "1" любое іншае значэнне, напрыклад "0"
Заходзім на старонку канфігурацыі {your_site}/doika/show-configurations і правяраем ці запаўнены тэставымі дадзеннымі наступныя ячэйкі IdMarket=363 KeyMarket=4f585d2709776e53d080f36872fd1b63b700733e7624dfcadd057296daa37df6. Калі Вы ўжо маеце свае асабістыя дадзенныя IdMarket і KeyMarket (Secret Key), калі ласка, выкарыстоўвайце іх.
Вяртаемся на старонку з модулем і спрабуем зрабіць тэставы плацеж, выкарыстоўваючы наступныя дадзеныя: нумар карты 4200000000000000 перадае паведамленне аб паспяховым плацяжу, нумар карты 4005550000000019 перадае паведамленне ад адхіленні плацяжу банкам, любы іншы нумар карты перадае паведамленне аб тэхнічным збоі.

Карысная інфармацыя

Дакументацыя для распрацоўшчыкаў на wiki https://github.com/diglabby/doika_1.2/wiki
Працэсінгавая сістэма BePaid https://docs.bepaid.by/ru/introduction

Tyuba4/doika_1.2