====== Revolut ======

[[billing:preferences:payment_system:payment_system|Вернуться на уровень выше]]

{{:billing:preferences:payment_system:revolut.png?100|}}

[[https://www.revolut.com]]

===== Настройка Revolut =====
Необходимо создать приватный и публичный ключи:

<code>
openssl genrsa -out revolut_privat.pem 2048
openssl req -new -x509 -key revolut_privat.pem -out revolut_public.cer -days 1825
</code>

При создании публичного ключа Вас попросят заполнить некоторую информацию:

<code>
Country Name (2 letter code) []:
State or Province Name (full name) []: 
Locality Name (eg, city) []:
Organization Name (eg, company) []:
Organizational Unit Name (eg, section) []:
Common Name (eg, fully qualified host name) []:
Email Address []:
</code>

Можете заполнить или оставить эти поля пустыми

----

\\ Войдите в **Revolut Business portal**, перейдите в раздел **Settings > Business API**.
{{:billing:preferences:payment_system:revolut_biz_settings1.jpg?400|}}
{{:billing:preferences:payment_system:revolut_biz_settings2.jpg?400|}}

\\ Нажмите **Add certificate**.
{{:billing:preferences:payment_system:revolut_biz_settings3.jpg?400|}}

\\ Вставьте содержимое **revolut_public.cer** в поле **X509 public key**.
{{:billing:preferences:payment_system:revolut_biz_settings4.jpg?400|}}

\\ Укажите **OAuth redirect URI** как <nowiki>https://admin.mikbill.pro/json/index/revolutoauth</nowiki>
<alert type="warning">Замените admin.mikbill.pro на адрес своей админки</alert>
Нажмите **Continue**.
{{:billing:preferences:payment_system:revolut_biz_settings5.jpg?400|}}

\\ Вас перебросит на страницу **API Certificate** где нужно будет скопировать **ClientID**.
{{:billing:preferences:payment_system:revolut_biz_settings6.jpg?400|}}

===== Настройка MikBill =====

Для настройки в админ. панели открываем: **Настройки => Прием платежей**, вкладка **Платёжные системы (новые)**

{{:billing:preferences:payment_system:revolut_systemoptions.jpg?500|}}

\\ Нужно включить модуль, (на время настройки еще включить **логирование запросов**)
\\ Ввести ID клиента из **Revolut Business portal** раздела **API Certificate**
\\ Указать **domain** как адрес админки **БЕЗ** <nowiki>/ в конце и http:// или https:// в начале</nowiki>
\\ Ввести содержимое revolut_privat.pem
\\ Всё, настройка закончена.

===== Активация API =====

\\ Войдите в **Revolut Business portal** и перейдите в **Business API** настройки.
{{:billing:preferences:payment_system:revolut_biz_settings1.jpg?400|}}
{{:billing:preferences:payment_system:revolut_biz_settings2.jpg?400|}}

\\ Выберите ранее созданный сертификат и нажмите **Enable access**.
{{:billing:preferences:payment_system:revolut_biz_settings7.jpg?400|}}

\\ Нажмите **Authorise**. Это запустит 2-factor authentication (2FA) process.
{{:billing:preferences:payment_system:revolut_biz_settings8.jpg?400|}}
{{:billing:preferences:payment_system:revolut_biz_settings9.jpg?400|}}

\\ После успешного прохода 2FA вас перекинет на указанный в **OAuth** url админки где вы должны будете увидеть сообщение **OAuth has been successfully refreshed.**
\\ После чего API считается активированным и можно начинать работу

===== Импорт платежей =====

Выгрузка платежей происходит путем запуска консольной команды **revolut_import**

==== Тестовая выгрузка ====

Для проведения тестовой выгрузки можно запустить команду **revolut_import** с параметром **dryRun**
<code>
cd /var/www/mikbill/admin
php index.php revolut_import dryRun
</code>

\\ Данный параметр укажет что выгруженные платежи не нужно зачислять абонентам. Это позволит оценить правильность выгрузки и скорректировать алгоритм в случаи ошибок.
\\ После того как в импорте платежей не будет ошибок, можно очистить все платежи командой **revolut_flush** и запускать уже импорт в боевом режиме.
<code>
cd /var/www/mikbill/admin
php index.php revolut_flush
</code>

==== Production выгрузка ====

<code>
cd /var/www/mikbill/admin
php index.php revolut_import
</code>