4. Настройки

В этом разделе представлены запросы, которые служат для получения информации о пользователе и юридическом лице. Также, в этом разделе представлены запросы для получения настроек системы.

Запросы для работы с пользователем:

  URI Назначение
4.1 /info/user/settings/ Получить настройки текущего пользователя
4.2 /info/user/lastvisit/ Получить информацию о последнем посещении личного кабинета

 
Запрос получения настроек системы:

  URI Назначение
4.3 /info/organization/settings/ Получить настройки системы
4.4 /info/organization/notifications/ Получить сообщение информационного блока
4.5 /info/organization/fields/ Получение списка полей, использующихся в форме оплаты, в платежах и в выставляемых счетах
4.6 /info/organization/reportemails/ Получить список рассылки для уведомления о платежах
4.7 /info/organization/users/ Получить список пользователей и их настройки

 

4.1. Запрос настроек текущего пользователя /info/user/settings/

Запрос возвращает информацию об имени текущего пользователя и возможности совершать возвраты. Для получения данных необходимо выполнить GET-запрос со следующими параметрами.

Тип Формат запроса
GET /info/user/settings/
Таблица 4.1.1. Параметры запроса

В ответ возвращается объект следующего вида:

4.adminПризнак того, что пользователь является администратором. Принимает значения true/false.

Тип Формат ответа
  Параметр Назначение
1. user Имя пользователя
2. refund_allowed Возможность осуществлять возвраты. Принимает значения: true/false.
3. refund Количество возвратов, которое пользователь может осуществить за сутки.
Таблица 4.1.2. Параметры ответа

Пример ответа на запрос:

 

4.2. Запрос информации о последнем посещении пользователя /info/user/lastvisit/

Запрос возвращает информацию о последнем посещении пользователем личного кабинета PayKeeper. В случае если это первый визит пользователя, возвращает текущее время. Для получения данных необходимо выполнить GET-запрос со следующими параметрами.

Тип Формат запроса
GET /info/user/lastvisit/
Таблица 4.2.1. Параметры запроса

В ответ возвращается объект следующего вида:

Тип Формат ответа
  Параметр Назначение
1. ip IP адрес последнего визита
2. datetime Дата и время последнего визита
Таблица 4.2.2. Параметры ответа

Пример ответа на запрос:

 

4.3. Запрос настроек /info/organization/settings/

Запрос возвращает информацию о настройках PayKeeper. Пользователь, не являющийся администратором, получит только те свойства, которые отмечены в таблице флагом «все пользователи». Для получения данных необходимо выполнить следующий GET-запрос.

Тип Формат запроса
GET /info/organization/settings/
Таблица 4.3.1. Параметры запроса

В ответ возвращается объект следующего вида:

10.smtp_hostАдрес SMTP сервераадминистратор11.smtp_portПорт SMTP сервераадминистратор12.smtp_userИмя пользователя SMTP в формате адреса электронной почтыадминистратор13.smtp_passwordПароль пользователя SMTPадминистратор14.skip_default_pagesФлаг указывает на то, что нужно пропускать стандартные страницы возврата paykeeper и сразу отправлять пользователя на сайт торговой точки. Принимает значения on или offадминистратор15.success_urlURL для возврата в случае успешной оплатыадминистратор16.fail_urlURL для возврата в случае ошибки при оплатеадминистратор

Тип Формат ответа
  Параметр Назначение Пользователи
1. shopname Название торговой точки все
2. shopdomain URL-сайта торговой точки все
3. legal_name Юридическое наименование организации все
4. paykeeper_id Номер договора все
5. support_email Почта для обращения в организацию администратор
6. informer_type Режим работы информера, принимает значение post или email администратор
7. informer_url URL уведомления для информера по которому отправляется информация о принятом платеже администратор
8. informer_seed Секретное слово для подписи сообщений информера администратор
9. smtp_use_custom Флаг использования стандартных настроек SMTP сервера PayKeeper. Если указано значение ‘true’, то для отправки писем используются настройки указанные в параметрах smtp_host, smtp_port, smtp_user, smtp_password. Если указано ‘false’, то используются настройки почтового сервера PayKeeper по умолчанию и параметры smtp_host, smtp_port, smtp_user, smtp_password не возвращаются в запросе. администратор
Таблица 4.3.2. Параметры ответа

Пример ответа на запрос:

Настройки личного кабинета - общие параметры

Настройки личного кабинета — общие параметры

Настройки личного кабинета - SMTP-сервер

Настройки личного кабинета — SMTP-сервер

Настройки личного кабинета - адреса перенаправления клиента

Настройки личного кабинета — адреса перенаправления клиента

 

4.4. Запрос информационных сообщений для организации /info/organization/notifications/

Запрос возвращает информационные сообщения, подготовленные для организации. Для получения данных необходимо выполнить следующий GET-запрос.

Тип Формат запроса
GET /info/organization/notifications/
Таблица 4.4.1. Параметры запроса

В ответ возвращается массив объектов следующего вида:

Тип Формат ответа
  Параметр Назначение
1. type Тип сообщения. Может принимать значения important , bottom, bottom_important
2. message HTML-код сообщения
3. link Ссылка для отображения в области ссылок, если тип сообщения предусматривает ссылку (значение атрибута href)
4. link_caption Текст ссылки link
Таблица 4.4.2. Параметры ответа

Пример ответа на запрос:

 

4.5. Запрос на получение списка используемых полей /info/organization/fields/

Запрос возвращает поля, которые используются в форме оплаты, в платежах и в выставляемых счетах. В запросе возвращается название поля в системе PayKeeper, название поля для отображения, значение поля по умолчанию, информация является ли поле активным и является ли поле обязательным для заполнения, а также тип поля и порядок сортировки в форме. Для получения данных необходимо выполнить следующий GET-запрос.

Тип Формат запроса
GET /info/organization/fields/
Таблица 4.5.1. Параметры запроса

В ответ возвращается массив объектов следующего вида:

5.enabledПризнак того, что поле является активным и его нужно использовать. Принимает значения true,false6.typeТип поля. Может принимать значения: sum, text, phone, email, bool7.orderПорядок сортировки в форме. Может принимать целые значения от 0 до 10 000. Сортировка происходит по возрастанию этого значения

Тип Формат ответа
  Параметр Назначение
1. pk_name Название поле в PayKeeper
2. displayed_name Название поле для отображения пользователю
3. required Признак того, что поле является обязательным для заполнения. Принимает значения true,false
4. placeholder Значение поля по умолчанию
Таблица 4.5.2. Параметры ответа

Пример ответа на запрос:

Настройки личного кабинета - настройки формы оплаты

Настройки личного кабинета — настройка формы оплаты

 

4.6. Запрос на получение списка рассылки для уведомления о платежах /info/organization/reportemails/

Запрос возвращает список адресов электронной почты, на которую осуществляется рассылка уведомлений о принятых платежах. Для получения данных необходимо выполнить следующий GET-запрос.

Тип Формат запроса
GET /info/organization/reportemails/
Таблица 4.6.1. Параметры запроса

В ответ возвращается массив объектов следующего вида:

Тип Формат ответа
  Параметр Назначение
1. id Идентификатор
2. email Адрес электронной почты
Таблица 4.6.2. Параметры ответа

Пример ответа на запрос:

Настройки личного кабинета - получение информации о платежах

Настройки личного кабинета — получение информации о платежах

Настройки личного кабинета - получение информации о платежах

Настройки личного кабинета — получение информации о платежах

 

4.7. Запрос на получение списка пользователей и их настроек /info/organization/users/

Запрос возвращает список пользователей PayKeeper вместе с их настойками. Для получения данных необходимо выполнить следующий GET-запрос.

Тип Формат запроса
GET /info/organization/users/
Таблица 4.7.1. Параметры запроса

В ответ возвращается массив объектов следующего вида:

Тип Формат ответа
  Параметр Назначение
1. id Идентификатор пользователя
2. login Логин пользователя
3. refund Количество возвратов которые пользователь может сделать за сутки. Если установлено «0», то функция возврата для этого пользователя недоступна
4. admin Признак того, что пользователь является администратором. Принимает значения true/false
Таблица 4.7.2. Параметры ответа

Пример ответа на запрос:

Настройки личного кабинета - доступ к панели администратора

Настройки личного кабинета — доступ к панели администратора