Общие сведения
Инструкция предназначена для партнеров, подключающихся по Протоколу приема платежей.
Из инструкции вы узнаете:
- Как зарегистрироваться в Личном кабинете.
- Из каких разделов состоит Личный кабинет.
- Сведения о подключенных услугах.
- Какие используются роли в Личном кабинете.
- Как выставлять счета без интеграции и отслеживать оплату.
- Как выставлять счета через Telegram.
- Как создать QR-код для оплаты.
- Как искать транзакции.
- Как восстановить пароль от Личного кабинета.
- Как выпустить токен для авторизации в API.
- Как выпустить ключ для серверных уведомлений.
Начало работы
Вы подаете заявку на подключение самостоятельно через сайт или через сопровождающего менеджера.
Вход в Личный кабинет
После того, как ваш сопровождающий менеджер заполнит заявку и добавит вас в Личный кабинет, вы получите электронное письмо.
Перейдите по ссылке из письма для подтверждения почтового адреса.
Ссылка направит вас на форму для установления пароля от Личного кабинета. Укажите пароль и нажмите Войти для входа в Личный кабинет.
Что делать, если не пришло письмо
-
Пройдите по ссылке и нажмите Напомнить.
-
Введите ваш e-mail и нажмите Продолжить.
-
Проверьте почту — вам придет письмо со ссылкой на смену пароля.
Главная страница Личного кабинета
Вход в Личный кабинет выполняется по e-mail и паролю, который вы придумали при подтверждении e-mail.
После входа вы попадаете на главную страницу Личного кабинета, где доступны 4 вкладки:
- Услуги.
- Заявки.
- Пользователи (только для роли Администратор, подробнее в разделе Роли в Личном кабинете).
- Поддержка.
Услуги
На вкладке отображаются ваши подключенные сайты и ID.
Нажмите на название услуги и вы перейдете в Личный кабинет подключенного сайта. Подробнее в разделе Личный кабинет подключенной услуги.
Заявки
На вкладке отображаются ваши заявки. Нажмите на заявку, чтобы получить подробную информацию о ее статусе и описание ваших дальнейших шагов.
Пользователи
На вкладке настраивается доступ ваших сотрудников в Личный кабинет:
-
Нажмите кнопку Пригласить пользователя внизу списка сотрудников.
- Укажите e-mail и выберите роль сотрудника (Тех.специалист, Менеджер, Администратор). Подробнее о ролях см. раздел Роли в Личном кабинете.
-
Нажмите кнопку Создать.
Добавленный пользователь получит письмо со ссылкой для перехода в Личный кабинет.
Поддержка
На вкладке можно задать вопрос специалистам Службы поддержки. Заполните форму и нажмите кнопку Отправить.
Личный кабинет подключенной услуги
В Личном кабинете доступны вкладки:
Транзакции
На вкладке отображается список транзакций по вашим услугам.
Нажмите на строку таблицы, чтобы посмотреть информацию по отдельной транзакции во всплывающем окне.
Для просмотра детальной информации по транзакции (тип карты, сведения о плательщике) нажмите Подробно.
Также вы можете:
- Найти транзакцию.
- Воспользоваться фильтром для отбора транзакций.
- Настроить отображение столбцов списка транзакций.
- Сделать возврат транзакции.
Поиск транзакций
- Выберите в поле рядом со строкой поиска атрибут, по которому вы хотите искать транзакции:
- ID транзакции — точное соответствие.
- Номер счета — точное соответствие.
- Номер карты — в свободном формате, но обязательно либо первые несколько цифр, либо символ
*
и последние цифры. Например:411111*1111
411111
*1111
- Код авторизации — точное соответствие.
- Имя покупателя — точное соответствие.
- Email — точное соответствие
- Телефон — точное соответствие.
- Пользовательские поля — точное соответствие.
- Укажите в строке поиска значение выбранного атрибута и система автоматически загрузит список найденных транзакций.
Отбор транзакций с помощью фильтров
Вы можете отфильтровать список транзакций по заданным признакам:
- Нажмите на значок Фильтр и выберите параметры отбора транзакций (укажите данные либо выберите из выпадающего списка). Доступны фильтры для отбора:
- Дата — Дата или период дат транзакции. Доступны предустановленные фильтры Сегодня, Вчера и пр.
- Сумма от — Минимальная сумма транзакции.
- Сумма до — Максимальная сумма транзакции.
- Тип — Тип транзакции (Оплаты, Возвраты).
- Статус — Статус транзакции. Возможные статусы транзакций:
- Проведенные — оплата прошла успешно.
- Новые — транзакции, по которым не было завершенной попытки оплаты (например, пользователь не проходил на 3-D Secure, или ушел со страницы 3-D Secure).
- Отклоненные — оплата, которую отклонили (причина отклонения отображается при просмотре транзакции).
- Сайт — Услуга, по которой была транзакция.
- Нажмите кнопку Найти. Список отобразит все транзакции, соответствующие выбранным фильтрам.
Шаблон отображения транзакций
Вы можете создать собственный шаблон отображения списка транзакций:
- Нажмите кнопку Шаблон.
-
Нажмите кнопку Создать новый.
-
Выберите поля для отображения. Чтобы настроить порядок столбцов в списке транзакций, перетаскивайте поля.
- Нажмите кнопку Сохранить.
Чтобы воспользоваться созданным шаблоном, нажмите кнопку Шаблон и выберите шаблон во всплывающем окне. Затем нажмите Выбрать.
Вид списка транзакций изменится в соответствии с шаблоном.
Возврат транзакций
- Нажмите на выбранную транзакцию в списке на вкладке Транзакции.
-
В открывшемся окне нажмите Сделать возврат.
-
Заполните поля Причина возврата, Сумма.
- Нажмите Вернуть.
-
Проверьте информацию о возврате и закройте окно.
Документы
Вкладка содержит две вложенных вкладки — Реестры и Акты. Вкладка Акты находится в разработке.
Реестры
Реестр в Личном кабинете содержит список всех транзакций, в том числе неуспешных (с описанием кода ошибки) и неподтвержденных (холдирование).
На вкладке Реестры можно настроить рассылку реестров на e-mail:
- Нажмите Новая рассылка.
- Укажите e-mail для отправки реестров. Вы можете добавить несколько адресов.
- Нажмите кнопку Сохранить.
Настройки
На вкладке отображается список сайтов выбранной услуги и выданных токенов API для каждого сайта. На вкладке можно:
- выпустить токен API;
- узнать ключ идентификации сайта (
publicKey
) для интеграции c Платежной формой QIWI без использования API; - получить ключ для авторизации серверных уведомлений;
- создать QR-код для оплаты на произвольную сумму;
- выставить счет через бота Telegram.
Выпуск токенов
Токен — символьная строка, которая используется:
- для аутентификации в QIWI;
- для интеграции и взаимодействия с API QIWI.
Когда может понадобиться повторный выпуск токена:
- добавлен новый сайт после того, как токен был выпущен;
- добавлен новый метод оплаты.
Чтобы выпустить токен:
- Нажмите на нужный сайт в списке на вкладке Настройки.
- Во всплывающем окне заполните поле Комментарий для токена.
-
Нажмите кнопку Сохранить токен.
-
Нажмите ссылку Копировать в буфер для копирования токена. Храните его в недоступном для третьих лиц месте.
Ключ идентификации сайта
Чтобы узнать ключ publicKey
:
- Нажмите на нужный сайт в списке на вкладке Настройки.
- Во всплывающем окне найдите строку Public Key.
- Нажмите ссылку Копировать в буфер для копирования и сохранения ключа.
Ключ для уведомлений
Секретом является ключ серверных уведомлений. Вы можете задать URL сервера для обработки уведомлений или перевыпустить ключ.
-
Нажмите на нужный сайт в списке на вкладке Настройки.
- Чтобы повторно выпустить ключ, нажмите ссылку Перевыпустить в открывшемся окне.
- Чтобы задать URL сервера для обработки уведомлений, в открывшемся окне укажите URL в поле URL для серверных уведомлений и нажмите кнопку Сохранить.
Выставление счетов через Telegram
Сразу после выпуска токена API в окне со списком токенов и ключей сайта доступна ссылка Использовать для выставления счета через телеграм.
Если нажать на ссылку, то откроется чат с платежным ботом в приложении Telegram. Начните диалог командой /start
:
После этого вы можете выставлять счета покупателям через бот Telegram.
Если у вас уже есть токены и вы не хотите выпускать новый, то нажмите кнопку Выставить счет в окне со списком токенов.
Откроется чат с платежным ботом в приложении Telegram. Начните диалог командой /start
и скопируйте любой сохраненный ранее и действующий токен в чат:
После подтверждения вы можете выставлять счета покупателям через этот бот Telegram.
QR-код для оплаты
В окне со списком токенов вашего сайта можно создать QR-код для страницы оплаты. Для этого нажмите на значок рядом со строкой Public Key.
Скачайте или распечатайте созданный код для показа вашим покупателям.
При сканировании кода покупатель перейдет по ссылке на страницу оплаты для выбранного сайта. Сумму покупки покупатель указывает на странице.
Счета
На вкладке доступно выставление счетов покупателям вручную (без интеграции) и просмотр счетов, ранее выставленных в этом разделе.
Выставление счета
- Нажмите кнопку Выставить счет.
-
Выберите сайт для выставления счета и заполните нужные поля.
- Нажмите кнопку Выставить.
-
Отобразится информация о выставленном счете.
В поле Ссылка на форму оплаты отображается ссылка для оплаты счета. Скопируйте ее и передайте покупателю. По этой ссылке покупатель откроет платежную форму, где сможет оплатить покупку.
Список счетов
Список выставленных счетов содержит все счета, выставленные через сайт.
Чтобы посмотреть счет, нажмите на соответствующий элемент списка. Во всплывающем окне отображаются сведения о счете:
- ID счета.
- Текущий статус счета.
- Сайт и сумма счета.
- Ссылка на форму оплаты.
Статусы счетов
Счет может находиться в одном из четырех статусов:
- Оплачен — счет оплачен покупателем.
- Ожидает оплаты — счет не оплачен.
- В процессе оплаты — было несколько неуспешных попыток оплаты.
- Ошибка — при создании счета возникла ошибка. Попробуйте повторно создать счет.
Роли в Личном кабинете
Роли в Личном кабинете различаются:
- Доступными разделами на стартовой странице.
- Доступными действиями на вкладке Услуги.
Администратор
Вид доступа | Список доступных объектов / действий |
---|---|
Разделы на стартовой странице | Услуги, Заявки, Пользователи, Поддержка |
Действия на стартовой странице | Просмотр подключенных услуг Просмотр оставленных заявок Добавление новых пользователей Задать вопросы |
Действия на вкладке Услуги | Просмотр транзакций Сделать возврат Выставление счета Просмотр списка выставленных счетов Настройка рассылки Реестров Создание токена |
Менеджер
Вид доступа | Список доступных объектов / действий |
---|---|
Разделы на стартовой странице | Услуги, Заявки, Поддержка |
Действия на стартовой странице | Просмотр подключенных услуг Просмотр оставленных заявок Задать вопросы |
Действия на вкладке Услуги | Просмотр транзакций Сделать возврат Выставление счета Просмотр списка выставленных счетов Настройка рассылки Реестров Создание токена |
Технический специалист
Вид доступа | Список доступных объектов / действий |
---|---|
Разделы на стартовой странице | Услуги, Поддержка |
Действия на стартовой странице | Просмотр подключенных услуг Задать вопросы |
Действия на вкладке Услуги | Просмотр транзакций Сделать возврат Выставление счета Просмотр списка выставленных счетов Настройка рассылки Реестров Создание токена |
Восстановление пароля от Личного кабинета
-
Откройте ссылку и нажмите Напомнить.
-
Введите ваш e-mail.
-
Проверьте почту — вам придет письмо со ссылкой на смену пароля.