Интеграция Тинькофф-Эквайринг и RetailCRM
Модуль интеграции Тинькофф-Эквайринга с RetailCRM.
Подробная инструкция по установке и активации
1. Создание Ключа доступа к API
- Шаг 1.1. Войдите под своей учетной записью в RetailCRM
- Шаг 1.2. Перейдите в Настройки/Интеграции/Ключи доступа к API
- Шаг 1.3. Нажмите кнопку Добавить
- Шаг 1.4. Скопируйте содержимое из поля Ключ. Это Ключ доступа к API, с которым будет работать модуль
- Шаг 1.5. Отметьте магазины из списка, с которыми будет работать модуль
- Шаг 1.6. Отметьте методы из списка Разрешенные методы API. Нужные методы указаны в Приложении 1
- Шаг 1.7. Нажмите сохранить
2. Вход в модуль
- Шаг 2.1. Перейдите в Настройки/Интеграции/Маркетплейс
- Шаг 2.2. Выберите модуль Оплата через Тинькофф
- Шаг 2.3. Нажмите кнопку Перейти в личный кабинет
3. Настройка модуля
- Настройка Блока Доступы в RetailCRM
- Шаг 3.1. В поле Ключ доступа к API введите Ключ из шага 1.4
- Шаг 3.2. В поле Ссылка на RetailCRM введите адрес вашей копии RetailCRM
- Шаг 3.3. Нажмите кнопку Сохранить. При успешной проверке и подключении к вашей RetailCRM появится окно с текстом Сохранено. Появится следующий блок Магазины
- Настройка Блока магазинов
- Шаг 3.4. Выберите из списка один или несколько магазинов, с которыми должен работать модуль
- Шаг 3.5. Нажмите Сохранить. При успешной проверке появится окно с текстом Сохранено. Появится следующий блок Аккаунт Тинькофф-Эквайринг
- Настройка Блока Аккаунта Тинькофф-Эквайринг
- Шаг 3.6. В поля Терминал и Секретный ключ введите соответствующие данные. Пояснение о доступах в Тинькофф-Эквайринг в Приложении 2
- Нажмите кнопку Сохранить. При успешной проверке появится окно с текстом Сохранено.
- Активация и запуск модуля
- Шаг 3.7. Нажмите на кнопку Запуск конфигурации модуля. При успешной проверке появится окно с текстом Успешно.
- Шаг 3.8. Перейдите в RetailCRM/Настройки/Интеграция/Маркетплейс/Тинькофф-Эквайринг. Отметьте «Активность». Нажмите «Сохранить».
- Шаг 3.9. Модуль активирован.
4. Создание типов оплат
- Шаг 4.1. Перейдите в RetailCRM/Администрирование/Справочники/Типы оплат. Нажмите кнопку «Добавить»
- Шаг 4.2. Введите название типа оплаты (Пример: Оплата Тинькофф-Эквайринг. Магазин №1)
- Шаг 4.3. Введите символьный код типа оплаты (Пример: tinkoff-shop-1)
- Шаг 4.4. Выберите из списка «Интегрировать с» нужный магазин, с которым будет работать модуль
- Шаг 4.4. В поле «Статусы счетов» — нажмите на кнопку «Перейти к настройке». Соотнесите статусы платежей со статусами оплат из RetailCRM. Нажмите Сохранить
Замечание по обновлению настроек модуля, после начала использования
Чтобы новые настройки вступили в силу, необходимо:
- Шаг 1. Отредактировать необходимые данные из нужного блока настроек
- Шаг 2. Нажать на кнопку Сохранить в блоке настроек из Шага 1.
- Шаг 3. Нажать на кнопку Запуск конфигурации модуля
Приложение №1
Необходимые методы API RetailCRM для работы модуля
- /api/credentials
- /api/integration-modules/{code}
- /api/integration-modules/{code}/edit
- /api/payment/update-invoice
- /api/reference/sites
Приложение №2
Доступы в Тинькофф-Эквайринг находится в письме от Тинькофф, которое приходит на почту после заключения договора на использование системы Тинькофф-Эквайринг
Для получения номера терминала и пароля, вам нужно зайти в личный кабинет Интернет-эквайринг Тинькофф, зайти во вкладку «Магазины», там переключить вкладку «Терминалы» и ввести данные тестового терминала, после вам нужно совершить тестовые платежи (5 штук), номера карт так же тестовые предоставляются Тинькофф, после того, как пройдете тесты и нажмете «проверить», будет написано «Тесты пройдены». Далее нужно написать в техподдержку Тинькофф, чтобы они активировали рабочий терминал, в течении дня вам должны будут его активировать. Не забудьте поменять номер терминала и пароль на рабочий.
Возможные ошибки
Если появляется ошибка Неверные параметры. Поле taxation не должно быть пустым — значит подключена онлайн касса и передача состава заказа — обязательно. Включите в модуле — передача состава заказа.