Інтеграція Google Wallet для квитків на заходи у мобільному додатку

Інтеграція Google Wallet для квитків на заходи в мобільних додатках

Google Wallet дозволяє додати квитки на концерт, спортивні заходи або фестиваль прямо в Android Wallet — без необхідності відкривати додаток при вході. Користувачі демонструють QR або штрих-код прямо з екрана блокування. Інтеграція вимагає серверної роботи: API Google Wallet працює з JWT, підписаними service account.

Як це працює: EventTicketObject

Google Wallet використовує EventTicketClass (шаблон) та EventTicketObject (конкретний квиток). Клас створюється один раз для заходу, об'єкти — для кожного квитка.

Процес:

1. Створіть EventTicketClass через API Google Wallet (REST) — опис заходу, логотип, кольорова схема
2. Для кожного квитка створіть EventTicketObject зі штрих-кодом та даними місця
3. Генеруйте JWT з об'єктом, передайте в додаток
4. Додаток викликає кнопку "Додати до Google Wallet"

Серверна частина: JWT та API Google Wallet

Потрібен service account у Google Cloud Console з ролю Wallet Object Issuer.

import jwt
from google.oauth2 import service_account
import json

def create_event_ticket_jwt(event_id: str, ticket_id: str, holder_name: str, seat: str) -> str:
    credentials = service_account.Credentials.from_service_account_file(
        'service-account.json',
        scopes=['https://www.googleapis.com/auth/wallet_object.issuer']
    )

    issuer_id = "YOUR_ISSUER_ID"  # з Google Pay & Wallet Console
    class_suffix = f"event_{event_id}"
    object_suffix = f"ticket_{ticket_id}"

    ticket_object = {
        "id": f"{issuer_id}.{object_suffix}",
        "classId": f"{issuer_id}.{class_suffix}",
        "state": "ACTIVE",
        "barcode": {
            "type": "QR_CODE",
            "value": ticket_id,
            "alternateText": ticket_id[:8]
        },
        "ticketHolderName": holder_name,
        "seatInfo": {
            "seat": {"defaultValue": {"language": "uk", "value": seat}},
            "row": {"defaultValue": {"language": "uk", "value": "A"}},
        },
        "reservationInfo": {
            "confirmationCode": ticket_id[:8].upper()
        },
        "heroImage": {
            "sourceUri": {"uri": "https://yourapp.com/event-banner.jpg"}
        }
    }

    payload = {
        "iss": credentials.service_account_email,
        "aud": "google",
        "typ": "savetowallet",
        "iat": int(time.time()),
        "origins": ["https://yourapp.com"],
        "payload": {
            "eventTicketObjects": [ticket_object]
        }
    }

    token = jwt.encode(payload, credentials._private_key_pkcs8_pem, algorithm="RS256")
    return token

JWT передається в мобільний додаток як рядок. Тривалість — 1 година з моменту генерації.

Android: кнопка "Додати до Google Wallet"

// build.gradle
implementation("com.google.android.gms:play-services-wallet:19.3.0")

class TicketActivity : AppCompatActivity() {
    private val walletClient by lazy {
        Wallet.getWalletClient(
            this,
            WalletOptions.Builder()
                .setEnvironment(WalletConstants.ENVIRONMENT_PRODUCTION)
                .build()
        )
    }

    private val addToWalletLauncher = registerForActivityResult(
        ActivityResultContracts.StartIntentSenderForResult()
    ) { result ->
        when (result.resultCode) {
            RESULT_OK -> showSuccess()
            RESULT_CANCELED -> { /* користувач скасував */ }
            else -> showError()
        }
    }

    fun addTicketToWallet(jwt: String) {
        val request = SavePassesRequest.newBuilder()
            .setJwt(jwt)
            .build()

        walletClient.savePassesViaIntent(request) { apiResult ->
            apiResult.intentSender?.let { intentSender ->
                addToWalletLauncher.launch(
                    IntentSenderRequest.Builder(intentSender).build()
                )
            }
        }
    }
}

Кнопка за рекомендаціями Google

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

<com.google.android.gms.wallet.button.PayButton
    android:id="@+id/addToWalletButton"
    android:layout_width="match_parent"
    android:layout_height="48dp"
    app:allowedAuthMethods="PAN_ONLY|CRYPTOGRAM_3DS"
    app:buttonType="addToGoogleWallet" />

Перевірка доступності Wallet

Перед показом кнопки перевірте, доступний ли Google Wallet на пристрої:

walletClient.getPayApiAvailabilityStatus(
    PayApiAvailabilityStatusRequest.newBuilder()
        .setRequestType(PayApiAvailabilityStatusRequest.RequestType.SAVE_PASSES)
        .build()
).addOnSuccessListener { status ->
    if (status.isAvailable) {
        addToWalletButton.isVisible = true
    }
}

Wallet недоступен на пристроях без Google Play Services та у деяких регіонах.

Оновлення квитка після видачі

Якщо потрібно оновити QR-код або статус квитка (наприклад, "використано") — викличте PATCH-запит до API Google Wallet з objectId. Зміни застосовуються до вже доданих пасів в реальному часі.

from googleapiclient.discovery import build

service = build('walletobjects', 'v1', credentials=credentials)
service.eventticketobject().patch(
    resourceId=f"{issuer_id}.{object_suffix}",
    body={"state": "COMPLETED"}  # квиток використано
).execute()

Тривалість

2–3 дні. Створення класу заходу, генерація JWT, інтеграція кнопки — 1,5 дня. Оновлення статусу через API + тестування — 0,5–1 день. Вартість розраховується індивідуально.