Помощь

Информация по оплате донатов доступна на странице Информация для плательщиков.

Если вы администратор сообщества ВКонтакте - перед работой с приложением настоятельно рекомендуем полностью ознакомиться с содержимым этой страницы. При возникновении каких-либо вопросов обратитесь в нашу техподдержку.

1. Установка приложения в сообщество

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

Внимание! Первичную установку и настройку приложения необходимо производить с ПК. Из-за особенностей ВКонтакте виджет невозможно устанавливать в группу с мобильных устройств.

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

Такое же значение нужно установить для пункта "видимость виджета приложения" - это необходимо для того, чтобы виджет в группе видели все пользователи, а не только администраторы.

Настройки в сообществе

Панель управления

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

Cписок операций
В этом разделе отображается полный список платежных операций в вашем сообществе.
Выплаты
Здесь вы можете указать ваши реквизиты для вывода средств из приложения. Для вывода доступны следующие способы: QIWI кошелёк, Webmoney, Яндекс.Деньги, банковская карта или счет мобильного телефона. Подробная информация о комиссиях доступна на странице условия оплаты.
Настройки приложения
Здесь вы можете настроить внешний вид страницы, на которую заходят ваши подписчики, чтобы сделать пожертвование. Более подбробно смотрите в разделе 2. Настройка страницы оплаты.
Настройка виджета
Виджет - специальный блок в вашем сообществе, куда можно вывести информацию о донатах. В этом разделе вы можете гибко настроить вывод виджета на странице вашего сообщества. Более подробную информацию смотрите в разделе 3. Настройка виджета.
Настройка обложки
Здесь можно настроить нанесение донатеров на обложку вашего сообщества. Более подробно процесс настройки описан в разделе 4. Настройка обложки.
Уведомления
Вы можете включить уведомления о новых донатах, выплатах или изменении настроек приложения. Уведомления отправляются с помощью личных сообщений ВК от нашего сообщества. Для получения уведомлений убедитесь, что вы разрешили получение сообщений от нашего сообщества.
API
Вы можете использовать API сервиса в своих проектах. С помощью API вы можете получить список донатов в вашем сообществе. Более подробная документация по API доступна прямо внутри приложения в этом разделе.
2. Настройка страницы оплаты

Страница оплаты состоит из трех основных блоков - формы оплаты, описания проекта и списка донатов.

В форме оплаты вы можете настроить следующие элементы:

  • Основной текст приложения. В тексте вы можете поприветствовать пользователя и вкратце рассказать, на что вы хотели бы собрать средства. В этом тексте можно использовать переменные {first_name} и {last_name}, которые будут автоматически заменены на имя и фамилию пользователя соответственно.
  • Текст в поле ввода сообщения отображается, если поле ввода пустое. Здесь можно написать что-то вроде "Напиши админу сообщение".
  • Вы можете задать текст кнопки оплаты, а также цвет этой кнопки и цвет текста в кнопке. Например, можно перекрасить кнопку в фирменные цвета вашего сообщества.

В разделе "Описание проекта" вы можете подробно рассказать пользователям о вашем сообществе и вашей деятельности. Вы можете задать до 10 различных блоков, в которых может содержаться обычный текст, картинка или видео с YouTube или ВК. Для вставки картинки необходимо указать URL изображения, размещенного ВКонтакте (ПКМ по картинке - копировать URL изображения). Для вставки видео достаточно просто указать ссылку на видео.

3. Настройка виджета

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

В настройках вы можете выбрать один из трёх типов виджета:

Краудфандинг - в таком виджете можно указать цель сбора средств и вывести полоску прогресса, которая постепенно заполняется с поступлением новых донатов. При достижении целевой суммы полоска перекрасится в зелёный цвет.

Пример виджета «Краудфандинг»

Плитки - здесь выводятся большие аватарки донатеров, а также их имена, сообщение и сумма доната. При отсутствии донатеров будет выводиться аватарка вашей группы и указанный вами текст, например "Место свободно - занять место!". Такие приёмы повышают конверсию.

Пример виджета «Плитки»

Список - этот тип похож на "Плитки", но здесь можно вывести до 6 донатеров. Также в виджете "Список" можно вывести время, когда были сделаны донаты. Аватарки при таком типе виджета становятся меньше по размеру по сравнению с "Плитками". Кроме того, есть два типа списка - обычный и компактный. При компактном типе кнопка "оплатить" отображается справа от пункта списка, а текст сообщения обрезается до 100 символов. При обычном типе списка текст сообщения ограничивается длиной в 300 символов, а кнопка находится под этим текстом.

Пример виджета «Список»

4. Настройка обложки

Вы можете выводить донаты на обложку вашего паблика. В первую очередь необходимо установить базовую обложку в сообщество. Донаты будут наноситься поверх этой обложки. Вы можете использовать наш шаблон (.PSD) для того, чтобы оформить вашу обложку в соответствии с механикой отрисовки донатов.

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

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

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

Пошаговая инструкция по настройке обложки

Типы обложек

Тип 1. На такую обложку может быть нанесено от 1 до 6 донатов. Донаты отображаются горизонтально, с большой аватаркой, именем и фамилией пользователя под ней. Вывод суммы доната можно отключить. Вы можете настроить:

  • Обводку аватарки
  • Радиус закругления аватарки (0 - аватарка будет квадратной, 75 - круглой)
  • Цвет, шрифт и обводку текста
  • Выравнивание донатов по горизонтали

Несколько примеров обложек первого типа (картинки кликабельны):

Тип 2. На такую обложку может быть нанесено от 1 до 3 донатов. В отличие от первого типа, здесь также будет выводиться сообщение от пользователя, если он его оставил. Несколько примеров обложки второго типа:

5. API

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

Обращение к API осуществляется путём отправки POST или GET запроса по адресу https://api.vkdonate.ru. На запросы к API действует ограничение - не более одного запроса в секунду. В случае недоступности данного адреса попробуйте использовать альтернативный эндпоинт - https://vkdonate.ru/api

В запросе обязательно указывать параметр key - это ваш секретный ключ API. Вторым обязательным параметром является action - выполняемое действие. В зависимости от значения action необходимо передавать различные дополнительные параметры, как указано в таблице ниже.

Ответы от сервера приходят в формате JSON. Структура ответов также представлена в таблице ниже.

action Описание
donates

Получение списка донатов для сообщества. Не более 50 донатов за один запрос.

Дополнительные параметры:
count - количество донатов (от 1 до 50, по умолчанию 10)
offset - смещение для поиска более ранних донатов (по умолчанию 0)
sort - порядок сортировки донатов. Возможные значения - date (по дате), sum (по сумме доната). По умолчанию date.
order - тип сортировки (asc - по возрастанию, desc - по убыванию). По умолчанию desc.

Сервер возвращает объект со следующими полями:
count - общее количество донатов в вашем сообществе
donates - массив объектов донатов. Каждый объект состоит из следующих полей:
'id' : уникальный ID платежа (целое число)
'uid' : VK ID донатера (целое число)
'date' : дата доната в формате YYYY-MM-DD HH:MM:SS (строка, время московское)
'sum' : сумма доната, целое число
'msg' : сообщение от пользователя
'anon' : если донат отправлен анонимно, то 1. Иначе 0.
'visible' : видимость доната в группе (меняется в панели управления). 0 или 1.

Пример запроса:
https://api.vkdonate.ru?action=donates&count=20&sort=sum&key=...

В результате запроса вы получите объект с 20 донатами, отсортированными по сумме в порядке убывания.