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

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

Купон у Google Wallet — це OfferObject на основі OfferClass. На відміну від Apple Wallet, де купони — просто інший тип .pkpass, Google Wallet розділяє шаблони (клас) та екземпляри (об'єкт). Один OfferClass описує промоцію, тисячі OfferObject — персоналізовані купони для конкретних користувачів з індивідуальними штрих-кодами.

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",
        "titleImage": {
            "sourceUri": {"uri": "https://yourapp.com/offer-banner.jpg"},
            "contentDescription": {
                "defaultValue": {"language": "uk", "value": title}
            }
        },
        "details": f"Скидка {discount_value} на весь ассортимент. Не суммується с іншими акціями.",
        "finePrint": "Дійсна до 31.12.2024. Одноразова.",
        "validTimeInterval": {
            "start": {"date": "2024-06-01T00:00:00Z"},
            "end": {"date": "2024-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": "2024-06-01T00:00:00Z"},
            "end": {"date": "2024-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 доступен
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 користувача автоматично отримає бейдж "Використаний" без видалення — важливо для історії покупок.

Масова розповсюджування купонів

Для розповсюджування купонів багатьом користувачам не потрібно генерувати JWT для кожного окремо при натисканні кнопки. Можна попередньо створити OfferObject через API та зберегти objectId у базі даних. Кнопка "Додати до Wallet" генерує JWT з уже створеним objectId — Google повертає intentSender для існуючого об'єкта.

Тривалість

1–3 дні. Шаблон акції + персоналізовані купони + деактивація — 2 дні. Масова попередня генерація об'єктів — додатково 0,5 дня. Вартість розраховується індивідуально.