Цифровые коды — подарочные карты, игровые ключи, подписки — давно стали одним из самых востребованных товаров в онлайн-торговле. Нет склада, нет доставки курьером, нет проблем с возвратом физического товара. После оплаты покупатель получает код на почту за несколько секунд. Если вы владеете интернет-магазином и ещё не продаёте цифровые товары — вы упускаете быстрорастущий сегмент.
В этой статье разберём, как именно добавить цифровые коды в свой магазин: что нужно технически, как работает API, как настроить автоматическую доставку и что делать с возвратами.
Почему цифровые коды выгодны для магазина
Продажа цифровых кодов отличается от обычного e-commerce по нескольким ключевым параметрам.
Дополнительный плюс — масштабируемость. Продажа 10 или 10 000 кодов в день технически не отличается: сервер справляется с любым объёмом без расширения команды или склада.
Что нужно технически: три уровня интеграции
Перед тем как выбрать способ подключения, важно понять, какой уровень технической сложности вам подходит. Условно есть три пути.
Уровень 1. Готовый плагин или виджет. Самый простой вариант — установить готовое решение для вашей CMS. Для WordPress это плагин, для Tilda — виджет или embed-блок. Вы получаете витрину товаров, корзину и автодоставку кодов без написания кода. Подходит для малого бизнеса и тех, кто только тестирует направление.
Уровень 2. API-интеграция. Подключение через REST API поставщика. Вы сами строите витрину, обрабатываете заказы и вызываете API для выдачи кода после оплаты. Гибко, но требует разработчика. Подходит для магазинов с собственной командой и нестандартными требованиями к UX.
Уровень 3. White-label платформа. Поставщик предоставляет готовый магазин под вашим брендом. Вы настраиваете внешний вид, домен и ценообразование, а всё остальное — на стороне платформы. Минимум технических усилий при максимальной функциональности.
Подключите цифровые товары через FoxReload
API, плагины для WordPress и Tilda, автодоставка кодов покупателям — всё в одном решении для вашего магазина.
Как работает API: от заказа до выдачи кода
Понимание цикла заказа поможет вам правильно спроектировать интеграцию — независимо от выбранного уровня.
Покупатель выбирает товар
Витрина магазина отображает каталог цифровых товаров. Данные о доступных SKU, ценах и наличии берутся из API поставщика — через вебхук или периодический polling.
Покупатель оплачивает заказ
Платёж проходит через вашу платёжную систему (ЮКасса, CloudPayments, Stripe и другие). После подтверждения оплаты ваша система фиксирует статус заказа как «оплачен».
Запрос к API поставщика
Ваш бэкенд автоматически отправляет POST-запрос к API поставщика с идентификатором товара и количеством. В ответ API возвращает цифровой код или ключ активации.
Доставка кода покупателю
Код отправляется покупателю на email и/или отображается в личном кабинете магазина. Весь цикл занимает от 5 до 30 секунд после оплаты.
Ключевой момент: запрос к API поставщика нужно делать только после подтверждения оплаты — не раньше. Иначе вы рискуете выдать код, не получив деньги. Большинство платёжных шлюзов присылают вебхук с подтверждением — используйте именно его как триггер.
Сравнение способов подключения
Выбор метода интеграции зависит от вашей технической базы, объёма продаж и требований к гибкости.
| Критерий | Плагин / виджет | API-интеграция | White-label |
|---|---|---|---|
| Время запуска | 1–2 дня | 2–4 недели | 3–7 дней |
| Нужен разработчик | Нет | Да | Нет |
| Гибкость дизайна | Ограничена | Полная | Средняя |
| Автодоставка кодов | ✅ | ✅ (нужна настройка) | ✅ |
| Управление возвратами | Через поставщика | Через API | Через поставщика |
| Масштабируемость | Средняя | Высокая | Высокая |
| 🏆 Оптимально для старта | ✅ Малый бизнес | — Средний/крупный | — Без технической команды |
Готовые решения для WordPress и Tilda
Если ваш магазин работает на популярных конструкторах, есть проверенные пути быстрого запуска.
WordPress + WooCommerce. Наиболее распространённая связка для интернет-магазинов. Через плагины, совместимые с FoxReload API, можно за несколько часов добавить каталог цифровых товаров, настроить автодоставку кодов по email и подключить управление запасами. Важно выбирать плагины с поддержкой вебхуков от платёжного шлюза — без этого автоматика не будет работать надёжно.
Tilda. Конструктор меньше подходит для полноценного e-commerce, но для лендинга с небольшим ассортиментом годится. Через блок HTML или embed-виджет можно встроить готовую витрину. Платёжная логика и доставка кодов в этом случае полностью берётся на сторону виджета — ваш Tilda-сайт выступает только как маркетинговая обёртка.
Собственный движок (самописный сайт). Если у вас есть бэкенд на PHP, Node.js или Python — интеграция через REST API даёт максимальный контроль. Документация FoxReload API покрывает получение каталога, создание заказа, проверку статуса и обработку ошибок.
Обработка возвратов и ошибок
Цифровые товары имеют специфику: по закону код, который был показан покупателю, считается переданным. Поэтому возвраты в классическом смысле для цифровых кодов не предусмотрены — и это нужно явно указывать в оферте магазина.
Тем не менее, на практике возникают ситуации, которые требуют реакции:
- Код не пришёл на email. Техническая проблема доставки — код нужно переотправить из личного кабинета или через API.
- Код не активируется. Возможна ошибка на стороне издателя или истёкший срок действия — в этом случае поставщик обязан предоставить замену.
- Дублированный заказ. Если покупатель оплатил дважды из-за сбоя платёжного шлюза — возврат денег за второй заказ делается через платёжную систему, код не выдаётся.
- Ошибка API при выдаче кода. Ваша система должна уметь повторить запрос (retry) и логировать неуспешные попытки для ручной обработки.
Обязательно укажите в оферте и на странице товара, что цифровые коды не подлежат возврату после активации или отображения покупателю. Это соответствует российскому законодательству и защищает вас от злоупотреблений.
Хорошая практика — добавить в личный кабинет покупателя историю заказов с кодами. Это снижает нагрузку на поддержку: покупатель сам может найти код, если потерял письмо.
FAQ
Можно ли продавать цифровые коды без ИП или ООО?
Технически — да, через некоторые платформы как физическое лицо или самозанятый. Но с точки зрения налогообложения и работы с платёжными шлюзами наличие юридического лица значительно упрощает работу и снижает риски.
Сколько времени занимает запуск продаж через API FoxReload?
С готовым плагином для WordPress — от одного до двух рабочих дней. Кастомная API-интеграция с нуля занимает от двух недель в зависимости от сложности вашего магазина и опыта разработчика.
Нужно ли хранить коды у себя на сервере?
Нет. При интеграции через API коды хранятся на стороне поставщика и передаются вам только в момент подтверждённой оплаты. Это снижает риск утечки и упрощает управление запасами.
Как работает ценообразование: можно ли поставить свою наценку?
Да. Поставщик предоставляет оптовую цену, а вы самостоятельно устанавливаете розничную цену в своём магазине. Разница — ваша маржа. Некоторые платформы также предлагают динамическое ценообразование на основе курса валют.
Что делать, если API поставщика недоступен в момент оплаты покупателя?
Ваша система должна реализовать логику повторных попыток (retry) с экспоненциальной задержкой. Если код не удалось получить в течение нескольких минут — заказ переходит в статус «ожидает обработки» и обрабатывается вручную или автоматически после восстановления API. Деньги покупателю не возвращаются автоматически.