Как настроить продажу подарочных сертификатов на сайте
Коротко
Путь 1 — готовая интеграция: Tilda, WordPress, 1С-Битрикс. Подходит, если сайт на одной из этих платформ.
Путь 2 — API: подходит для любого сайта и любого сценария, нужен разработчик.
Сценарии 1–3: номер сертификата заводится заранее в личном кабинете.
Сценарии 4 и 5: номер можно генерировать через API при каждой продаже.
Путь 1. Готовая интеграция с сайтом
Если сайт работает на популярной платформе, сертификаты можно продавать без разработки — через готовый модуль или плагин. Как подключить сайт к kilbil — как подключить свой сайт или интернет-магазин.
Путь 2. Продажа по API
API подходит, если сайт самописный или готовой интеграции для него нет. Смысл простой: при покупке сертификата сайт обращается к kilbil, а клиент получает номер сертификата и может пользоваться им на кассе или в боте.
Что нужно, чтобы начать:
Доступ к API и ключ интеграции — документация и тестовый контур описаны в разделе документация API.
Выбранный сценарий работы с сертификатами — о различиях ниже и в статье сценарии работы с сертификатами и какой выбрать.
Разработчик на стороне сайта: обработка оплаты, вызов методов и отправка номера клиенту.
Чем сценарии отличаются при продаже на сайте
Сценарий | Откуда берется номер сертификата | Что делает сайт при покупке |
|---|---|---|
1 | Заранее заведен в личном кабинете, раздел «Карты» | Пополняет баланс заранее заведенного сертификата и передает номер клиенту |
2 | Заранее заведен в личном кабинете, у товара стоит признак «Товар-абонемент» | Пополняет баланс в момент продажи |
3 | Заранее заведен в личном кабинете, у товара стоит признак «Подарочный сертификат» | Пополняет баланс в момент продажи |
4 | Генерируется через API — в личном кабинете создана программа сертификатов с диапазоном номеров | Создает новый сертификат и начисляет на него баланс |
5 | Генерируется через API так же, как в сценарии 4 | Создает новый сертификат и начисляет баланс |
Какие методы API используются
Список программ сертификатов — чтобы получить идентификатор программы для генерации.
Генерация сертификата — создает новый номер в сценариях 4 и 5.
Поиск сертификата — проверка, что сертификат существует и активен.
Добавление или обновление клиента — через него в сценариях 1–3 пополняется баланс сертификата.
Подробные описания методов и примеры запросов — в документации API kilbil. Общие сценарии интеграции сайта с kilbil — сценарии интеграции по API.
Что важно помнить
Сертификат продается только после оплаты. Сначала сайт принимает деньги, потом начисляет баланс.
В сценариях 1–3 номера готовятся заранее. Заранее заведенные номера нужно пополнять, создать новый через API нельзя.
В сценариях 4 и 5 нужна программа сертификатов. Без нее генерация номеров не работает.
Клиенту нужен номер или штрихкод. Именно по нему сертификат применяется на кассе.
Есть тестовый контур. Интеграцию можно проверить до запуска на реальных клиентах.
Если что-то не получилось
API возвращает ошибку доступа. Проверьте ключ интеграции и права на методы сертификатов.
Не получается создать сертификат. Проверьте, что в личном кабинете есть программа сертификатов с диапазоном номеров.
Баланс не начислился. Проверьте, что номер сертификата существует и запрос прошел успешно.
Клиент не может применить сертификат. Проверьте, что сертификат активирован и на нем есть баланс.
Нужна помощь. Напишите в техподдержку kilbil.
