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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Кроме данных, на карту приходят сообщения сценариев «Автоматизации». Что можно так отправлять и сколько уведомлений в сутки — в гайде Сообщения на карты Wallet.

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

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

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

Как гость получает карту

Карта личная: на ней баланс, уровень и номер конкретного гостя, а по её коду кассир его узнаёт. Поэтому общей ссылки или QR-кода «карта для всех» нет — сначала система должна понять, кто перед ней. Способов три:

• В боте. Гость нажимает «Моя карта», под сообщением с балансом — «Добавить в Apple Wallet» или «Добавить в Google Wallet». Работает и в Telegram, и в MAX: гость выбирает, где ему удобнее.
• С визитки. Страница-визитка и её QR-код на столе одной кнопкой ведут гостя в бота — карта ждёт его там. Гость, который открыл визитку из своего приложения (Профиль → «Ссылки»), сразу видит на ней свою карту с теми же кнопками «Добавить в Apple Wallet» и «Добавить в Google Wallet».
• По ссылке от вас. Подписчики → гость → Карта Wallet, напротив нужной площадки — Ссылка на карту, затем Скопировать. Отправьте ссылку гостю в любом мессенджере. Бот для этого не нужен: так карту получает и гость, который пришёл из кассы и в бота не заходил.

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

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

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

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