Интеграция поддерживается начиная с версии r_keeper 7.07.00.222.

Для подключения Системы быстрых платежей (СБП):

  1. Закажите необходимые лицензии
  2. Обратитесь в службу поддержки банка или подключите СБП по ссылке
  3. Выполните настройки в менеджерской станции. В версии r_keeper 7.07.00.228 и выше настройки предустановлены.
  4. Настройте Farcards
  5. Настройте конфигуратор банка.

Лицензии и настройки в менеджерской станции описаны в отдельной статье.

Настройка farcards

Через СБП банка Тинькофф можно проводить оплаты только больше 10 рублей.
  1. Скачайте папку СБП с FTP-сервера: перейдите через проводник на ftp://ftp.ucs.ru/rk7/versions/ и выберите последнюю версию
  2. Распакуйте архив, извлеките последнюю версию папки с настройками и сам сервер farcards в одну папку и настройте файл farcards.ini:

    [FarServer]
    Type = 1
    DLL = SbpTinkoffFc.dll
    Gate = 1
    XMLCP=1251
     
     
    [LinkDLL]
    1 = pds_netk
     
    [pds_netk]
    NetServerName=TINKOFF
    ininame=netk.ini
    DebugMessages=1
    CODE

    В строке NetServerName вместо TINKOFF укажите имя вашего сервера, которое указано в настройках PDS интерфейса.

  3. Убедитесь, что кассовый сервер работает. Запустите его, если он не активен
  4. Запустите Farcards как службу: создайте ярлык для farcards с параметром /install. Например, …FarCards_Tinkoff\Farcards.exe /install. Запустите ярлык от имени администратора.

Важно!

Чтобы оплата проходила без ошибок, запускайте службу Farcads только при работающем кассовом сервере.

Настройка конфигуратора Tinkoff

Из папки Farcards_Tinkoff запустите TinkoffConfigurator.exe и выполните следующие действия:

  1. Заполните на вкладке Настройки поля в блоках Настройки Тинькофф, которые выдаются банком:
    1. Номер терминала — не связан с пинпадом. Как правило, состоит из 13 цифр.
    2. Пароль — пароль из букв латинского алфавита и цифр. Обычно включает 16 символов.
      Данные выдаются банком на заведение, необходимо обратиться в банк.
  2. Укажите Настройки подключения к r_keeper 7
    1. IP-адрес кассового сервера
    2. Порт для подключения к кассовому серверу
    3. Имя предустановленного пользователя из группы HTTP-user
    4. Пароль этого пользователя.
  3. Нажмите кнопку Тест соединения
  4. Если настройки подключения выполнены правильно, то станет доступен для заполнения блок Дополнительные

    1. Интерфейс Farcards — выберите предустановленный интерфейс. Чтобы выбрать, нажмите кнопку с тремя точками.
    2. Валюта для оплаты — выберите предустановленную валюту СБП
    3. Скидка — выберите предустановленную скидку
    4. Кассир (код кассира) — укажите код кассира, который будет работать с СБП. Код кассира можно посмотреть в меню Персонал > Работники, в свойствах нужного кассира.
    5. Станция для оплаты — выберите станцию, на которой будет приниматься оплата по СБП.
    6. Код документа для печати qr-кода — в качестве кода используйте код группы Купоны, в которой находится используемый макет.
  5. После заполнения полей на вкладке Настройки нужно перейти на вкладку Лицензия
  6. На вкладке Лицензия введите числовой Дилер ID и пароль дилера, у которого есть права на работу с объектом. Нажмите кнопку Проверить лицензию.
  7. Если лицензии не обнаружены, система выдаст соответствующую ошибку.

    Если лицензия обнаружена, система сообщит ее данные
  8. Нажмите кнопку Сохранить настройки в конфигураторе.

Если у вас есть несколько активных лицензий на продукт — применится лицензия с большим сроком действия.

При возникновении ошибок с токеном, при обновлении плагина СБП Тинькофф обратитесь на integrations@rkeeper.ru

Оплата по системе быстрых платежей (СБП) для банка Тинькофф настроена.

Чтобы проверить настройки, пройдите путь заказа от создания до оплаты с помощью QR-кода.

Настройка tinkoff.dll

Название параметра

Обязательный

Описание

Значение по умолчанию

ApiPathнетПуть к серверу с api Тинькоффhttps://securepay.tinkoff.ru/
TerminalIdдаИдентификатор терминала, предоставляется банком
PasswordдаПароль для работы с api Тинькофф, предоставляется банком
TimeoutнетТаймаут на запросы к api Тинькофф20
CheckInvoiceStatusIntervalнетПериод в секундах между запросами с проверкой статуса платежа на стороне банка Тинькофф5

PDSInterfaceC1

даКод PDS интерфейса Тинькофф
CurrencyCodeдаКод валюты, которой будет оплачиваться заказ
UseProxyнетИспользовать прокси серверfalse
ProxyIpнетIp адрес прокси сервера127.0.0.1
ProxyPortнетПорт прокси сервера8888
XmlInterfaceIpдаIp https сервера на кассовом сервере
XmlInterfacePortдаПорт https сервера на кассовом сервере
CashierCodeдаКод кассира, от имени которого будет добавляться оплата в заказ
XmlInterfaceUserдаИмя пользователя для авторизации на https сервере кассового сервера
XmlInterfacePasswordдаПароль пользователя для авторизации на https сервере кассового сервера
DiscountCodeдаКод скидки-триггера, которая стартует сценарии работы с Тинькофф
SeqNumberнетПорядковый номер запроса для лицензирования xml-запросов
PayStationCodeнетКод станции, на которой будет производиться печать чека
PayStationNameнетНазвание станции, на которой будет производиться оплата
PrintDocumentCodeдаКод группы документов для с макетом печати qr-кода101

Пример файла настроек config.xml:

<?xml version="1.0"?>
<TerminalConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<ApiPath>https://securepay.tinkoff.ru/</ApiPath>
<TerminalId></TerminalId>
<Password></Password>
<Timeout>30</Timeout>
<CheckInvoiceStatusInterval>5</CheckInvoiceStatusInterval>
<InvoiceLifeTime>10</InvoiceLifeTime>
<PDSInterfaceCode>20</PDSInterfaceCode>
<CurrencyCode>114</CurrencyCode>
<PayStationCode>6</PayStationCode>
<PayStationName>Kassa 1</PayStationName>
<XmlInterfaceIp>127.0.0.1</XmlInterfaceIp>
<XmlInterfacePort>7333</XmlInterfacePort>
<CashierCode>109</CashierCode>
<XmlInterfaceUser>http</XmlInterfaceUser>
<XmlInterfacePassword>106</XmlInterfacePassword>
<DiscountCode>20</DiscountCode>
<SeqNumber>14</SeqNumber>
</TerminalConfig>
CODE