Зміст:

1. Про функціонал і важливі примітки.
2. Налаштування Apple Wallet
3. Налаштування Google Wallet
4. Індивідуальні картки для груп клієнтів (рівні лояльності)
5. Приклади використання
6. Поширені запитання (FAQ)

Про функціонал:

Клієнт закладу може додати свою кешбек-картку до гаманця смартфона — Apple Wallet на iPhone або Google Wallet на Android. На картці відображаються: баланс кешбеку, ім'я клієнта, номер телефону, QR- або штрих-код для сканування на касі, а також рівень лояльності (якщо в акаунті налаштовані групи клієнтів). Баланс на картці оновлюється автоматично після кожної зміни кешбеку.

Важливі примітки:

1. Функція доступна лише акаунтам, у плані підписки яких увімкнена опція Digital Wallet. Без неї розділ не відображається в адмінці, а кнопки не з'являються на сайті.
2. Кнопка «Add to Apple Wallet» показується тільки в Safari на пристроях Apple (iPhone, iPad, Mac). Кнопка «Add to Google Wallet» — на Android та в інших браузерах. Це нормальна поведінка, а не помилка.
3. Валюта балансу на картці відповідає валюті акаунта.

Після налаштування функціоналу на сторінці кешбеку сайту закладу з'являється кнопка «Add to Apple Wallet» або «Add to Google Wallet» (залежно від пристрою клієнта). Кнопки також доступні в картці лояльності з QR-кодом.

• iPhone (Safari): натискання кнопки завантажує пас, клієнт підтверджує «Додати» — картка в гаманці.
• Android: натискання відкриває сторінку Google з кнопкою «Save to Google Wallet».

Після додавання кнопка на сайті зникає — картку вже додано.
Після кожного нарахування чи списання кешбеку картка оновлюється сама протягом кількох хвилин.

Налаштування Apple Wallet

1. В Панелі керування перейдіть у вкладку Маркетинг.
2. Оберіть вкладку Digital Wallet = Apple Wallet.

3. У вкладці Загальні активуйте функцію Apple Wallet та натисніть Зберегти.

4. Перейдіть у вкладку Конструктор та налаштуйте відповідні поля згідно вимог інформерів.

• Текст логотипу — короткий текст поруч із лого у шапці картки.
• Назва організації — повна назва закладу.
• Опис — службовий опис картки.
• Колір фону / Колір тексту / Колір підписів — кольори картки у форматі #RRGGBB.
• Підпис заголовка — напис над балансом (типово CASHBACK).
• Підпис основного поля — напис під ім'ям клієнта (типово CUSTOMER).
• Підпис додаткового поля — напис над телефоном (типово PHONE).
• Тип штрих-коду — QR Code, PDF417, Aztec, Code 128 або «Немає».
• Дані штрих-коду — шаблон вмісту коду. Доступні плейсхолдери: {{userId}}, {{userToken}}, {{phone}}, {{userName}}.
• Текст гео-сповіщення — повідомлення на екрані блокування, підтримує {{userName}}.
• Зображення: іконка 58×58 (обов'язкова), логотип 320×100, банер 750×246, зображення футера 572×30.

5. Після оформлення картки - перейдіть у вкладку Адреси. Тут обираються адреси закладу, поблизу яких клієнт отримає гео-сповіщення з карткою.

• Гео-сповіщення - коли тоглер увімкнено, клієнти отримують push-сповіщення, коли знаходяться поблизу одного з обраних закладів. Apple Wallet: використовує сервіси геолокації iOS.
• Максимальна відстань — радіус спрацювання у метрах (типово 500 м).
• Адреси — вибір зі списку адрес акаунта, максимум 10. Враховуються лише адреси з коректними координатами.

6. У вкладці Переклади вказується текст гео-сповіщення мовами акаунта, якщо активно декілька мов. Вкладки мов зверху — заповніть текст для кожної мови окремо і збережіть.

Зверніть увагу! Клієнт отримує текст тією мовою, якою користується застосунком/сайтом. Якщо переклад не заповнено — використовується основний текст.

7. Вкладка Реєстрації відображає список клієнтів, які додали картку: всього та активних. Тут видно, чи користуються карткою, і можна вручну надіслати оновлення.

Налаштування Google Wallet

1. В Панелі керування перейдіть у вкладку Маркетинг.
2. Оберіть вкладку Digital Wallet = Google Wallet.

3. У вкладці Загальні активуйте функцію Google Wallet та натисніть Зберегти.

4. Перейдіть у вкладку Конструктор та налаштуйте відповідні поля згідно вимог інформерів.

• Назва організації - повна назва організації, відображається поруч з логотипом.
• Назва програми - відображається як назва програми.
• Колір фону — один основний колір картки (окремих кольорів тексту немає — Google підбирає їх автоматично).
• Підпис балів - підпис над балансом кешбеку. За замовчуванням: CASHBACK
• Підпис додаткового поля - підпис над номером телефону. За замовчуванням: PHONE
• Тип штрих-коду — QR Code, PDF417, Aztec, Code 128 або «Немає».
• Дані штрих-коду — шаблон вмісту коду. Доступні плейсхолдери: {{userId}}, {{userToken}}, {{phone}}, {{userName}}.
• Логотип — кругле зображення 800×800.
• Hero-зображення — велика картинка внизу картки, 1032×336.

5. Після оформлення картки - перейдіть у вкладку Адреси. Тут обираються адреси закладу, поблизу яких клієнт отримає гео-сповіщення з карткою.

• Гео-сповіщення - коли тоглер увімкнено, клієнти отримують push-сповіщення, коли знаходяться поблизу одного з обраних закладів. Google Wallet: використовує merchantLocations API.
• Адреси — вибір зі списку адрес акаунта, максимум 10. Враховуються лише адреси з коректними координатами.

6. Вкладка Реєстрації відображає список клієнтів, які додали картку: всього та активних. Тут видно, чи користуються карткою, і можна вручну надіслати оновлення.

Індивідуальні картки для груп клієнтів (рівні лояльності)

Якщо в акаунті налаштовані групи кешбеку, для кожної групи можна зробити власний дизайн картки:

1. Перейдіть в Панелі керування в розділ **Маркетинг → Кешбек → Групи клієнтів → редагування обраної групи.

2. Відкрийте вкладку Digital Wallet = по черзі оберіть розділи Apple Card та Google Card та заповніть поля згідно інформерів.

Приклади використання

1. Приклад 1. Кав'ярня з рівнями: групи Bronze/Silver/Gold з різними відсотками кешбеку. Для кожної групи — свій колір картки та назва рівня. Клієнт бачить свій рівень прямо в гаманці, а після переходу в нову групу картка автоматично міняє вигляд.
2. Приклад 2. Гео-нагадування: заклад додає 5 своїх адрес у Локації з текстом «{{userName}}, ми поруч! Завітайте до нас». Коли клієнт проходить повз, телефон показує картку з цим текстом.

Поширені запитання (FAQ)

1. Питання: Клієнт не бачить кнопку Apple Wallet. Що перевірити?

• Пристрій та браузер: кнопка показується лише в Safari на Apple-пристроях.
• Чи не додано картку раніше — тоді кнопка зникає.
• Чи ввімкнена картка у вкладці Загальні та чи є опція Digital Wallet у плані акаунта.

2. Питання: На Android немає кнопки Apple Wallet — це помилка?

Ні. На Android показується лише Google Wallet, на Apple-пристроях у Safari — лише Apple Wallet.

3. Питання: Google-картка має позначку «Test only». Чому?

Акаунт видавця Google ще в демо-режимі — картки бачать лише тестові користувачі. Потрібно завершити бізнес-профіль і отримати publishing access у Google-консолі (звернутися до технічної команди).

4. Питання: Баланс на картці не оновився.

• Оновлення приходить протягом кількох хвилин після зміни балансу; телефон має бути в мережі.
• Перевірте у вкладці Реєстрації, що картка клієнта активна.
• Якщо клієнт видалив і знову додав картку — оновлення відновляться автоматично.

5. Питання: Клієнт видалив картку. Чи можна додати знову?

Так. Кнопка на сайті з'явиться знову, картка додається повторно без обмежень.

6. Питання: Чи працює картка без інтернету?

Так, показується останній збережений стан і код для сканування. Баланс оновиться, коли з'явиться мережа.

7. Питання: У якій валюті баланс на картці?

У валюті акаунта.

Посилання на цю сттатю: тут

Оновлено: 22/09/2026