Платежные системы — различия между версиями

Версия 09:47, 27 февраля 2015

Платежные системы — модуль Такси-Мастер, позволяющий вести учет обращения денежных средств на счетах водителей, когда водители заносят средства через платежные терминалы. Для работы с этим модулем требуется установленный и работающий сервер TMServer, а также договор на оказание соответствующих услуг.

Интеграция с платежными системами и локальными терминалами:
http://youtu.be/w5cBeQUatTo

В модуле можно выделить три основополагающих компонента системы:

1. Терминал, с помощью которого водители службы такси вносят денежные средства.
2. Сервер - программное обеспечение, которое принимает и обрабатывает запросы о приеме денежных средств.
3. Программный компонент Такси-Мастер. Включает в себя TM API и справочник «Платежные системы».

Файл:Схема оборота данных.png

Схема работы модуля довольно проста и незаурядна: денежные средства, который водитель вносит на счет, поступают в терминал оплаты. Следом данные о платеже заносятся на сервер, который обрабатывает запрос и записывает все произведенные транзакции. Последним звеном данной схемы является передача информации о внесенных денежных средствах в программу Такси-Мастер.

В данной ситуации необходимо различать такие два понятия, как информация о платеже и денежные средства. Информация о платеже составляет полные данные о сумме, которую внес водитель, без учета взимаемого процента. Эти данные заносятся в базу данных Такси-Мастер. Денежные же средства - это непосредственно сумма, которая была зачислена на расчетный счет компании за вычетом установленного процента.

Получение доступа к зачислению средств через терминалы

Для того, чтобы получить возможность видеть в программе Такси-Мастер операции по приходу средств от водителей, вам необходимо заключить договор на оказание соответствующих услуг. Чтобы сделать это, обратитесь в отдел дополнительных продаж, написав на odu@bitmaster.ru соответствующий запрос.

Занесение терминальных аккаунтов

После заключения договора вам необходимо оформить аккаунты для водителей. Список водителей хранится в базе данных Такси-Мастер, и доступ к нему происходит через справочник «Водители». Следовательно, вам необходимо иметь полный список водителей, которые работают в вашей службе, чтобы те имели возможность заносить денежные средства через терминалы оплаты. Поэтому заполните справочник «Водители» — создайте учетные записи для каждого из водителей.

Далее, когда список водителей готов, вам необходимо занести его особым образом. В настройках Такси-Мастер существует ветка TM API, в которой есть вложенная ветка "Платежные терминалы". Нажмите кнопку «Задать всем водителям терминальные аккаунты по их ИД», которая служит для соединения TM API с сервером Такси-Мастер. В результате соединения, записи о терминальных аккаунтах генерируются и заносятся в Такси-Мастер для тех водителей, у которых они отсутствуют.

После этого в карточке каждого водителя вы увидите, что поле «Терминальный аккаунт» больше не пустое — в нем находится некоторое значение. Сообщите каждому из водителей их значения, чтобы они могли пополнять счета через терминалы оплаты, — эти данные необходимо вводить в качестве реквизитов оплаты.

Заведение новой учетной записи платежной системы в Такси-Мастер

Чтобы иметь возможность отображать в Такси-Мастер платежи от водителей, необходимо сопоставить платежную систему и учетную запись в ней с вашими данными. Для этого необходимо создать карточку службы в справочнике «Платежные системы» и занести в нее данные, которые были выданы вам отделом продаж.

Файл:Карточка ПС.png

Заполните поля карточки:

1. «Название» — наименование записи. Укажите любое наименование, описывающее суть записи.
2. «Тип платежной системы» — выберите платежную систему, подключение к которой вы настраиваете.
3. «Префикс» — введите выданный вам префикс. Введите его в точности так, как он указан в выданном вам документе, не добавляя лишних символов.
4. «Комиссия» — в этой группе настройте параметры комиссии, чтобы они отражались на счетах водителей. По умолчанию комиссия равна «0%», то есть платежная система сообщает начальную сумму платежа.

Пример платежа

Перед вводом модуля в эксплуатацию обязательно проведите тестовый платеж. Он должен отразиться в Такси-Мастер одной или двумя (в зависимости от настройки) операциями (либо только приход, либо приход и комиссия). Для примера возьмем водителя:

Файл:Карточка водителя (ПС).png

В его карточке есть поле «Терминальный аккаунт» — оно не редактируется и заполняется только при выполнении процедуры занесения терминальных аккаунтов. В этом поле указан уникальный номер, присвоенный водителю.

Водитель, пополняя счет, указывает префикс, присвоенный вашей организации, и свой уникальный номер. В результате проходит либо одна, либо две операции, как было рассмотрено выше, при этом они отражаются на состоянии счета водителя. Основная операция отражает сумму, введенную водителем:

Комиссия — процент от суммы, введенной водителем, регулируемый настройками и может отсутствовать, если соответствующая настройка отключена.

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

Коды ответа

При работе с терминалами оплаты сервер TM API может выдавать следующие коды ответа:

1. «Incoming payment:» — поступил новый платеж. После двоеточия указаны платежный номер водителя и поступившая на его счет сумма.
2. «Unable to connect to database:» — невозможно подключиться к базе данных.
3. «Driver not found:» — не найден водитель. Детали ошибки следуют после двоеточия.
4. «Bad parameter X:» — неверный параметр в запросе.
5. «Duplicate entry AUTH_CODE:» — платеж с указанным идентификатором уже присутствует в базе данных.
6. «Some parameters are invalid:» — неопознанная ошибка, связанная с невозможностью проведения платежа ввиду неверных параметров. После двоеточия перечисляются эти параметры.

Платежный терминал

Платежный терминал - программно-аппаратный комплекс, принадлежащий сторонней организации, с помощью которого водители вашей службы такси могут вносить денежные средства для пополнения счета. Он является одним из основополагающих звеньев в работе модуля интеграции с платежными системами.

Список терминалов, с которыми установлено взаимодействие:

1. Элекснет. Скачать список городов распространения терминалов «Элекснет».
   • Файл:ПС кнопка Такси.png
2. КамПэй
3. Терминалы сбербанка на территории РФ.
4. Единая кнопка оплаты (ЕКО). Для того, чтобы принимать платежи с помощью ЕКО, следует заключить договор с компанией «Альфа Технологии». После этого вашей компании будет присвоен определенный шестизначный идентификационный номер в системе ЕКО, который вам необходимо отправить нашей организации в письменной форме на odu@bitmaster.ru. Когда водитель будет вносить денежные средства с помощью ЕКО, то он должен ввести данный шестизначный номер плюс свой терминальный аккаунт, скомпилированный в программе Такси-Мастер. Таким образом, у каждого водителя будет свой идентификационный код, состоящий из следующих чисел: 000000-XXXXXX, где 000000 - код в системе «Альфа Технологии», XXXXXX - динамическая часть (номер терминального аккаунта). ЕКО присутствует на следующих терминалах: QIWI, Связной, Евросеть и др. Также следует обратить внимание на то, что ЕКО в терминалах существует не только на территории РФ, но и в некоторых регионах Казахстана и Украины.
   • Файл:ПС ЕКО.png
5. Также вы можете устанавливать свою кнопку оплаты абсолютно на любом терминале вне зависимости от его производителя и местоположения. Для получения полной информации о внедрении новых платежных систем, вы можете обратиться в отдел дополнительных услуг нашей организации, отправив письмо на odu@bitmaster.ru.