Overzicht: beheerde vs. aangepaste Google Wallet Issuer-configuratie
In tegenstelling tot de vereiste van een eigen certificaat per handelaar bij Apple Wallet biedt Passinstance standaard een beheerde Google Wallet Issuer-infrastructuur, zodat u tijdens de onboarding direct Android-passen kunt publiceren en distribueren (PUT /api/v1/onboarding/wallet-setup). Voor enterprise-merken die eigenaar willen zijn van hun eigen Google Pay & Wallet Console Issuer ID of aangepaste contactloze Google Smart Tap-sleutels ondersteunt Passinstance ook het koppelen van een eigen Google Cloud Service Account (POST /api/v1/google-wallet/setup).
Vereisten: Wanneer u een aangepaste Google Wallet Issuer ID configureert, moet u het
client_emailvan het Google Cloud Service Account uitnodigen in de Google Pay & Wallet Business Console -> Users met Developer-machtigingen. Zonder deze IAM-koppeling retourneert Google'swalletobjectsAPI een403 Forbidden-fout wanneer Passinstance Classes of Objects probeert aan te maken.
Vergelijking tussen beheerde en aangepaste Google Issuer-modus
| Mogelijkheid | Beheerde Passinstance-issuer | Aangepaste Enterprise Issuer ID |
|---|---|---|
| Installatietijd | Direct (0 minuten) | ~15 minuten (Google Cloud + Business Console) |
| Merknaam en logo op pas | Volledig aanpasbaar per sjabloon (issuerName, programLogo) | Volledig aanpasbaar per sjabloon (issuerName, programLogo) |
| Toegang tot Google Pay & Wallet Console | Beheerd door Passinstance | Directe toegang tot uw eigen Google Business Console |
Google Smart Tap NFC (NFC_SMART_TAP) | Gebruikt werkruimte-/lezerconfiguratie | Ondersteunt uw eigen smartTapMerchantId & collectorId |
Callback-webhook (/api/v1/wallet/callback) | Automatisch vooraf geconfigureerd | Automatisch geconfigureerd bij aanmaken van Class |
Google Wallet-configuratie & sjabloonactivatie-API (Google Wallet Setup API)
Alle endpoints voor het inrichten van Google Wallet-issuers en sjablonen bevinden zich onder /api/v1/google-wallet:
| Methode | Endpoint-pad | Vereiste machtiging | Beschrijving |
|---|---|---|---|
| POST | /api/v1/google-wallet/setup | wallet:manage, certificates:manage | Richt een Google Wallet-issueraccount en optionele Smart Tap collector ID in op basis van de bedrijfsgegevens van uw werkruimte. |
| GET | /api/v1/google-wallet/status | wallet:read / wallet:manage | Retourneert { isConfigured, collectorId } wat aangeeft of Google Wallet en Smart Tap zijn ingericht. |
| POST | /api/v1/google-wallet/repair-callbacks | wallet:manage, certificates:manage | Synchroniseert ontbrekende /api/v1/wallet/callback-webhook-URL's opnieuw over gepubliceerde Google Wallet Classes. |
| POST | /api/v1/google-wallet/templates/:templateId/activate | wallet:manage, certificates:manage | Activeert Google Wallet Class-inrichting voor een specifiek sjabloon. |
| POST | /api/v1/google-wallet/templates/:templateId/deactivate | wallet:manage, certificates:manage | Schakelt Google Wallet-ondersteuning voor een specifiek sjabloon uit. |
| GET | /api/v1/google-wallet/templates/:templateId/status | wallet:manage, certificates:read | Retourneert { isEnabled, issuerId } voor het doelsjabloon. |
Voorbeeld: Google Wallet Issuer-configuratie initialiseren
POST /api/v1/google-wallet/setup
X-API-Key: <API_KEY>
Antwoord (201 Created):
{
"issuerId": "3388000000022194812",
"googlePayAccount": {
"accountIdentifier": "3388000000022194812",
"collectorId": "50992104"
},
"smartTapMerchantData": {
"smartTapMerchantId": "50992104"
}
}
Als u de status achteraf controleert via GET /api/v1/google-wallet/status, wordt { "isConfigured": true, "collectorId": "50992104" } geretourneerd en stellen individuele passen googleWalletTypeSource bloot (Google Wallet source type: INITIAL_CREATION | MIGRATION | MANUAL_REGENERATION).
Best practices tijdens sjabloonconfiguratie
-
1
Kies de juiste Google-pascategorie: koppel uw programma onder Edit Template -> Pass Types aan Loyalty (
LoyaltyClass), Offer (OfferClass), Gift Card (GiftCardClass), Event Ticket (EventTicketClass) of Generic Pass (GenericClass) — het resourcetype van Google Wallet-classes kan na publicatie niet meer worden gewijzigd. -
2
Test Android-voorbeelden expliciet: schakel in het live voorbeeldpaneel tussen Apple Wallet en Google Wallet, omdat de beeldverhoudingen (brede hero-banner
androidBackgroundvs. vierkante uitsnedegooglePayLogo) en regels voor het afkappen van velden per platform verschillen. -
3
Gebruik Android Overrides: stel aangepaste Android-veldlabels en -waarden in via de Inspector wanneer een Apple-lay-outslot niet 1:1 overeenkomt op Android.
Raadpleeg Google Wallet en Google Smart Tap voor Class/Object- en NFC-specificaties.
