Настройка карт Wallet

Карта лояльности в Apple Wallet и Google Кошельке: макет, поля и выдача гостям через бота.

Что получится

Гость нажимает «Моя карта» в вашем боте → «Добавить в Apple Wallet» (или Google) → ваша карта с логотипом, балансом бонусов и QR-кодом живёт у него среди банковских карт. Сертификаты Apple/Google не нужны — выпуск уже настроен на нашей стороне, вы оформляете только внешний вид.

Шаг 1. Включите площадки

Кабинет → Интеграции → Карты Wallet. Вверху — тумблеры Google Wallet и Apple Wallet: включите те, что нужны (обычно обе).

Шаг 2. Оформите макет

На той же странице:

• Цвета макета — фон, заголовки, текст. Справа живой предпросмотр карты (лицевая и обратная сторона) — все правки видны сразу.
• Изображения — логотип (квадратный, лучше на прозрачном фоне), PUSH-иконка, баннер (широкая картинка на карте).
• Поля карты — название программы («Клуб …»), подпись баланса («Бонусы»), описание, адрес, телефон, условия.
• Код — QR или штрих-код: то, что кассир сканирует для начисления.

Нажмите Сохранить.

Шаг 3. Проверьте демо-карту

Кнопки под предпросмотром: Проверить в Google Wallet — откроет тестовую карту на текущих настройках; Открыть демо Apple-карту — то же для iPhone (откройте страницу кабинета на телефоне). Убедитесь, что цвета и логотип выглядят как задумано.

Шаг 4. Настройте кнопку «Моя карта» в боте

Интеграции → Telegram → Меню → Моя карта → Настроить:

• текст сообщения (макросы {имя} {баланс} {карта} {уровень} — вставка чипами);
• кнопки «Добавить в Google Wallet» / «Добавить в Apple Wallet» — можно переименовать или отключить каждую. Если площадка выключена в Картах Wallet — кнопка недоступна и здесь (подсказка приведёт куда нужно).

У MAX-бота — свой набор кнопок, настраивается так же на его странице.

Шаг 5. Проверьте путь гостя

В своём боте: «Моя карта» → сообщение с балансом → «Добавить в …» → карта в телефоне. Номер карты и QR совпадают с карточкой гостя в кабинете.

Шаг 6. Живая карта: баланс обновляется сам

Выданная карта — не картинка на момент выдачи, а зеркало карточки гостя. Изменился баланс бонусов, поднялся уровень, поправили имя или номер карты — карта в телефоне обновляется сама, без перевыпуска. По важным изменениям (бонусы, уровень) гость видит уведомление на экране блокировки; смена оформления проходит тихо — будить человека из-за нового логотипа незачем.

Блок Интеграции → Карты Wallet → Живая карта показывает:

• сколько карт реально живёт в телефонах и сколько гостей нажали кнопку, но карту так и не сохранили;
• Проверить связь — состояние Apple и Google прямо сейчас;
• Обновить макет на выданных картах — перерисовать уже выданные карты после смены цветов или логотипа (сначала сохраните настройки).

В карточке гостя (Подписчики → гость) есть блок Карта Wallet: состояние по каждой площадке, Ссылка на карту (её можно отправить гостю в любом мессенджере — бот для этого не нужен), Обновить карту сейчас и история обновлений — чем ответить, если гость говорит «у меня показывает старый баланс».

Частые вопросы

• Гость удалил карту — не страшно: кнопки в боте и ссылка из карточки выдают её заново в любой момент. В карточке гостя такая карта помечена «гость удалил карту».
• «Ссылка выдана, карта не сохранена» — гость открыл ссылку, но до конца не добавил карту. Обновлять нечего: пока карта не в телефоне, слать в неё нечего.
• Поменяли макет — новые карты выйдут в новом оформлении, а уже выданные обновит кнопка Обновить макет на выданных картах.
• Гость не видит новый баланс — откройте историю обновлений в его карточке: там видно, ушло ли обновление и что помешало.