Вопросы
bss@qiwi.com
NAV Navbar

Общие сведения

Инструкция предназначена для партнеров, подключающихся по Протоколу приема платежей.

Из инструкции вы узнаете:

Начало работы

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

Вход в Личный кабинет

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

Перейдите по ссылке из письма для подтверждения почтового адреса.

mail-confirm

Ссылка направит вас на форму для установления пароля от Личного кабинета. Укажите пароль и нажмите Войти для входа в Личный кабинет.

first-login

Что делать, если не пришло письмо

  1. Пройдите по ссылке и нажмите Напомнить.

    mail-forgot

  2. Введите ваш e-mail и нажмите Продолжить.

    restore-password

  3. Проверьте почту — вам придет письмо со ссылкой на смену пароля.

Главная страница Личного кабинета

Вход в Личный кабинет выполняется по e-mail и паролю, который вы придумали при подтверждении e-mail.

После входа вы попадаете на главную страницу Личного кабинета, где доступны 4 вкладки:

  1. Услуги.
  2. Заявки.
  3. Пользователи (только для роли Администратор, подробнее в разделе Роли в Личном кабинете).
  4. Поддержка.

Услуги

На вкладке отображаются ваши подключенные сайты и ID.

services

Нажмите на название услуги и вы перейдете в Личный кабинет подключенного сайта. Подробнее в разделе Личный кабинет подключенной услуги.

Заявки

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

requests

Пользователи

На вкладке настраивается доступ ваших сотрудников в Личный кабинет:

  1. Нажмите кнопку Пригласить пользователя внизу списка сотрудников.

    user_add

  2. Укажите e-mail и выберите роль сотрудника (Тех.специалист, Менеджер, Администратор). Подробнее о ролях см. раздел Роли в Личном кабинете.
  3. Нажмите кнопку Создать.

    user_add_role

Добавленный пользователь получит письмо со ссылкой для перехода в Личный кабинет.

Поддержка

На вкладке можно задать вопрос специалистам Службы поддержки. Заполните форму и нажмите кнопку Отправить.

ask-question

Личный кабинет подключенной услуги

В Личном кабинете доступны вкладки:

Транзакции

На вкладке отображается список транзакций по вашим услугам.

transactions

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

transaction-info

Для просмотра детальной информации по транзакции (тип карты, сведения о плательщике) нажмите Подробно.

Также вы можете:

  1. Выберите в поле рядом со строкой поиска атрибут, по которому вы хотите искать транзакции:
    • ID транзакции — точное соответствие.
    • Номер счета — точное соответствие.
    • Номер карты — в свободном формате, но обязательно либо первые несколько цифр, либо символ * и последние цифры. Например:
      • 411111*1111
      • 411111
      • *1111
    • Код авторизации — точное соответствие.
    • Имя покупателя — точное соответствие.
    • Email — точное соответствие
    • Телефон — точное соответствие.
    • Пользовательские поля — точное соответствие.
  2. Укажите в строке поиска значение выбранного атрибута и система автоматически загрузит список найденных транзакций.

transaction-search

Отбор транзакций с помощью фильтров

Вы можете отфильтровать список транзакций по заданным признакам:

  1. Нажмите на значок filter b Фильтр и выберите параметры отбора транзакций (укажите данные либо выберите из выпадающего списка). Доступны фильтры для отбора:
    • Дата — Дата или период дат транзакции. Доступны предустановленные фильтры Сегодня, Вчера и пр.
    • Сумма от — Минимальная сумма транзакции.
    • Сумма до — Максимальная сумма транзакции.
    • Тип — Тип транзакции (Оплаты, Возвраты).
    • Статус — Статус транзакции. Возможные статусы транзакций:
      • Проведенные — оплата прошла успешно.
      • Новые — транзакции, по которым не было завершенной попытки оплаты (например, пользователь не проходил на 3-D Secure, или ушел со страницы 3-D Secure).
      • Отклоненные — оплата, которую отклонили (причина отклонения отображается при просмотре транзакции).
    • Сайт — Услуга, по которой была транзакция.
  2. Нажмите кнопку Найти. Список отобразит все транзакции, соответствующие выбранным фильтрам.

filter

Шаблон отображения транзакций

Вы можете создать собственный шаблон отображения списка транзакций:

  1. Нажмите кнопку template b Шаблон.
  2. Нажмите кнопку Создать новый.

    template-button

  3. Выберите поля для отображения. Чтобы настроить порядок столбцов в списке транзакций, перетаскивайте поля.

    template-button

  4. Нажмите кнопку Сохранить.

Чтобы воспользоваться созданным шаблоном, нажмите кнопку template b Шаблон и выберите шаблон во всплывающем окне. Затем нажмите Выбрать.

template-apply

Вид списка транзакций изменится в соответствии с шаблоном.

template-apply-result

Возврат транзакций

  1. Нажмите на выбранную транзакцию в списке на вкладке Транзакции.
  2. В открывшемся окне нажмите Сделать возврат.

  3. Заполните поля Причина возврата, Сумма.

    txn-return-3

  4. Нажмите Вернуть.
  5. Проверьте информацию о возврате и закройте окно.

    txn-return-4

Документы

Вкладка содержит две вложенных вкладки — Реестры и Акты. Вкладка Акты находится в разработке.

Реестры

Реестр в Личном кабинете содержит список всех транзакций, в том числе неуспешных (с описанием кода ошибки) и неподтвержденных (холдирование).

На вкладке Реестры можно настроить рассылку реестров на e-mail:

  1. Нажмите Новая рассылка.
  2. Укажите e-mail для отправки реестров. Вы можете добавить несколько адресов.
  3. Нажмите кнопку Сохранить.

Настройки

На вкладке отображается список сайтов выбранной услуги и выданных токенов API для каждого сайта. На вкладке можно:

tokens-sites

Выпуск токенов

Токен — символьная строка, которая используется:

Когда может понадобиться повторный выпуск токена:

Чтобы выпустить токен:

  1. Нажмите на нужный сайт в списке на вкладке Настройки.
  2. Во всплывающем окне заполните поле Комментарий для токена.
  3. Нажмите кнопку Сохранить токен.

    token

  4. Нажмите ссылку Копировать в буфер для копирования токена. Храните его в недоступном для третьих лиц месте.

    token

Ключ идентификации сайта

Чтобы узнать ключ publicKey:

  1. Нажмите на нужный сайт в списке на вкладке Настройки.
  2. Во всплывающем окне найдите строку Public Key.
  3. Нажмите ссылку Копировать в буфер для копирования и сохранения ключа.

Ключ для уведомлений

Секретом является ключ серверных уведомлений. Вы можете задать URL сервера для обработки уведомлений или перевыпустить ключ.

  1. Нажмите на нужный сайт в списке на вкладке Настройки.

    callback-key

  2. Чтобы повторно выпустить ключ, нажмите ссылку Перевыпустить в открывшемся окне.
  3. Чтобы задать URL сервера для обработки уведомлений, в открывшемся окне укажите URL в поле URL для серверных уведомлений и нажмите кнопку Сохранить.

Выставление счетов через Telegram

Сразу после выпуска токена API в окне со списком токенов и ключей сайта доступна ссылка Использовать для выставления счета через телеграм.

Если нажать на ссылку, то откроется чат с платежным ботом в приложении Telegram. Начните диалог командой /start:

invoice-tg-start

После этого вы можете выставлять счета покупателям через бот Telegram.

Если у вас уже есть токены и вы не хотите выпускать новый, то нажмите кнопку Выставить счет в окне со списком токенов.

invoice-tg-button

Откроется чат с платежным ботом в приложении Telegram. Начните диалог командой /start и скопируйте любой сохраненный ранее и действующий токен в чат:

invoice-tg

После подтверждения вы можете выставлять счета покупателям через этот бот Telegram.

QR-код для оплаты

В окне со списком токенов вашего сайта можно создать QR-код для страницы оплаты. Для этого нажмите на значок qr b рядом со строкой Public Key.

qr-code

Скачайте или распечатайте созданный код для показа вашим покупателям.

qr-code

При сканировании кода покупатель перейдет по ссылке на страницу оплаты для выбранного сайта. Сумму покупки покупатель указывает на странице.

Счета

На вкладке доступно выставление счетов покупателям вручную (без интеграции) и просмотр счетов, ранее выставленных в этом разделе.

Выставление счета

  1. Нажмите кнопку Выставить счет.
  2. Выберите сайт для выставления счета и заполните нужные поля.

    invoice

  3. Нажмите кнопку Выставить.
  4. Отобразится информация о выставленном счете.

    invoice created

В поле Ссылка на форму оплаты отображается ссылка для оплаты счета. Скопируйте ее и передайте покупателю. По этой ссылке покупатель откроет платежную форму, где сможет оплатить покупку.

Список счетов

Список выставленных счетов содержит все счета, выставленные через сайт.

invoices

Чтобы посмотреть счет, нажмите на соответствующий элемент списка. Во всплывающем окне отображаются сведения о счете:

Статусы счетов

Счет может находиться в одном из четырех статусов:

Роли в Личном кабинете

Роли в Личном кабинете различаются:

Администратор

Вид доступа Список доступных объектов / действий
Разделы на стартовой странице Услуги, Заявки, Пользователи, Поддержка
Действия на стартовой странице Просмотр подключенных услуг
Просмотр оставленных заявок
Добавление новых пользователей
Задать вопросы
Действия на вкладке Услуги Просмотр транзакций
Сделать возврат
Выставление счета
Просмотр списка выставленных счетов
Настройка рассылки Реестров
Создание токена

Менеджер

Вид доступа Список доступных объектов / действий
Разделы на стартовой странице Услуги, Заявки, Поддержка
Действия на стартовой странице Просмотр подключенных услуг
Просмотр оставленных заявок
Задать вопросы
Действия на вкладке Услуги Просмотр транзакций
Сделать возврат
Выставление счета
Просмотр списка выставленных счетов
Настройка рассылки Реестров
Создание токена

Технический специалист

Вид доступа Список доступных объектов / действий
Разделы на стартовой странице Услуги, Поддержка
Действия на стартовой странице Просмотр подключенных услуг
Задать вопросы
Действия на вкладке Услуги Просмотр транзакций
Сделать возврат
Выставление счета
Просмотр списка выставленных счетов
Настройка рассылки Реестров
Создание токена

Восстановление пароля от Личного кабинета

  1. Откройте ссылку и нажмите Напомнить.

    mail-forgot

  2. Введите ваш e-mail.

    restore-password

  3. Проверьте почту — вам придет письмо со ссылкой на смену пароля.