Интеграция Google Wallet с картами лояльности Android: под ключ

Как добавить карту лояльности в Google Wallet из Android-приложения?

Пользователи хотят носить карты лояльности в телефоне. Google Wallet — естественное место на Android, установленное на 1,5 млрд устройств. Но интеграция сложнее, чем простая кнопка «Добавить в Wallet»: нужно зарегистрировать издателя, создать класс карты, генерировать JWT и реализовать клиентский API. Мы провели более 10 интеграций с Google Wallet и знаем все подводные камни. Предлагаем реализацию под ключ — от консоли до кода, с гарантией прохождения ревью Google за 1-3 дня.

Например, для сети кофеен CoffeeBoom мы реализовали интеграцию Google Wallet с бонусной программой, создав LoyaltyClass с персонализированным дизайном и автоматической синхронизацией баллов через CRM. Проект занял 3 дня на разработку и 2 дня на ревью от Google. Интеграция Google Wallet позволяет пользователям всегда иметь карту лояльности под рукой, увеличивает вовлечённость на 25–40% и снижает затраты на выпуск пластика на 60–80%. Однако для стабильной работы требуется грамотная настройка JWT, обработка ошибок и соблюдение правил Google.

Официальная документация: Google Wallet Loyalty API

Этапы интеграции Google Wallet

Интеграция проходит в несколько этапов:

1. Создание аккаунта издателя в Google Pay & Wallet Console.
2. Создание LoyaltyClass — шаблона карты с логотипом, цветами и полями.
3. Генерация LoyaltyObject для каждого пользователя на сервере.
4. Подготовка JWT для передачи на клиент.
5. Реализация PayClient.savePasses в Android-приложении.
6. Обработка результата добавления и обновления данных.

Что нужно подготовить перед интеграцией?

Перед написанием кода — три шага в консоли:

1. Создать аккаунт издателя (Issuer Account)
2. Создать LoyaltyClass — шаблон карты
3. Получить service account credentials для серверных вызовов

issuerId — числовой идентификатор издателя, например 3388000000022142. classId формируется как {issuerId}.{classPostfix}, например 3388000000022142.loyalty_main.

Вот минимальные поля для LoyaltyClass:

Как сгенерировать JWT для каждого пользователя?

Каждый пользователь — отдельный LoyaltyObject. Мы создаём его на сервере и упаковываем в JWT:

import jwt
import time

loyalty_object = {
    "id": f"3388000000022142.user_{user_id}",
    "classId": "3388000000022142.loyalty_main",
    "state": "ACTIVE",
    "loyaltyPoints": {
        "label": "Баллы",
        "balance": {
            "int": user_points
        }
    },
    "barcode": {
        "type": "QR_CODE",
        "value": f"USER-{user_id}",
        "alternateText": f"USER-{user_id}"
    },
    "textModulesData": [
        {
            "header": "Уровень",
            "body": user_tier,
            "id": "tier"
        }
    ]
}

# Создаём объект через API
service.loyaltyobject().insert(body=loyalty_object).execute()

# Генерируем JWT для передачи на клиент
payload = {
    "iss": service_account_email,
    "aud": "google",
    "typ": "savetowallet",
    "iat": int(time.time()),
    "payload": {
        "loyaltyObjects": [
            {
                "id": loyalty_object["id"]
            }
        ]
    }
}

token = jwt.encode(payload, private_key, algorithm="RS256")

JWT передаётся в мобильное приложение. Срок жизни JWT — максимум 1 час, поэтому генерируйте его непосредственно перед отправкой.

Как добавить карту в Android через PayClient?

import com.google.android.gms.pay.Pay
import com.google.android.gms.pay.PayApiAvailabilityStatus
import com.google.android.gms.pay.PayClient

private lateinit var walletClient: PayClient

override fun onCreate(savedInstanceState: Bundle?) {
    walletClient = Pay.getClient(this)
    checkWalletAvailability()
}

private fun checkWalletAvailability() {
    walletClient
        .getPayApiAvailabilityStatus(PayClient.RequestType.SAVE_PASSES)
        .addOnSuccessListener { status ->
            if (status == PayApiAvailabilityStatus.AVAILABLE) {
                showAddToWalletButton()
            }
        }
}

private fun saveToWallet(jwt: String) {
    walletClient.savePasses(jwt, this, ADD_TO_GOOGLE_WALLET_REQUEST_CODE)
}

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    if (requestCode == ADD_TO_GOOGLE_WALLET_REQUEST_CODE) {
        when (resultCode) {
            RESULT_OK -> handleSuccess()
            RESULT_CANCELED -> handleCanceled()
            PayClient.SavePassesResult.SAVE_ERROR -> data?.let { handleError(it.getStringExtra(PayClient.EXTRA_API_ERROR_MESSAGE)) }
        }
    }
}

PayClient.RequestType.SAVE_PASSES проверяет, что Google Wallet установлен и работает. На устройствах без GMS (Huawei) Google Wallet недоступен — предусмотрите fallback.

Как обновить данные карты после выдачи?

Изменить баланс баллов — PATCH-запрос на существующий объект:

patch_body = {
    "loyaltyPoints": {
        "balance": {
            "int": new_points_value
        }
    }
}
service.loyaltyobject().patch(
    resourceId=f"3388000000022142.user_{user_id}",
    body=patch_body
).execute()

Google Wallet синхронизирует изменения на устройстве в течение 2-5 минут. Push-уведомлений отправлять не нужно — система сама обновляет карту.

Google Wallet или PassKit: что выбрать?

Google Wallet не требует файлового архива — всё через REST API. Это ускоряет разработку в 2 раза и упрощает поддержку. Однако на iOS PassKit быстрее работает офлайн.

Что входит в нашу работу?

• Серверная часть: создание LoyaltyClass, генерация LoyaltyObject и JWT, API для обновления данных
• Клиентская часть: интеграция PayClient в Android-приложение, обработка результата добавления
• Тестирование: проверка на устройствах с разными версиями Android, включая эмуляцию Google Wallet
• Документация: описание всех эндпоинтов и инструкция для разработчика
• Поддержка после запуска: помощь в прохождении ревью Google, мониторинг ошибок

Какие ошибки чаще всего допускают при интеграции?

• Неверный формат classId: должен быть {issuerId}.{postfix}, иначе Google отклоняет запрос.
• JWT с истёкшим сроком: время жизни не должно превышать 1 час, иначе клиент получит ошибку.
• Отсутствие service account: без корректных credentials API не авторизует запросы.
• Игнорирование reviewStatus: пока класс в статусе UNDER_REVIEW, карты нельзя добавлять на реальные устройства.

Убедитесь, что все поля заполнены, а серверный скрипт работает с правильным issuerId.

Сроки

2–3 дня: создание LoyaltyClass, серверная генерация объектов и JWT, интеграция PayClient в Android-приложение. Плюс 1–3 дня на ревью класса от Google. Стоимость рассчитывается индивидуально. Закажите интеграцию под ключ — мы оценим ваш проект и назовём сроки.

Наш опыт — 5+ лет в мобильной разработке, более 10 интеграций с Google Wallet, сотни успешно добавленных карт. Гарантируем правильную настройку с первого раза и прохождение ревью. Свяжитесь с нами, и мы подберём оптимальное решение для вашего бизнеса.