Просмотр исходного текста страницы Интеграция с платежными сервисами

Доступна интеграция со следующими сервисами:
* PimPay — финансирование для интернет-магазинов;
* Robokassa — онлайн-оплата заказов и мобильный эквайринг;
* Payme — онлайн-оплата заказов и мобильный эквайринг. Работает в Узбекистане;
* Assist — мобильный эквайринг;
* ibox — мобильный эквайринг.

Сервисы настраиваются в [[Личный кабинет курьерской службы#Финансы|личном кабинете курьерской службы]].

= PimPay =
Чтобы начать работать с [https://pimpay.ru/ Pimpay]:
# Зарегистрируйтесь [http://platform.api.pimpay.ru/site/register в сервисе]. Далее Pimpay активирует вашу учетную запись.
# Cгенерируйте ключи шифрования. Это делается на [http://platform.api.pimpay.ru/v2_7/signature/openssl UNIX-подобной системе] или с помощью <rspoiler text="нашей инструкции">Чтобы получить приватный ключ, в командной строке выполните следующие команды:<br><br><code>openssl genrsa -out private.pem 2048</code> <br><br><code>openssl rsa -in private.pem -outform PEM -pubout -out public.pem</code><br><br>В результате вы получите 2 файла: public.pem и private.pem.<br>Содержимое файла public.pem — ваш публичный ключ. Скопируйте его целиком и вставьте в личном кабинете PimPay.<br>Содержимое файла private.pem скопируйте и вставьте в настройках интеграции с PimPay в личном кабинете курьерской службы.</rspoiler>. Если у вас нет специалиста, чтобы сгенерировать ключи, обратитесь за помощью в PimPay.
# В личном кабинете курьерской службы в разделе '''Управление ЛК''' > '''Параметры''' > '''Финансы''' заполните настройки Pimpay данными из личного кабинета Pimpay. Сохраните настройки.
# Зарегистрируйте каждого клиента, который хочет передавать данные в PimPay, в личном кабинете PimPay.
# В MeaSoft в карточке каждого клиента на [[Клиенты и партнеры#Финансы|вкладке '''Финансы''']] выберите платежного посредника '''PimPay'''.

При передаче данных привязка клиентов между системами производится по ИНН.

В результате MeaSoft передает все заказы вашего клиента, их статусы и созданные [[Акты Передачи Денег и корреспонденции#Акты передачи денег (АПД)|АПД]] в PimPay. PimPay ничего не передает в ответ.

Чтобы платежи в банк по АПД выгружались в адрес PimPay, создайте клиента с названием «PIMPAY» и заполните его реквизиты.

= Robokassa =

Сервис позволяет принимать онлайн-платежи на странице отслеживания заказа или при [[Мобильное приложение курьера для Android#Robokassa|оплате картой курьеру]].

Чтобы настроить прием платежей через сервис Robokassa:
# Зарегистрируйтесь в сервисе [https://partner.robokassa.ru/Reg Robokassa].
# В <rspoiler text="настройках личного кабинета курьерской службы">'''Управление ЛК''' > '''Параметры''' > '''Финансы''' > '''Настройки эквайринга'''. Подробнее см. раздел [[Личный кабинет курьерской службы#Финансы|«Финансы»]].</rspoiler> введите идентификатор магазина и пароли из личного кабинета Robokassa.
# Установите флажок '''Тестовый режим''' и нажмите на кнопку '''Сохранить'''.
# Откройте [[Личный кабинет курьерской службы#Отслеживание заказа по номеру|страницу отслеживания]] любого заказа с наложенным платежом и оплатой картой и убедитесь, что появилась кнопка '''Оплатить картой'''.	
# Нажмите на кнопку '''Оплатить картой'''. В следующем окне нажмите на кнопку '''Оплатить картой в тестовом режиме'''. Откроется окно оплаты Robokassa.
# Если в пунктах 4-5 обнаружены ошибки, проверьте правильность введенных учетных данных Robokassa в личном кабинете курьерской службы.
# Если пункты 4-5 пройдены без ошибок, в настройках личного кабинета курьерской службы снимите флажок '''Тестовый режим''' и нажмите на кнопку '''Сохранить'''.

В результате курьер может принять оплату картой по QR-коду или получатель может оплатить заказ онлайн на странице отслеживания https://home.courierexe.ru/XX/tracking, где XX — код вашей курьерской службы:

[[Файл:Robokassa.png|none|900 px]]

При успешной оплате заказ в MeaSoft отмечается как оплаченный.

В окне отслеживания в поле '''Наложенный платеж''' статус заказа изменится на '''Заказ оплачен'''. Чек по операции придет на электронную почту, указанную при заказе.

= Assist =
Чтобы настроить прием платежей через сервис Assist:
# Заключите договор с [https://www.assist.ru/o-podklyuchenii/ Assist] и установите мобильное приложение Assist mPOS.
# В [[Мобильное_приложение_курьера_для_Android#Assist|мобильном приложении]] MeaSoft App нажмите на кнопку '''Еще''', выберите пункт '''Настройки''' и в поле '''Параметры эквайринга''' выберите значение '''Assist mPOS'''.
# Рядом со значением '''Assist mPOS''' появится кнопка [[Файл:Assist настройки.png|25 px]]. Нажмите на нее, введите <rspoiler text="PIN-код"> В личном кабинете курьерской службы в пункте основного меню '''Телефоны''' > [[Личный кабинет курьерской службы#Курьерские устройства|Курьерские устройства]] откройте карточку курьера и скопируйте значение поля '''PIN-код POS-терминала'''.</rspoiler> и нажмите на кнопку '''Проверить'''.
# В окне «Настройки Assist» укажите логин, пароль и ИД магазина согласно вашим учетным данным Assist и нажмите на кнопку '''Сохранить'''.

В результате из мобильного приложении MeaSoft при проведении оплаты картой будет совершаться переход в мобильное приложение Assist mPOS. Вы можете выбрать способ проведения оплаты:
* картой через терминал;
* QR-код для считывания мобильным банковским приложением покупателя (СБП);
* наличными.

Чек по операции придет на электронную почту, указанную при заказе.

= ibox =
Мобильный эквайринг ibox доступен через приложение или <rspoiler text="SDK">SDK — это средства разработки, которые позволяют приложению MeaSoft взаимодействовать с POS-терминалом напрямую.</rspoiler>. Подробнее см. раздел «[[Мобильное приложение курьера для Android#ibox|ibox]]».

Для подтверждения успешной транзакции или отмены оплаты MeaSoft получает обратные вызовы (вебхуки) от ibox:
* при успешной оплате после установки статуса корреспонденции со слов курьера '''Доставлено''' или '''Частично доставлено''' в MeaSoft на вкладке '''Выдача''' подсвечивается поле '''Тип оплаты''':
** зеленым цветом, если оплата картой, есть идентификатор транзакции и сумма транзакции верная;
** желтым цветом, если оплата картой, есть идентификатор транзакции, но сумма транзакции не совпадает со значением поля '''Сумма руб''' в карточке корреспонденции;
** красным цветом, если оплата картой и нет идентификатора транзакции.
*: Если в карточке корреспонденции указан тип оплаты '''Наличными''', то поле будет закрашено красным, если есть идентификатор безналичной транзакции или указана ее сумма. Если их нет, то поле будет зеленым;
* при отмене оплаты обратный вызов удаляет идентификатор транзакции, чтобы сделать возможной повторную доставку и оплату заказа картой.

Чтобы настроить работу обратных вызовов:
# В личном кабинете курьерской службы в разделе '''Настройки''' > '''Финансы''' в разделе '''Настройки эквайринга Ibox''' заполните поля:
#* '''ID клиента в системе ibox''' — номер компании в разделе '''Профиль''' в личном кабинете ibox;
#* '''Логин для webhook ibox''' и '''Пароль для webhook ibox''' — придумайте логин и пароль для авторизации запросов ibox в MeaSoft. Логин и пароль могут состоять из цифр и латинских букв, длина не менее 5 символов.
#Система Ibox позволяет принимать платежи СБП через сайт и мобильное приложение.<br>Для получении ссылки для оплаты СБП, необходимо в настройках Ibox заполнить поля:<br>
#* '''Логин для СБП''' и '''Пароль для СБП'''
#Для отражения результатов оплаты счетов в заказах, используются вебхуки из внешней системы.<br>Для получения вебхуков нужно сообщить менеджерам Ibox url, на который будет отправляться результат оплаты:<br>[https://home.courierexe.ru/acq?pl=Ibox https://home.courierexe.ru/acq?pl=Ibox]
# Нажмите на кнопку '''Сохранить'''.
# Обратитесь в техподдержку ibox с просьбой подключить вебхуки для MeaSoft и сообщите им придуманные вами логин и пароль.

= LifePay СБП =

Сервис позволяет принимать онлайн-платежи при оплате картой курьеру.
Оплата Lifepay недоступна на странице отслеживания заказа

Чтобы настроить прием платежей через сервис Lifepay:

* Зарегистрируйтесь в сервисе Lifepay.
* В настройках личного кабинета курьерской службы введите:
** Логин администратора в системе Lifepay
** АПИ-ключ компании в системе Lifepay
[[Файл:settingsLifepay.png|none|900 px]]

Для отражения результатов оплаты счетов в заказах, используются вебхуки из внешней системы.

Вебхук приходит на url, который система передает Lifepay при формировании ссылки СБП.

При успешной оплате заказ в MeaSoft отмечается как оплаченный.