Продажа подарочных карт через WhatsApp с API FazerCards

WhatsApp — основной мессенджер в Юго-Восточной Азии, на Ближнем Востоке, в Южной Азии и Латинской Америке: именно в этих регионах спрос на подарочные карты один из самых высоких в мире. Реселлер, подключивший API FazerCards к WhatsApp-боту, может принимать заказы, подтверждать покупки и отправлять коды автоматически — круглосуточно, без витрины и без ручного труда. В этом руководстве разобрана вся цепочка: от нового аккаунта разработчика Meta до готовой интеграции, которая обрабатывает заказы и выдаёт коды за секунды.

Что потребуется

Подготовьте следующее перед началом:

• WhatsApp Business Account (WABA), верифицированный через Meta for Developers
• Отдельный номер телефона, не привязанный к личному аккаунту WhatsApp
• Аккаунт FazerCards с доступом к API — бесплатный 5-дневный Gold-тариф открывает полный доступ к API и каталогу мгновенно, без карты и KYC
• Публичный HTTPS-эндпоинт (VPS, облачная функция или Lambda), доступный для Meta
• Базовые знания Node.js или Python: FazerCards предоставляет официальные SDK для обоих языков (Node: npm install fazercards; Python: pip install fazercards), а также примеры кода в справочнике API

Шаг 1: Создайте приложение WhatsApp Cloud API

В портале Meta for Developers создайте новое приложение типа Business и добавьте к нему продукт WhatsApp. В панели настроек WhatsApp запишите три значения, которые понадобятся во всей интеграции:

1. Phone Number ID — идентификатор отправляющего номера в каждом API-вызове
2. Access token — в продакшне используйте постоянный токен системного пользователя, а не временный токен из интерфейса
3. Webhook Verify Token — произвольная строка, которую Meta возвращает один раз при первичном подключении вебхука. С последующими вебхуками она не приходит: подлинность каждого входящего POST проверяйте по заголовку X-Hub-Signature-256 и секрету приложения

Шаг 2: Запустите вебхук-эндпоинт

Meta отправляет каждое входящее сообщение пользователя на ваш вебхук как HTTP POST. У эндпоинта две задачи:

1. Ответить на первоначальный GET-запрос (рукопожатие верификации), вернув значение hub.challenge — это подтверждает, что URL под вашим контролем
2. Принимать POST-тела с событиями сообщений, парсить текст и возвращать HTTP 200 в течение 20 секунд во избежание повторных попыток доставки

Структурируйте обработчик так, чтобы он сразу подтверждал получение (возвращал 200), а затем передавал обработку заказа в асинхронный воркер. Это предотвращает таймаут, если вызов API FazerCards займёт несколько секунд. Аналогичный асинхронный паттерн для стороны доставки описан в документации по вебхукам FazerCards.

Шаг 3: Разработайте меню товаров и команды

Держите команды короткими — клиенты вводят их с мобильного телефона:

• LIST — бот возвращает текстовое меню категорий подарочных карт из каталога FazerCards
• BUY [товар] [номинал] — запускает поиск товара и запрос подтверждения заказа
• STATUS [order_id] — возвращает статус доставки конкретного заказа

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

Шаг 4: Оформляйте заказы через API FazerCards

Когда клиент подтверждает покупку (например, отвечает ДА), вызывайте эндпоинт заказов FazerCards, описанный в документации. В теле запроса передаются идентификаторы товара из каталога и количество, а в заголовке Idempotency-Key — уникальная строка на каждый заказ (хорошо подходит комбинация WhatsApp message ID и идентификатора вашего аккаунта). Храните ключ вместе с записью о заказе. Если Meta доставит один и тот же вебхук дважды из-за сетевого сбоя, ключ идемпотентности предотвратит двойное списание в FazerCards.

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

Шаг 5: Отправьте код обратно через WhatsApp

Используйте эндпоинт Messages в WhatsApp Cloud API для доставки кода. Meta требует одобренный шаблон сообщения при первом контакте с новым номером; обычные текстовые сообщения работают для ответов в открытом окне разговора (24 часа). Сформатируйте сообщение о доставке чётко:

• Название и номинал подарочной карты
• Код или PIN подарочной карты
• Инструкция по активации (в каталоге FazerCards есть примечания по категориям)
• Контакт поддержки на случай нерабочего кода

Размещайте код в отдельном, чётко обозначенном поле, чтобы клиент легко скопировал его с мобильного. Никогда не прячьте код в середину абзаца.

Шаг 6: Обработка ошибок, дублей и сбоев доставки

Три сценария требуют явных обработчиков:

Ошибка товара или отсутствие на складе — если FazerCards возвращает ошибку (товар недоступен или нет на складе), немедленно ответьте клиенту с извинением и предложите альтернативы из той же категории. Деньги не списывайте.

Задержка доставки — если выполнение затягивается дольше ожидаемого, отправьте уведомление «заказ обрабатывается», а затем доставьте код следующим сообщением. Молчание после подтверждения оплаты разрушает доверие клиента.

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

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

Что вы получите

После завершения этой настройки у вас будет круглосуточный канал продаж, который:

• Принимает заказы через мессенджер, которым клиенты уже пользуются
• Доставляет коды из каталога 10 000+ товаров по 700+ играм
• Обрабатывает дубли, ошибки и таймауты без ручного вмешательства

WhatsApp особенно эффективен для оптовых заказов от небольших региональных реселлеров — многие предпочитают быстрое сообщение работе с веб-порталом. Если ваша аудитория также использует Telegram, логика заказов идентична; специфику канала смотрите в руководстве по Telegram-боту.

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

Получите бесплатный 5-дневный Gold-тариф — полный доступ к API без карты и KYC — и прогоните полный цикл от заказа до доставки на нескольких небольших реальных заказах, прежде чем подключать реальный номер WhatsApp: триал работает на боевом API, а не в песочнице.