Интернет-эквайринг

Приём платежей на вашем сайте
с использованием банковских карт
и QR кодов Системы Быстрых Платежей

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. Параметры ответа

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

{
     "user"        :"admin",
     "refund_allow":"true",
     "refund"      : "0",
     "admin"       : "true"
}

{

"user" :"admin",

"refund_allow":"true",

"refund" : "0",

"admin" : "true"

}

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

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

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

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

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

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

{
     "ip"      : "81.5.119.7",
     "datetime": "2014-06-20 13:30:52"
}

{

"ip" : "81.5.119.7",

"datetime": "2014-06-20 13:30:52"

}

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

Запрос возвращает информацию о настройках. Пользователь, не являющийся администратором, получит только те свойства, которые отмечены в таблице флагом «все пользователи». Для получения данных необходимо выполнить следующий 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Флаг указывает на то, что нужно пропускать стандартные страницы возврата и сразу отправлять пользователя на сайт торговой точки. Принимает значения 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 сервера. Если указано значение ‘true’, то для отправки писем используются настройки указанные в параметрах smtp_host, smtp_port, smtp_user, smtp_password. Если указано ‘false’, то используются настройки почтового сервера по умолчанию и параметры smtp_host, smtp_port, smtp_user, smtp_password не возвращаются в запросе.	администратор
Таблица 4.3.2. Параметры ответа

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

{
     "shopname"       : "Магазин example.com",
     "shopdomain"     : "http://example.com",
     "legal_name"     : "ООО МАГАЗИН",
     "paykeeper_id"   : "140221-031-1",
     "support_email"  : "support@example.com"
     "informer_type"  : "email"
     "informer_url"   : "http://mysite.ru/postinform.php"
     "informer_seed"  : "secretpassword"
     "smtp_use_custom": "true"
     "smtp_user"      : "mymail@ya.ru"
     "smtp_password"  : "mypasswd"
     "smtp_host"      : "ssl://smtp.yandex.ru"
     "smtp_port"      : "465"
     "skip_default_pages": "true"
     "success_url"    : "http://example.com/success/"
     "fail_url"       : "http://example.com/fail/"
}

{

"shopname" : "Магазин example.com",

"shopdomain" : "http://example.com",

"legal_name" : "ООО МАГАЗИН",

"paykeeper_id" : "140221-031-1",

"support_email" : "support@example.com"

"informer_type" : "email"

"informer_url" : "http://mysite.ru/postinform.php"

"informer_seed" : "secretpassword"

"smtp_use_custom": "true"

"smtp_user" : "mymail@ya.ru"

"smtp_password" : "mypasswd"

"smtp_host" : "ssl://smtp.yandex.ru"

"smtp_port" : "465"

"skip_default_pages": "true"

"success_url" : "http://example.com/success/"

"fail_url" : "http://example.com/fail/"

}

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

Настройки личного кабинета — 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. Параметры ответа

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

[
   {
      "type": "important",
      "message": "<strong>ВНИМАНИЕ:</strong> ДО КОНЦА ПЕРИОДА ПОДДЕРЖКИ И ОБНОВЛЕНИЙ <strong>ОСТАЛОСЬ 10 ДНЕЙ</strong>",
      "link": "https://paykeeper.ru/paykeeper/pay/tech/",
      "link_caption": "ПРОДЛИТЬ"
   },
   {
      type: "bottom",
      "message": "до конца периода обновлений 
 и поддержки <em>осталось 255 дней</em>",
      "link": "https://paykeeper.ru/paykeeper/pay/tech/",
      "link_caption": "Обратиться в службу поддержки"
   }
]

[

{

"type": "important",

"message": "ВНИМАНИЕ: ДО КОНЦА ПЕРИОДА ПОДДЕРЖКИ И ОБНОВЛЕНИЙ ОСТАЛОСЬ 10 ДНЕЙ",

"link": "https://paykeeper.ru/paykeeper/pay/tech/",

"link_caption": "ПРОДЛИТЬ"

{

type: "bottom",

"message": "до конца периода обновлений

и поддержки осталось 255 дней",

"link": "https://paykeeper.ru/paykeeper/pay/tech/",

"link_caption": "Обратиться в службу поддержки"

}

]

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

Запрос возвращает поля, которые используются в форме оплаты, в платежах и в выставляемых счетах. В запросе возвращается название поля в системе, название поля для отображения, значение поля по умолчанию, информация является ли поле активным и является ли поле обязательным для заполнения, а также тип поля и порядок сортировки в форме. Для получения данных необходимо выполнить следующий 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	Название поле в платежной платформе
2.	displayed_name	Название поле для отображения пользователю
3.	required	Признак того, что поле является обязательным для заполнения. Принимает значения true,false
4.	placeholder	Значение поля по умолчанию
Таблица 4.5.2. Параметры ответа

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

[
	{
	"pk_name"         :"clientid",
	"displayed_name"  :"Фамилия Имя Отчество",
	"placeholder"     :"Иванов Иван Иванович",
	"required"        :"true",
	"enabled"         :"true",
	"required"        :"false",
	"order"           :"20",
	"type"            :"clientid"
	},
…
]

[

{

"pk_name" :"clientid",

"displayed_name" :"Фамилия Имя Отчество",

"placeholder" :"Иванов Иван Иванович",

"required" :"true",

"enabled" :"true",

"required" :"false",

"order" :"20",

"type" :"clientid"

…

]

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

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

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

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

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

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

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

[
	{
	"id"   : "1",
	"email": "support@paykeeper.ru"
	},
…
]

[

{

"id" : "1",

"email": "support@paykeeper.ru"

…

]

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

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

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

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

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

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

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

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

[
 	{
             "id"    : "1",
             "login" : "admin",
             "refund": "0",
             "admin" : "true"
	},
…
]

[

{

"id" : "1",

"login" : "admin",

"refund": "0",

"admin" : "true"

…

]

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

Заполните заявку

и сразу получите доступ в личный кабинет

Если у вас остались вопросы

8 (800) 775-27-61 Бесплатный звонок по России

+7 (495) 665-70-14 Бесплатный звонок по Москве