Протокол взаимодействия

advertisement
ООО «ФлексиДеньги»
ОГРН 1117746296690
ИНН 7722744900 КПП 772201001
Сервис электронных
платежей
Платформа ФлексиДеньги
Описание протокола взаимодействия
Версия 0.9.1
© Flexi Деньги
www.flexidengi.ru
[email protected]
127055, г. Москва, ул. Образцова, д. 7
+7 (495) 640-25-95
ООО «ФлексиДеньги»
ОГРН 1117746296690
ИНН 7722744900 КПП 772201001
СОДЕРЖАНИЕ
Введение ...................................................................................................................................3
Цель документа .....................................................................................................................3
Глоссарий ..............................................................................................................................3
Краткое описание сервиса ....................................................................................................3
Протокол взаимодействия ........................................................................................................4
Исходные данные..................................................................................................................4
Прием заявок на совершения платежа ................................................................................4
Уведомление Партнера о Совершенных платежах ............................................................6
Реестр Платежей...................................................................................................................6
© Flexi Деньги
www.flexidengi.ru
[email protected]
127055, г. Москва, ул. Образцова, д. 7
+7 (495) 640-25-95
ООО «ФлексиДеньги»
ОГРН 1117746296690
ИНН 7722744900 КПП 772201001
ВВЕДЕНИЕ
ЦЕЛЬ ДОКУМЕНТА
Документ описывает суть сервиса мультиоплаты, механику его оказания и протокол взаимодействия в
рамках данного сервиса между платформой Пластик и ИС Партнера.
ГЛОССАРИЙ
Платформа Флекси – программно-аппаратный комплекс для обработки транзакций.
Партнер – информационная система партнера – программно-аппаратный комплекс, используемый
Компанией – Партнером для подключения к Платформе Флекси для проведения электронных платежей.
Товар – выделенная единица услуги или продукта, предоставляемая пользователю в результате оплаты.
Сервис – совокупность товаров, предоставляемых Партнером.
КРАТКОЕ ОПИСАНИЕ СЕРВИСА
Сервис представляет собой платежную страницу на которую Партнер направляет пользователя.
Пользователь производит выбор метода оплаты и следует дальнейшим инструкциям.
По факту совершения/не совершения платежа происходит возврат пользователя на страницу сервиса
партнёра,
а
также
уведомление
партнера
о
результате
платежа.
© Flexi Деньги
www.flexidengi.ru
[email protected]
127055, г. Москва, ул. Образцова, д. 7
+7 (495) 640-25-95
ООО «ФлексиДеньги»
ОГРН 1117746296690
ИНН 7722744900 КПП 772201001
ПРОТОКОЛ ВЗАИМОДЕЙСТВИЯ
ИСХОДНЫЕ ДАННЫЕ
Для начала работы с платформой партнеру необходимо предоставить следующие данные:
 URL для уведомлений о проведенных платежей.
 URL сервиса партнера на который возвращается абонент после успешного проведения платежа.
 URL сервиса партнера на который возвращается абонент после неудачного проведения платежа
 E-mail на который будут отсылаться реестры платежей.
Со стороны платформы партнеру выдаются:
 Идентификаторы сервисов и товаров партнера.
 Секретное слово.
 URL платежной страницы.
© Flexi Деньги
www.flexidengi.ru
[email protected]
127055, г. Москва, ул. Образцова, д. 7
+7 (495) 640-25-95
ООО «ФлексиДеньги»
ОГРН 1117746296690
ИНН 7722744900 КПП 772201001
ПРИЕМ ЗАЯВОК НА СОВЕРШЕНИЯ ПЛАТЕЖА
Для совершения платежа пользователем, партнёру необходимо направить пользователя на страницу
оплаты методом POST с передачей следующих параметров:
Обязательные параметры:
Параметр
service_id
customer_id
order_id
hash
Описание
Идентификатор
сервиса
партнера,
обязательный
Идентификатор пользователя у партнера,
обязательный
Идентификатор
заказа
у
партнера,
обязательный
Контрольная сумма.
Высчитывается как
md5(service_id+customer_id+order_id+secret_key),
где "+"- знак конкатенации, "secret_key" секретный ключ, выдаваемый при регистрации
партнера
Необязательные параметры:
Параметр
product_id
summ
currency
count
Описание
Идентификатор товара на платформе. Если не
указан - будет отображен список всех продуктов
на сервисе;
Сумма платежа.
Валюта, обязательно, в случае если указана
сумма. Ожидается трехбуквенный ISO 4217 код
валюты
Количество единиц товаров.
После проведения платежа абонент будет возвращен на страницу сервиса партнера, указанную в
настройках сервиса.
© Flexi Деньги
www.flexidengi.ru
[email protected]
127055, г. Москва, ул. Образцова, д. 7
+7 (495) 640-25-95
ООО «ФлексиДеньги»
ОГРН 1117746296690
ИНН 7722744900 КПП 772201001
УВЕДОМЛЕНИЕ ПАРТНЕРА О СОВЕРШЕННЫХ ПЛАТЕЖАХ
После проведения платежа или его неудачи платформа отсылает HTTP GET запрос на URL партнёра
для уведомлений, возможно использование SSL при желании партнера.
Запрос отсылаемый партнеру содержит следующие параметры с информацией о транзакции:
Параметр
Описание
service_id
Идентификатор сервиса партнера
customer_id
Идентификатор пользователя на стороне партнера
order_id
Идентификатор заказа на стороне партнера
processing_status
Статус обработки транзакции
desc
Описание ошибки, если транзакция не удачна
Сумма транзакции в валюте платежа, число с 2-мя
price
знаками в дробной части, разделитель целой и дробной
части - "."
Сумма транзакции в рублях, число с 2-мя знаками в
price_rub
дробной части, разделитель целой и дробной части - "."
Номер транзакции на стороне платформы, целое число,
transaction_id
до 20 знаков.
currency
Валюта платежа на счет партнера, ISO 4217
share_rub
Вознаграждение партнера в рублях
Дата проведения транзакции на стороне платформы в
transaction_date
формате YYYY-MM-DD HH:mm:ss
md5
от
конкатенации
полей:
hash
service_id+transaction_id+customer_id+order_id+secret_key
payment_method_id
Идентификатор способа оплаты см. Приложение 1
product_id
Идентификатор товара на стороне платформы.
Поле processing_status может принимать следующие строковые значения:
Значение
PROCESSED
FAILED
© Flexi Деньги
www.flexidengi.ru
[email protected]
Описание
Транзакция успешно оплачена пользователем
Транзакция не оплачена пользователем, в поле
desc дается в этом случае описание причины
ошибки
127055, г. Москва, ул. Образцова, д. 7
+7 (495) 640-25-95
ООО «ФлексиДеньги»
ОГРН 1117746296690
ИНН 7722744900 КПП 772201001
РЕЕСТР ПЛАТЕЖЕЙ
Платформа производит регулярное формирование реестров проведенных платежей и отсылает их
партнеру на указанный им e-mail.
Данные, формируемые в соответствии с настоящим реестром, представляются в виде файлов в
формате csv с разделителем “;”:
1. YYYYMMDD_N.csv, где YYYYMMDD - дата создания реестра (в соответствующем формате), N положительное целое число, идентификатор отчета на платформе.
2. Файл содержит данные в кодировке UTF-8.
3. Далее содержится заголовок, определенный как набор названий полей, разделенных символом
";". Заголовок занимает одну строку.
4. Далее идет набор записей, набор значений, соответствующих заголовку, и разделенных
символом ";". Каждая запись содержится в отдельной строке.
Далее приводится название колонок реестра, с их описанием. Следует заметить, что платформа может
добавлять колонки к уже существующим (не нарушая порядок) без предварительного уведомления
партнера.
Название столбца
Описание
transaction_date
Дата проведения транзакции на стороне платформы в формате YYYY-MMDD HH:mm:ss
registry_date
Дата в формате YYYY-MM-DD HH:mm:ss, укзаывающая на день, на который
попадает учет данного платежа
transaction_id
Номер транзакции на стороне платформы, целое число, до 20 знаков.
currency
Валюта платежа, ISO 4217
price
Сумма транзакции в валюте платжа, число с 2-мя знаками в дробной части,
разделитель целой и дробной части - "."
price_rub
Сумма транзакции в рублях, число с 2-мя знаками в дробной части,
разделитель целой и дробной части - "."
share_rub
Вознаграждение партнера в рублях
order_id
Номер счета, указанный партнером при его выставлении
transaction_status
Код
статуса
транзакции,
целое
0
транзакция
произведена
1 – транзакция не произведена
payment_method_id
Идентификатор способа оплаты см. Приложение 1
© Flexi Деньги
www.flexidengi.ru
[email protected]
127055, г. Москва, ул. Образцова, д. 7
число.
успешно
+7 (495) 640-25-95
Скачать