Как настроить продажу подарочных сертификатов на сайте

Подарочные сертификаты можно продавать на сайте двумя путями: через готовую интеграцию с CMS или по API kilbil. По API работают все сценарии, но есть разница: в сценариях 1–3 номер сертификата заводится заранее, а в сценариях 4 и 5 его можно сгенерировать через API в момент покупки.

Коротко

  • Путь 1 — готовая интеграция: Tilda, WordPress, 1С-Битрикс. Подходит, если сайт на одной из этих платформ.

  • Путь 2 — API: подходит для любого сайта и любого сценария, нужен разработчик.

  • Сценарии 1–3: номер сертификата заводится заранее в личном кабинете.

  • Сценарии 4 и 5: номер можно генерировать через API при каждой продаже.


Путь 1. Готовая интеграция с сайтом

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


Путь 2. Продажа по API

API подходит, если сайт самописный или готовой интеграции для него нет. Смысл простой: при покупке сертификата сайт обращается к kilbil, а клиент получает номер сертификата и может пользоваться им на кассе или в боте.

Что нужно, чтобы начать:

  1. Доступ к API и ключ интеграции — документация и тестовый контур описаны в разделе документация API.

  2. Выбранный сценарий работы с сертификатами — о различиях ниже и в статье сценарии работы с сертификатами и какой выбрать.

  3. Разработчик на стороне сайта: обработка оплаты, вызов методов и отправка номера клиенту.

Чем сценарии отличаются при продаже на сайте

Сценарий

Откуда берется номер сертификата

Что делает сайт при покупке

1

Заранее заведен в личном кабинете, раздел «Карты»

Пополняет баланс заранее заведенного сертификата и передает номер клиенту

2

Заранее заведен в личном кабинете, у товара стоит признак «Товар-абонемент»

Пополняет баланс в момент продажи

3

Заранее заведен в личном кабинете, у товара стоит признак «Подарочный сертификат»

Пополняет баланс в момент продажи

4

Генерируется через API — в личном кабинете создана программа сертификатов с диапазоном номеров

Создает новый сертификат и начисляет на него баланс

5

Генерируется через API так же, как в сценарии 4

Создает новый сертификат и начисляет баланс

Главное отличие: в сценариях 1–3 создать новый номер через API нельзя. Номера сертификатов готовятся заранее в личном кабинете, API только пополняет их баланс. В сценариях 4 и 5 номер можно создать в момент продажи — для этого в личном кабинете должна быть программа подарочных сертификатов с заданным диапазоном генерации.

Какие методы API используются

  • Список программ сертификатов — чтобы получить идентификатор программы для генерации.

  • Генерация сертификата — создает новый номер в сценариях 4 и 5.

  • Поиск сертификата — проверка, что сертификат существует и активен.

  • Добавление или обновление клиента — через него в сценариях 1–3 пополняется баланс сертификата.

Подробные описания методов и примеры запросов — в документации API kilbil. Общие сценарии интеграции сайта с kilbil — сценарии интеграции по API.


Что важно помнить

  • Сертификат продается только после оплаты. Сначала сайт принимает деньги, потом начисляет баланс.

  • В сценариях 1–3 номера готовятся заранее. Заранее заведенные номера нужно пополнять, создать новый через API нельзя.

  • В сценариях 4 и 5 нужна программа сертификатов. Без нее генерация номеров не работает.

  • Клиенту нужен номер или штрихкод. Именно по нему сертификат применяется на кассе.

  • Есть тестовый контур. Интеграцию можно проверить до запуска на реальных клиентах.

Если что-то не получилось

  • API возвращает ошибку доступа. Проверьте ключ интеграции и права на методы сертификатов.

  • Не получается создать сертификат. Проверьте, что в личном кабинете есть программа сертификатов с диапазоном номеров.

  • Баланс не начислился. Проверьте, что номер сертификата существует и запрос прошел успешно.

  • Клиент не может применить сертификат. Проверьте, что сертификат активирован и на нем есть баланс.

  • Нужна помощь. Напишите в техподдержку kilbil.

Что дальше