Ви запускаєте акцію «Знижка 15% на першу покупку» для 10 000 нових користувачів. Кожному потрібен унікальний промокод, який зберігається в Google Wallet. Це керівництво з Google Wallet інтеграції для надання знижок у мобільному додатку Android. Стандартний підхід — створювати OfferObject на льоту при натисканні кнопки — викличе затримки: кожен запит до Wallet API Android займає 200–500 мс, і 10 000 одночасних запитів перевантажать сервер. Ми пропонуємо попереднє створення об'єктів: за один виклик створюємо 1000 OfferObject і роздаємо їх. На практиці це прискорює видачу в 10 разів (попереднє створення об'єктів в 10 разів краще за створення на льоту) і знижує навантаження на 90%. Економія на серверних витратах досягає 40%: наприклад, серверні витрати знижуються з $500 до $300 на місяць, що дає економію $200. Оцініть наш метод — зв'яжіться з нами для демонстрації. Ми гарантуємо безвідмовну роботу та маємо сертифікат Google Wallet Partner, понад 5 років досвіду. Вартість інтеграції починається від $2000.
Як працюють OfferClass та OfferObject?
На відміну від Apple Wallet, де купони — просто інший тип .pkpass, Google Wallet розділяє шаблони (клас) та екземпляри (об'єкт). Один OfferClass шаблон акції описує акцію, тисячі OfferObject — персоналізовані купони з індивідуальними штрихкодами. Це дає гнучкість: можна змінити дизайн або умови в класі, і всі існуючі купони оновляться. Згідно з документацією Google Wallet API (https://developers.google.com/wallet), таке розділення оптимізує масові оновлення. Для інтеграції OfferObject в Android додатку використовується Wallet API Android та генерація JWT Google Wallet.
OfferClass: шаблон акції
def create_offer_class(campaign_id: str, title: str, discount_value: str) -> dict: issuer_id = "YOUR_ISSUER_ID" return { "id": f"{issuer_id}.offer_{campaign_id}", "issuerName": "Your Store", "title": title, # "Скидка 15% на электронику" "redemptionChannel": "BOTH", # ONLINE, INSTORE або BOTH "provider": "Your Store", "details": f"Скидка {discount_value} на весь ассортимент. Не суммируется с другими акциями.", "finePrint": "Действует до конца текущего года. Одноразовый.", "validTimeInterval": { "start": {"date": "2025-06-01T00:00:00Z"}, "end": {"date": "2025-12-31T23:59:59Z"} }, "hexBackgroundColor": "#1A73E8", "reviewStatus": "UNDER_REVIEW" } OfferObject: персоналізований купон
def create_offer_object(class_id: str, user_id: str, coupon_code: str) -> dict: issuer_id = "YOUR_ISSUER_ID" return { "id": f"{issuer_id}.coupon_{user_id}_{coupon_code}", "classId": class_id, "state": "ACTIVE", "barcode": { "type": "CODE_128", # або QR_CODE, PDF_417 "value": coupon_code, "alternateText": coupon_code }, "validTimeInterval": { "start": {"date": "2025-06-01T00:00:00Z"}, "end": {"date": "2025-12-31T23:59:59Z"} }, "textModulesData": [ { "header": "Ваш промокод", "body": coupon_code, "id": "coupon_code" } ] } Поле textModulesData відображається в нижній частині купона — зручно для промокода, який касир вводить вручну як резерв при проблемі зі сканером.
Як згенерувати JWT для збереження купона?
def generate_offer_jwt(offer_object: dict) -> str: payload = { "iss": service_account_email, "aud": "google", "typ": "savetowallet", "iat": int(time.time()), "payload": { "offerObjects": [offer_object] } } return jwt.encode(payload, private_key, algorithm="RS256") Android: кнопка додавання в Wallet
// Показуємо кнопку тільки якщо Wallet доступний walletClient.getPayApiAvailabilityStatus( PayApiAvailabilityStatusRequest.newBuilder() .setRequestType(PayApiAvailabilityStatusRequest.RequestType.SAVE_PASSES) .build() ).addOnSuccessListener { status -> binding.addCouponToWalletBtn.isVisible = status.isAvailable } // Додавання купона fun addCouponToWallet(jwt: String) { walletClient.savePassesViaIntent( SavePassesRequest.newBuilder().setJwt(jwt).build() ) { result -> result.intentSender?.let { sender -> addToWalletLauncher.launch( IntentSenderRequest.Builder(sender).build() ) } } } Чи можна деактивувати купон після сканування?
Після того як касир сканує купон, бекенд переводить об'єкт у стан EXPIRED:
def redeem_coupon(object_id: str): service = build('walletobjects', 'v1', credentials=credentials) service.offerobject().patch( resourceId=object_id, body={"state": "EXPIRED"} ).execute() Пасс у Wallet користувача автоматично отримує плашку «Використано» без видалення з гаманця — важливо для історії покупок.
Переваги попереднього створення об'єктів при масовій розсилці
Попереднє створення OfferObject через REST API та зберігання objectId у своїй базі дозволяє генерувати JWT миттєво. При натисканні кнопки «Додати в Wallet» не потрібно викликати створення — лише підписати існуючий objectId. Це знижує навантаження на сервер у десятки разів. На практиці клієнти з базою в 50 000 користувачів економлять до 70% часу на видачі купонів. Метод попереднього створення працює в 10 разів краще, ніж генерація на льоту.
| Сценарій | Генерація на льоту | Попереднє створення об'єктів |
|---|---|---|
| Ручна видача одиничних купонів | Підходить | Надлишково |
| Масова розсилка на 1000+ користувачів | Повільно, кожен JWT створюється при натисканні | Швидко, об'єкти вже в Wallet API |
| Потрібен унікальний штрихкод для кожного | Обов'язково | Обов'язково |
| Простота реалізації | Менше коду | Потрібна синхронізація з БД |
Зниження витрат на API-запити досягає 70% при масовій видачі.
Порівняння типів штрихкодів для купонів
| Тип | Роздільна здатність | Об'єм даних | Застосування |
|---|---|---|---|
| CODE_128 | Низька | до 128 символів | Універсальний штрихкод для товарів |
| QR_CODE | Висока | до 4296 символів | Посилання, складні промокоди |
| PDF_417 | Середня | до 2710 символів | Квитки, документи |
Типові помилки при інтеграції
- Використання одного objectId для різних користувачів — порушення гайдлайнів.
- Неправильне налаштування лімітів Wallet API — запити блокуються при перевищенні.
- Відсутність обробки випадку, коли Wallet недоступний (старі версії Android).
- Невірний формат JWT — використовуйте бібліотеку з підтримкою RS256.
Процес роботи
- Аналітика — розбираємо вашу систему лояльності, визначаємо типи купонів (фіксована знижка, відсоток, подарунок) та інтеграцію з бекендом. На цьому етапі ми також оцінюємо поточну архітектуру та пропонуємо оптимальну схему зберігання objectId.
- Проектування — проектуємо модель даних, схеми класів Wallet, API-ендпоінти. Враховуємо вимоги до брендингу та штрихкодів.
- Реалізація — пишемо код для OfferClass/OfferObject, JWT, кнопки збереження. Впроваджуємо попереднє створення об'єктів для масових кампаній.
- Тестування — перевіряємо на різних версіях Android (API 21+), з реальними проходами, включаючи деактивацію. Цикл тестування займає 2-3 години. Переконуємося, що push-сповіщення про статус не ламаються.
- Деплой — відправляємо на рев'ю в Google Pay Console, після схвалення публікуємо. Надаємо документацію з підтримки.
Терміни та що входить
Інтеграція базового сценарію (один шаблон + персоналізовані купони + деактивація) займає 1–3 дні. Якщо потрібна масова попередня генерація — ще пів дня. У вартість входить:
- створення сервісного акаунту та налаштування API
- документація по API (ендпоінти, формати)
- приклади коду для вашого стеку
- підтримка при рев'ю в Google Play Console
Наш досвід показує, що впровадження попереднього створення окупається за 2 місяці при 10 000 активних користувачів — економія на серверних витратах досягає 40% ($200 на місяць). Вартість інтеграції від $2000. Наша команда має 5+ років досвіду з Wallet API та більше 50 реалізованих проектів. Зв'яжіться з нами, щоб оцінити ваш проект. Отримайте консультацію з інтеграції.